+ All Categories
Home > Documents > ExtendSim on Client Devices · 2020. 8. 25. · Changing the default port (5053) used for...

ExtendSim on Client Devices · 2020. 8. 25. · Changing the default port (5053) used for...

Date post: 09-Sep-2020
Category:
Upload: others
View: 8 times
Download: 0 times
Share this document with a friend
11
Can a Client device be a virtual machine? Yes. Be sure the virtual machine has the correct permissions so that ExtendSim can be installed without security issues and that the location where user-modifiable files will be installed has read-write access so the license file can be read and end-users can open, run, and save models. Can ExtendSim be installed on the same server as the License Manager? Yes. The Server can also be used as a Client. Do I need to uninstall ExtendSim 9 from Client devices when I install 10? No. Both releases can be installed on the same Client device. In fact, we suggest you don’t uninstall ExtendSim 9 until you’ve finished converting your files to 10. How does the Client installation of ExtendSim know where the Server’s License Manager is? Installing the extendsim.lic file on the Client device broadcasts to automatically find the Server. If it can’t find the Server, it asks you to enter Server info (IP address, computer name, or URL). It saves that location info in a host.lic file on the customer’s device so it doesn’t ask again. Note: the URL must be resolvable to an external IP address. Can a Client device tell which Server has the License Manager? Yes. Go to Documents/ExtendSim and open the Host.lic file. It contains the name of the Server. Checking Out and Checking In Client Licenses (Roaming). To temporarily disconnect a Client device from the network, use the Help > Floating License > Check Out a Floating License command. To check a roaming license back in, use the Help > Floating License > Check In a Floating License command. Roaming licenses can be checked back in at any time. They are automatically checked in at the end of the roaming period (the default period is 30 days). Updating Client Licenses when there is an incremental release of ExtendSim (e.g. from 10.x to 10.y). 1. If you are using ExtendSim 10.0.4 or later, use the ExtendSim Updater at https://www.extendsim.com/support/updates. 2. If you are using ExtendSim released prior to 10.0.4: For ExtendSim CP, DE, or Pro - the Trial version of ExtendSim is your updater. Download the Trial version of the package you purchased from https://www.extendsim.com/trialsoftware and install over your current installation of ExtendSim 10 using the same name and installing to the same location as the current installation. This updates ExtendSim without affecting the license file. For ExtendSim Analysis RunTime - contact Imagine That Inc. to obtain the newer release. Note: When using the Trial version to update, if you subsequently launch ExtendSim and get a message that the license has not been activated, it means that you have not installed over the current installation but in fact have two installations of ExtendSim. Uninstall the update and reinstall it so that it replaces the files at the current location. ExtendSim on Client Devices ExtendSim on Client Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . License Manager on Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Managing a Floating License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Issues When Installing, Launching, or Opening ExtendSim Files . . . . . . . . . . . . . Security Issues When Installing or Launching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Permission and Location Issues for User-Modifiable and Other Files . . . . . . . . . . Activation Dialog Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Other Issues When Installing or Launching ExtendSim . . . . . . . . . . . . . . . . . . . . . . Specific Situations to be Aware of . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . RLM Already Installed on Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . License Manager • Additional Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2 4 6 6 6 7 7 8 9 11 Table of Contents Frequently Asked Questions Floating Licenses Imagine That Inc. • 1165 Minnesota Avenue, Suite 200 • San Jose, CA 95125 USA 408.365.0305 • [email protected] www.ExtendSim.com
Transcript
Page 1: ExtendSim on Client Devices · 2020. 8. 25. · Changing the default port (5053) used for communication between the License Manager and ExtendSim. You can edit the license to use

Can a Client device be a virtual machine? Yes. Be sure the virtual machine has the correct permissions so that ExtendSim can be installed without security issues and that the location where user-modi�able �les will be installed has read-write access so the license �le can be read and end-users can open, run, and save models.

Can ExtendSim be installed on the same server as the License Manager? Yes. The Server can also be used as a Client.

Do I need to uninstall ExtendSim 9 from Client devices when I install 10? No. Both releases can be installed on the same Client device. In fact, we suggest you don’t uninstall ExtendSim 9 until you’ve �nished converting your �les to 10.

How does the Client installation of ExtendSim know where the Server’s License Manager is? Installing the extendsim.lic �le on the Client device broadcasts to automatically �nd the Server. If it can’t �nd the Server, it asks you to enter Server info (IP address, computer name, or URL). It saves that location info in a host.lic �le on the customer’s device so it doesn’t ask again. Note: the URL must be resolvable to an external IP address.

Can a Client device tell which Server has the License Manager? Yes. Go to Documents/ExtendSim and open the Host.lic �le. It contains the name of the Server.

Checking Out and Checking In Client Licenses (Roaming). • To temporarily disconnect a Client device from the network, use the Help > Floating License > Check Out a Floating License command. • To check a roaming license back in, use the Help > Floating License > Check In a Floating License command. • Roaming licenses can be checked back in at any time. They are automatically checked in at the end of the roaming period (the default period is 30 days).

Updating Client Licenses when there is an incremental release of ExtendSim (e.g. from 10.x to 10.y). 1. If you are using ExtendSim 10.0.4 or later, use the ExtendSim Updater at https://www.extendsim.com/support/updates. 2. If you are using ExtendSim released prior to 10.0.4: • For ExtendSim CP, DE, or Pro - the Trial version of ExtendSim is your updater. Download the Trial version of the package you purchased from https://www.extendsim.com/trialsoftware and install over your current installation of ExtendSim 10 using the same name and installing to the same location as the current installation. This updates ExtendSim without a�ecting the license �le. • For ExtendSim Analysis RunTime - contact Imagine That Inc. to obtain the newer release. • Note: When using the Trial version to update, if you subsequently launch ExtendSim and get a message that the license has not been activated, it means that you have not installed over the current installation but in fact have two installations of ExtendSim. Uninstall the update and reinstall it so that it replaces the �les at the current location.

ExtendSim on Client Devices

ExtendSim on Client Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .License Manager on Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Managing a Floating License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Issues When Installing, Launching, or Opening ExtendSim Files . . . . . . . . . . . . . Security Issues When Installing or Launching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Permission and Location Issues for User-Modi�able and Other Files . . . . . . . . . . Activation Dialog Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Other Issues When Installing or Launching ExtendSim . . . . . . . . . . . . . . . . . . . . . . Speci�c Situations to be Aware of . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . RLM Already Installed on Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . License Manager • Additional Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1246667789

11

Table of Contents

Frequently Asked QuestionsFloating Licenses

Imagine That Inc. • 1165 Minnesota Avenue, Suite 200 • San Jose, CA 95125 USA408.365.0305 • [email protected]

www.ExtendSim.com

Page 2: ExtendSim on Client Devices · 2020. 8. 25. · Changing the default port (5053) used for communication between the License Manager and ExtendSim. You can edit the license to use

Can the Server where the License Manager is installed be a virtual machine? Yes.

Can the License Manager be installed on the same device as ExtendSim? Yes. One device can be both Server and Client.

Verifying the ExtendSimLicServer is running as a Service. • Go to Computer Management on the License Server. • In the list that appears, double-click Services and Applications, then double-click Services. • In the list that appears, scroll to ExtendSimLicServer and verify it is Running. • If it is not running, you may need to install the License Manager with Administrative privileges, temporarily disable virus protection and other security features before installing it, or unblock the ISV port.

Starting the Service manually if the License Manager fails to automatically start the Service. The License Manager installer not only creates the Service but sets it to start automatically. To do this manually: 1. Open an administrative CMD line window: • Open Command Prompt as Administrator (Enter CMD in the Search box and simultaneously click Ctrl+Shift+Enter. For the Windows Command Processor click “Allow”). • At the command line, enter “CD C:\ExtendSimFloatingLicenseServer” (assuming that is the directory where the License Manager was installed) and press the Enter key. • At the new command line, enter “rlm -install_service -dlog log�le -service_name extendsimlicserver”. Press Enter. • Close the window. 2. Go to Computer Management on the License Server. • Go to the Services and Applications/Services section. • Select ExtendSimLicServer in the list of Services and Start the Service. • Right-click ExtendSimLicServer to access its Properties and set the startup type to Automatic.

License Manager on Server

Renewing the Maintenance & Support Plan (MSP) on a Client. (Does not apply to Analysis RunTime Floating Licenses.) 1. The renewal date for the Floating License’s Maintenance and Support Plan (MSP) is shown on the ExtendSim startup screen (Help > About ExtendSim). Prior to the renewal date, the application will occasionally present a reminder message upon launch. 2. Contact Imagine That Inc. or your ExtendSim Distributor to renew your MSP. Client devices will automatically be updated once the License Manager on the Server has been updated, as discussed below.

What happens after we renew the annual Maintenance & Support Plan or change the number of concurrent users? • The license �le (extendsim.lic) on the License Server needs to be updated and reactivated whenever there is this type of change to the license. • After we notify you that the license has been updated, we will send you instructions so you can reactivate the License Manager. • Do not send new license �les to Client devices. The License Manager automatically updates the license �les on Client devices. • See the document titled Reactivating ExtendSim Floating Licenses.

Uninstalling ExtendSim from a Client device. 1. First, return the license if it has been temporarily checked out from the network. Connect the client computer to the server that hosts the License Manager. Use the command Help > Floating License > Check In a Floating License. This restores the number of concurrent users the server allows. 2. Use the Windows Settings > Apps and Features to uninstall ExtendSim 10. 3. Then delete the two folders: Documents/ExtendSim and Program Files/ExtendSim.

ExtendSim on Client Devices - continued

Frequently Asked Questions • Floating LicensesClient Devices • License Manager on Server

- 2 -

Page 3: ExtendSim on Client Devices · 2020. 8. 25. · Changing the default port (5053) used for communication between the License Manager and ExtendSim. You can edit the license to use

Changing the default port (5053) used for communication between the License Manager and ExtendSim. You can edit the license to use a di�erent port than the default port (5053). However, how you do that depends on your situation: • If you received the extendsim.lic �le while doing a manual activation but haven't resumed the activation process, directly change the port number in the �le and save that change before proceeding. Then complete the activation procedure. Be sure to give the updated extendsim.lic to each Client. • If you have already �nished the process of activating the License Manager, you must edit your existing extendsim.lic �le using the RLSA window. 1. Using a browser, open the RLSA window as indicated at Step 2 • Activate License Manager on page 2 of the separate document Installing & Activating ExtendSim Floating Licenses. 2. On the left side of the RLSA window, click the Edit License Files command. (Note: The“License File to Edit” should be extendsim.lic.) 3. In the window that appears, click the Edit License File button. 4. In the license �le �eld, change “5053” (the default port number) to a di�erent number. Note that the new port must be unblocked inbound and outbound for both the License Server and the Client devices. 5. Click the Update License File button. The window should report “license �le extendsim.lic written”. 6. On the left-hand side of the RLSA window, click the Reread/Restart Servers command. 7. For the ISV, select extendsim, then click the Reread/Restart button to restart the License Manager. 8. If successful, the window will display the message “Reread command sent to extendsim”. This indicates that the new port will be added as an alternate port. 9. Be sure to copy the updated extendsim.lic �le to each Client.

What does the "Connection refused at server (-111)" message mean? This message indicates that one or more of two required ports are blocked. To support internal, end-to-end communications between the Server and Client devices, port 5053 and the ISV port need to be open for outbound access on Client devices and inbound access on the Server. Port 5053 is a TCP port. The ISV port is randomly selected by the License Manager and is shown in the table when you click the Status command in the RLSA window; it can change each time the Server is restarted. Either unblock those two ports, or change one or both of the ports to an unblocked permanent port as described elsewhere in this document. (Note: if the ISV port is blocked, we strongly setting an unblocked port to be the permanent ISV port. The ISV port you set will always be used even if the Server restarts.)

Changing the port for the ISV Server. When the License Manager was activated, a random high-number port was assigned as the ISV Server port, as shown in the Status command above. Each time the Server restarts, the ISV port will change to a di�erent randomly selected port number. If the ISV port is blocked you can either unblock it or specify an unblocked port as the permanent ISV port. If the port is blocked, we strongly suggest you set an unblocked port to be the permanent ISV port. That port will always be used even if the Server restarts. To set a permanent port, use the RLSA window to edit your already-activated extendsim.lic license �le: 1. Using a browser, open the RLSA window as indicated at Step 2 • Activate License Manager on page 2 of the separate document Installing & Activating ExtendSim Floating Licenses. 2. On the left side of the RLSA window, click the Edit License Files command. (Note: The “License File to Edit” should be extendsim.lic.) 3. In the window that appears, click the Edit License File button. 4. In the license �le �eld, add to the "ISV extendsim" line the phrase "port=nnnnn", where "nnnnn" is the unblocked port number you’ve chosen. It should now read "ISV extendsim port=nnnnn" as shown here. 5. In the RLSA window, click the Update License File button. The window should report “license �le extendsim.lic written”. 6. On the left-hand side of the RLSA window, click the Reread/Restart Servers command (this restarts the License Manager, not your Server).

ISV Servers

Name port Running Restarts Server Status License Usage

extendsim 12345 Yes 0 extendsim extendsim

License Manager on Server - continued

HOST ITIserver f06da4f564f7 5053

ISV extendsim port=12345

LICENSE extendsim exprv10� 10.0 permanent 1

Frequently Asked Questions • Floating LicensesLicense Manager on Server

- 3 -

Page 4: ExtendSim on Client Devices · 2020. 8. 25. · Changing the default port (5053) used for communication between the License Manager and ExtendSim. You can edit the license to use

How do I access reports on how the employees are using the Floating License? Log into the License Manager (ExtendSimLicServer) on the Server: • Open a browser on the Server and enter localhost:5054 in the browser’s address line. • Or, open a browser on some other device that is on the same network as the Server and enter servername:5054 in the browser’s address line.

Can we have a Network License of ExtendSim 9 as well as its upgrade, a Floating License of 10, running concurrently? Absolutely. In fact, you will need both during the transition period while you convert your �les from 9 to 10. The transition period should not exceed six (6) months. Deployment of the software after that period shall not exceed the licensed quantity of ExtendSim 10.

What happens after we renew the annual Maintenance & Support Plan (MSP) or change the number of concurrent users? The license �le (extendsim.lic) on the License Server needs to be updated and reactivated whenever there is this type of change to the license. After we notify you that the change has been made and the license has been updated, you will need to reactivate the License Manager. However, you do not need to send new license �les to Client devices. The License Manager automatically updates the license �les on Client devices. See the document titled Reactivating • Floating Licenses.

Managing a Floating License

Changing the port for the ISV Server. -- continued 7. For the ISV, select extendsim, then click the Reread/Restart button to restart the License Manager. 8. If successful, the window will display the message “Reread command sent to extendsim”. This indicates that the new port will be added as an alternate port. 9. Be sure to copy the updated extendsim.lic �le to each Client.

Can I move the License Manager from one Server to another? Not directly. Before you try to move the License Manager, contact us at [email protected] or 1.408.365.0305. We will revoke the current license so you can install and activate on the new Server. Then you must uninstall the License Manager from the original server using the instructions below.

How do we uninstall the License Manager for an ExtendSim 9 Network License? For release 9, run the “Remove ExtendSim Server.exe” �le in the Server’s ExtendSimServer folder. You should get two messages: License Successfully Removed and Service Successfully Removed. Then use Windows Settings to uninstall the ExtendSim Server �les.

Uninstalling the License Manager for an ExtendSim 10 Floating License. 1. Stop the Service (instructions for Windows 10; others differ) • Right-click on the Server’s Start command and choose Computer Management. • In the list that appears, double-click Services and Applications. • Double-click Services. • In the list that appears, scroll to ExtendSimServer. • Stop the ExtendSimLicServer service (right-click select Stop). • Close the Computer Management window. 2. Remove the Service • Open Command Prompt as Administrator (Enter CMD in the Search box and simultaneously click Ctrl+Shift+Enter. • Click Yes in the User Account Control window to enable Windows Command Processor. • At the command line enter SC delete ExtendSimLicServer and press the Enter key. • If successful, the Service will be removed and you can close the window. 3. Uninstall ExtendSim Floating License Server v10 using Windows Settings > Apps > Apps and features, then delete the folder ExtendSimFloatingLicenseServer (located by default at the root of the C drive).Note: Before reinstalling using a newer ExtendSim Server License Manager, you must first uninstall the previous License Manager as described above.

License Manager on Server - continued

Frequently Asked Questions • Floating LicensesLicense Manager on Server • Managing a Floating License

- 4 -

Page 5: ExtendSim on Client Devices · 2020. 8. 25. · Changing the default port (5053) used for communication between the License Manager and ExtendSim. You can edit the license to use

Is the Floating License an internally-hosted solution? Yes, the Floating License is hosted and managed on your premises. • If you do a manual activation, no connection to the internet is requested for either the Server or ExtendSim on Client devices. • Even if you do an automatic activation, it is only a one-time web-based exchange of encrypted Server and license information to activate the Server’s license. • Subsequent to installation and activation, the Client only connects to the License Manager on your Server, and the Server internally validates the License File and receives license requests from Client devices.

Debugging issues with your Server/Client set up. Generate a debug log from the License Manager on the Server by following these instructions: • Open the Reprise License Server Administration (RLSA) window in a browser. (To learn how to do that, see “Step 2: Activation of the License Manager” on page 2 of Installing and Activating • Floating Licenses.) • On the left side of the RLSA window, click the Diagnostics command. • In the main window, click the Run Diagnostics button. Wait for the window to report that the diagnostics were written. • Locate and open the text �le named RLMDIAG.txt; it will be placed where the License Manager is installed (by default, C:/ExtendSimFloatingLicenseServer). • This report contains information about License Manager activities over time. See if there's any discrepancies or anomalies that might indicate the cause of your issues. If you can't readily �nd the issue, contact Imagine That Inc.

All of a sudden Clients can no longer communicate with the License Manager. If you have a Floating license and ExtendSim has been working �ne on Client devices, then all of the sudden Clients are no longer able to communicate with the License Manager on the Server, it might be because your Server was restarted some hours or days previously and the ISV port has changed.

The ISV port is used for communication between the License Manager and ExtendSim. Every time the Server gets restarted, the License Manager for the Floating license automatically restarts. And each time the License Manager restarts, it uses a di�erent number for the ISV port.

Typically, this is not a problem because when the License Manager is initially activated, it picks a random, high number, unused ISV port, and that port is typically unblocked. But if that port is blocked you have to either unblock it both ways or set your own unblocked ISV port in the license �le.

If ExtendSim stops working on a Client device, check the port number in the Status window of the RLSA on the Server. If that ISV port isn't already unblocked, set an ISV port in the license �le (see the instructions on changing an ISV port in the “License Manager on Server” section. The ISV port you set will always be used even if the License Manager restarts.

Managing a Floating License- continued

Frequently Asked Questions • ExtendSim Floating LicensesManaging a Floating License

- 5 -

Page 6: ExtendSim on Client Devices · 2020. 8. 25. · Changing the default port (5053) used for communication between the License Manager and ExtendSim. You can edit the license to use

Unlike Word and other applications that by default do not open other �les when they launch, when ExtendSim launches it requires the loading of certain �les and it expects that those �les have been installed at speci�c locations. If needed �les don’t have the correct permissions, or if ExtendSim can’t �nd them, ExtendSim will not launch properly.So that they can open, run, and save �les, end users must have physical (correct user account) and permitted (read/write or full) access to the ExtendSim folder that contains user-modi�able �les (libraries, example models, etc.). In addition, so that ExtendSim will know where those needed �les are located, the installer places a text �le (ExtendSimDocPath.txt) in the Program Files/ExtendSim folder.

Permission and Location Issues for User-Modifiable and Other Files

Security features in Windows operating systems (especially since Windows 10), and virus protection programs in general, can sometimes interfere with installing or launching ExtendSim �les. These issues most often occur because: • The ExtendSim installer installs DLLs that need to be registered in the Windows Registry during installation. If the Windows operating system or your security software restricts this: • You’ll get a ComponentTransferData or Codebase failed to register error as the installer tries to register the DLLs. • If that doesn’t happen, you might get a _RightClickConnect database is missing message when ExtendSim launches and tries to open the Getting Started model, indicating that a required DLL is missing. • The ExtendSim application has an integrated compiler, so it creates and executes compiled code from the DATA segments of memory when it runs. In trying to protect your device: • Windows Data Execution Prevention (DEP) could cause ExtendSim to fail on launch and report an Unknown msg error or fail when placing a block in a new model and give an Unknown block message. • Some security systems could incorrectly identify ExtendSim as potential malware and stop it from launching or running, even though ExtendSim is digitally signed. • For a Floating License: • The installer for the License Manager not only creates the Service but tries to start it running automatically. Security systems will sometimes block the service from starting. • For automatic activation of the License Manager, encrypted data must be exchanged through port 80 over the internet. Security systems sometimes block that communication, so you must do a manual activation. • The ISV port must be unblocked or you will get a Connection refused at Server message when you launch ExtendSim. If you are having security problems installing or launching: • Be sure you have the correct permissions. If possible, right-click the installer or the ExtendSim application and choose Run as Administrator. Or contact your IT or Admin and have them install ExtendSim to your user account with the correct Admin permissions (once that happens, it won’t be required again). • Temporarily disable your virus protection software while installing ExtendSim or activating a Floating license’s License Manager. Note that for Windows 10, Windows Defender acts as an anti-virus system as discussed below. • If the ISV port for a Floating license is blocked, either unblock the port or use a di�erent port for the ISV Server, as discussed in License Manager on Server on page 2 of this document. • See the Data Execution Prevention (DEP) instructions on page 6 if ExtendSim fails on launch or upon block placement.

Security Issues When Installing and Launching

Issues When Installing or Launching ExtendSim or Opening ExtendSim Files

- 6 -

Frequently Asked Questions • ExtendSim Floating LicensesSecurity Issues When Installing and Launching • Permission & Location Issues

Page 7: ExtendSim on Client Devices · 2020. 8. 25. · Changing the default port (5053) used for communication between the License Manager and ExtendSim. You can edit the license to use

• In certain unusual cases, standard C runtime libraries that ExtendSim expects to �nd may be missing from your Windows operating system. In that case you will get the error message api-ms-crt-runtime dll is missing from the computer when you try to launch ExtendSim. In this case you need to update your Windows operating system with the Universal C Runtime (CRT) component. See Microsoft support for information. • When the operating system restricts ExtendSim from registering as an OLE/COM server, the following issues occur: • You get the error message Run-time error 429: ActiveX component can’t create object. • Excel might not appear in the list of applications in the Data Import Export block. For ExtendSim to be able to interface with Excel and other apps, launch ExtendSim with Administrative privileges so that it can complete the process of registering itself as an OLE/COM server. To do that, either right-click the ExtendSim application and select Run as Administrator or contact your IT or Admin and have them launch ExtendSim in your user account with the correct Admin permissions (once that happens, it won’t be required again).

Other Issues When Installing or Launching ExtendSim

After you have activated ExtendSim, the Activation Dialog should not appear again spontaneously. If it does appear, it could indicate that: • The license �le (extendsim.lic) has been placed at the wrong location when you manually activated the software or has been deleted. Verify that the license �le is in the ExtendSim folder that contains the user-modi�able �les (libraries and example models); by default, that folder is UserName/Documents/ExtendSim10. • There are multiple instances of the same ExtendSim product installed on your device. For example, you may have downloaded a Trial version of ExtendSim Pro to use as the updater for an existing installation of Pro. To properly update the existing �les, the Trial version must be installed using the exact same folder name and to the same location as the current installation. If there are duplicate installations, uninstall the Trial version and reinstall it over the existing installation so that it updates the ExtendSim 10 �les.

Activation Dialog Issues

The most common reasons why user-modi�able and other necessary �les were not correctly installed are: • Someone from IT or an Admin installed the user-modi�able �les in a folder under their account rather than in a folder accessible by the end user. • The folder containing user-modi�able �les does not give the end user or ExtendSim the correct permissions. • The folder that contains user-modi�able �les has been moved after installation, so ExtendSim is looking for �les at the wrong location.If ExtendSim reports a problem (such as “Documents folder not found” or “lp_solve…system error code: 2”) as it tries to launch or gives a similar error message when end users try to open model or library �les: • Verify that user-modi�able �les such as examples and and libraries are installed in a folder that is accessible by the end user; by default, that folder is UserName/Documents/ExtendSim10. • Check the permissions for the ExtendSim folder where user-modi�able �les and extensions are installed. End users need read/write or full access to that folder, depending on its location, so they can open, run, and save models. • So ExtendSim can properly open needed �les, right-click its icon and select Run as Administrator as you launch it. • If the user-modi�able �les were moved after installation, modify the �le ExtendSimDocPath.txt (located by default at Program Files/ExtendSim10) to indicate the new location.

Permission and Location Issues for User-Modifiable and Other Files - continued

Frequently Asked Questions • ExtendSim Floating LicensesPermission & Location Issues • Other Issues

- 7 -

Page 8: ExtendSim on Client Devices · 2020. 8. 25. · Changing the default port (5053) used for communication between the License Manager and ExtendSim. You can edit the license to use

• Windows Defender Security Center • In addition to any installed virus protection apps, Windows 10 installs with a Windows Defender Security Center that has virus, threat, account, firewall, and network protection. So even if you have temporarily disabled your virus protection app, the Security Center could be blocking the installation or launching of ExtendSim. You may need to change the settings or set the ExtendSim installer to be excluded in the Windows Defender Security Center. Be especially aware of those settings if you are attempting to install ExtendSim on virtual machines using Windows 10. • Data Execution Prevention (DEP) • If ExtendSim fails on launch with Unknown message or fails when placing a block in a new model with the Unknown block message, it is probably due to a Windows security feature called Data Execution Prevention (DEP). • DEP can help prevent damage to your computer from viruses and other security threats. It does this by stopping the execution of potentially malicious code from the DATA segments of memory. • ExtendSim has an integrated compiler, so it creates and executes compiled code from the DATA segments of memory when it runs. Depending on how it is set, DEP can interpret this as malicious data, rather than legitimate code, and stop ExtendSim from properly launching (by giving an Unknown msg error) or prevent it from accepting a block in a new model (by giving an Unknown block message). • To access DEP: • Go to the System & Security or Maintenance in Windows Settings. • Click System, then go to Advanced System Settings. • Under Performance, click the Settings button and select the Data Execution Prevention tab. • Since many legitimate applications execute code in the DATA segments of memory, Windows has two methods for allowing applications to be exempt from DEP restrictions: • The default setting for DEP is "Turn on DEP for essential Windows Programs only." If DEP is in this mode, ExtendSim will run properly. • The higher security setting for DEP is "Turn on DEP for all programs and services except those I select". If DEP is in this mode, it will interpret ExtendSim as being a potential threat and prevent ExtendSim from properly running unless ExtendSim is added to the list of exempted programs. To add ExtendSim to the list of programs that allow Data Execution, find the DEP dialog and add ExtendSim.

Specific Situations to be Aware of

- 8 -

Frequently Asked Questions • ExtendSim Floating LicensesSpecific Situations to be Aware of

Page 9: ExtendSim on Client Devices · 2020. 8. 25. · Changing the default port (5053) used for communication between the License Manager and ExtendSim. You can edit the license to use

Step 1 • Stop and remove the currently running RLM Service 1. Determine the name of the existing RLM Service (the Service used by the other RLM-managed products). 2. Stop that Service. (Instructions for stopping that Service under Windows 10; others differ:) • Right-click on the Server’s Start command and choose Computer Management. • In the list that appears, double-click Services and Applications. • Double-click Services. • In the list that appears, scroll to the name of the identified RLM Service. • Stop that Service (right-click select Stop). • Close the Computer Management window. 3. Remove the currently running RLM Service. • Open Command Prompt as Administrator (Enter CMD in the Search box and simultaneously click Ctrl+Shift+Enter). • Click Yes in the User Account Control window to enable Windows Command Processor. • At the command line, enter SC delete xyz (where xyz is the name of the identified RLM Service) and press Enter. • If successful, the Service will be removed and you can close the window.

Case 2 • If the currently running version of RLM is earlier than release 12

Step 1 • Install the ISV Settings File on the Server 1. DO NOT INSTALL THE EXTENDSIM LICENSE MANAGER ON THE SERVER. 2. Obtain an ISV settings file (extendsim.set) from Imagine That Inc. 3. Place the extendsim.set file in the same directory where the other RLM-using product has installed RLM.exe and their license and settings files.Step 2 • Activate the License 1. Follow the instructions for Step 2 • Activate the License Manager in the document Installing & Activating ExtendSim Floating Licenses. 2. Activation will either be automatic or manual. 3. Make a copy of the extendsim.lic file for use in activating ExtendSim on each Client device. • Since RLM was already running, the extendsim.lic license file will be located in the same folder where you placed the extendsim.set file. • If you subsequently edit the license file, such as changing the ISV port, distribute the modified file to the Clients.Step 3 • Install and Activate ExtendSim on Client devices 1. Follow the instructions for Step 3 • Clients: Installing ExtendSim, in the document Installing & Activating ExtendSim Floating Licenses. 2. Follow the instructions for Step 4 • Activating ExtendSim on Clients, in that same document .NOTE: With this option, the License Manager (RLM) will run as a Service under the existing Service’s name. The Service will not be named ExtendSimLicServer.

Case 1 • If the currently running version of RLM is release 12 or greater

DO NOT use the installer named ExtendSimServerLicenseManager unless instructed below.

The Floating license of ExtendSim uses the Reprise License Manager (RLM.exe). If RLM is already running on the Server where you want to install the License Manager for an ExtendSim license, there are two options: Case 1 • If the currently running version of RLM is release 12 or greater, use Case 1, below, to add ExtendSim files to the existing installation. Case 2 • If the currently running version of RLM is earlier than release 12, use Case 2, below, to stop and remove the existing Service and instead use the RLM.exe that ships with ExtendSim.

Reprise License Manger (RLM)Already Installed on Server

When RLM is already running on the Server where you want to install the License Manager for ExtendSim

Frequently Asked Questions • ExtendSim Floating LicensesRLM Already Installed

- 9 -

Page 10: ExtendSim on Client Devices · 2020. 8. 25. · Changing the default port (5053) used for communication between the License Manager and ExtendSim. You can edit the license to use

Note 1 • What if I don’t know if RLM is already running on the Server? If you installed the License Manager without following these instructions, the log file will report something similar to:

Notes

...error binding UDP port 5053, port in use

This is probably due to another copy of RLM running

While not fatal, this instance of RLM won’t respond

to broadcast requests.

(rlm)

(rlm)

(rlm)

(rlm)

Step 2 • Install the License Manager (RLM.exe) used by ExtendSim 1. Use the ExtendSimServerLicenseManager installer (obtained from an email, a download, or an ExtendSim 10 USB drive) and follow its instructions to install the files on the Server. 2. If you encounter security issues when installing, see Security Issues earlier in this document. 3. By default the installer creates a folder named ExtendSimFloatingLicenseServer that is placed at the root of the Server’s C drive (C:/ExtendSimFloatingLicenseServer). The folder contains the RLM Svc folder and three files: extendsim.set, log�le, and RLM.exe. 4. After installation, the License Manager (RLM.exe) silently runs in the background as a Service named ExtendSimLicServer. 5. Before proceeding, we suggest you verify that ExtendSimLicServer is running as a Service. 6. Copy the all the settings and license files (but not RLM.exe) from the previous RLM server folder to the ExtendSimFloatingLicenseServer folder, which by default will be located at the root of the C drive.Step 3 • Activate the License Manager 1. Follow the instructions for Step 2 • Activate License Manager in the document Installing & Activating ExtendSim Floating Licenses. 2. Activation will either be automatic or manual. 3. Make a copy of the extendsim.lic file for use in activating ExtendSim on each Client device. • The extendsim.lic license file will be located by default at C:/ExtendSimFloatingLicenseServer. • If you subsequently edit the license file, such as changing the ISV port, distribute the modified file to the Clients.Step 4 • Install and Activate ExtendSim on Client devices 1. To install on Client devices, follow the instructions for Step 3 • Clients: Installing ExtendSim, in the document Installing & Activating ExtendSim Floating Licenses. 2. Then, to activate ExtendSim on Client devices, follow the instructions for Step 4 • Activating ExtendSim on Clients.

Case 2 • If the currently running version of RLM is earlier than release 12 - continued

Frequently Asked Questions • ExtendSim Floating LicensesRLM Already Installed

- 10 -

Page 11: ExtendSim on Client Devices · 2020. 8. 25. · Changing the default port (5053) used for communication between the License Manager and ExtendSim. You can edit the license to use

• The License Manager is speci�c to: • The product that is installed on the Client devices: ExtendSim Pro, ExtendSim DE, ExtendSim CP, or Analysis RunTime. • ExtendSim 10 and above. Previous releases use a di�erent License Manager. • The License Manager is bound to the Server it is installed on, either through the hard disk hardware serial number, the BIOS id, or some other hostID. You must contact us before trying to “move” the License Manager to a di�erent Server. • After activation, the License Manager runs as a service process that remains running as long as the system is up (regardless of user logins and logouts), and restarts automatically when the Server is rebooted. • When �rst launched and at midnight local time each day, the License Manager triggers a reread of its extendsim.lic license �le, then opens port 5053 to receive license requests from Client devices. • Reports: • The License File (extendsim.lic) describes the license granted. • The License Manager (ExtendSimLicServer) generates con�gurable usage reports. It also provides debug logs for diagnosing licensing inconsistencies or failures. They are written to the same directory that contains the License Manager, as long as this directory is writable. If it is not writable, the log �les will be written to \\Windows\system32. • CAUTIONS: • NEVER run the License Manager as a privileged user/administrator. • The license �le (extendsim.lic) cannot be placed in a path where any component of the pathname contains the “@” character. • If the server node name or port number is changed after a license has been checked out for roaming, you will not be able to return the license early. However, it will return automatically on the “return by” date, which is usually 30 days after checkout. • You cannot just reinstall a newer release of the ExtendSim Server License Manager over an existing installation of the Server's License Manager. First uninstall the License Manager from the Server as discussed under License Manager on a Server on page 2 of this document.

About the License ManagerLicense Manager: Additional Information

©1987-2020 Imagine That!, the Imagine That! logo, and ExtendSim are registered trademarks of Imagine That Incorporated in the United States and/or other countries. All other brands or products are trademarks or registered trademarks of their respective owners.

- 11 -

08/20

Frequently Asked Questions • ExtendSim Floating LicensesLicense Manager


Recommended