License Configuration

Manual configuration for FLEXlm licenses

How to get your FLEXnet™ license file

First of all, you need a valid FLEXnet™ license file which is sent to you separately from your SimulationX license. But before you can request your FLEXnet™ license files, information about your system must be collected first. You can find the necessary tools and documentation either in the FLEXlm folder on the installation medium or online in the SimulationX Customer Center. We recommend you copy the tools and documentation to the default FLEXnet™ directory C:\FLEXlm\.

  1. To request a floating license file, execute C:\FLEXlm\lmtools.exe from the PC that will be the FLEXnet™ license server. For a node-locked license file, execute C:\FLEXlm\lmtools.exe from each PC that will run SimulationX.

  2. Select the System Settings tab

  3. Use the button Save HOSTID Info to a File and send the generated file to your local SimulationX customer support. They will then send the license file to you.

Installing a license

FLEXnet™ license files can be node-locked with instance counting, node-locked without instance counting or floating. Both the node-locked license file with instance counting and the floating license file require the FLEXnet™ license server to be installed.

Setup of your FLEXnet™ node-locked license file

Move your license file to the appropriate directory C:\FLEXlm\ and rename it to pam_lmd.lic. Please refer to the section on how to configure an alternative location of the FLEXnet™ license file for more details.

To start the license server:

  1. Execute C:\FLEXlm\lmtools.exe

  2. Select the Service/License File tab and select the option Configuration using License File.

  3. Select the C:\FLEXlm\pam_lmd.lic file.

Setup of the FLEXnet™ license server

To set up a FLEXnet™ license server, find the necessary tools and documentation either in the FLEXlm folder on the installation medium or online in the SimulationX Customer Center. We recommended you copy the binaries and documentation to the default FLEXnet™ directory C:\FLEXlm\. The FLEXnet™ license server installation requires administrator rights. Once SimulationX has been installed, the pam_lmd.lic file needs to be moved to the appropriate directory and updated. And then you can start FLEXnet™ license server.

  1. Move your license file to the appropriate directory C:\FLEXlm\ and rename it to pam_lmd.lic. Please refer to the section on how to configure an alternative location of the FLEXnet™ license file for more details.

  2. Use a common text editor to edit pam_lmd.lic and modify the SERVER/VENDOR lines if necessary.

Starting the license server

  1. Execute C:\FLEXlm\lmtools.exe

  2. Select the Service/License File tab and select the option Configuration using Services.

  3. Select the Config Services tab, adjust the parameters as shown and click on Save Service.

  4. Select the Start/Stop/Reread tab and click on Start Server.

If you set up and start the FLEXnet™ license server as a local service, i.e., on the same PC as SimulationX, no further configuration steps are required.

Using the FLEXnet™ license server in your network

If the FLEXnet™ license server runs on a different PC in your network than SimulationX, establish a connection with it to use it.

  1. First, you need to locate the license server within your network.

  2. Then use a common text editor to create a text file containing the following information:

    SERVER IP_SERVER 0 27000
    USE_SERVER

  3. Replace IP_SERVER with the correct name of your FLEXnet™ license server. In some cases, switching to another port other than 27000 may be necessary.

  4. Save this text file to the appropriate directory C:\FLEXlm\ and rename it to pam_lmd.lic. Please refer to the section on how to configure an alternative location of the FLEXnet™ license file for more details.

This text file works as a placeholder and forwards all license queries to the server license.

Alternative location of your FLEXnet™ license file

The default location of the FLEXnet™ license file is C:\FLEXlm\pam_lmd.lic (where C:\ is the system drive). When SimulationX starts, the following locations are checked for a FLEXnet™ license file.

  1. Path to the license file in the environment variable PAM_LMD_LICENSE_FILE. This environment variable is checked for a license by all ESI software products, provided the option LMTOOLS ignores license file path environment variable is not selected.
  2. Path to the license file in the environment variable LM_LICENSE_FILE. This environment variable is checked by any software using the FLEXlm license protection, provided the option LMTOOLS ignores license file path environment variable is not selected.
  3. Path of the license under C:\FLEXlm\license.dat.

License Configuration (for Administrators)

This section deals with the license configuration for each individual user. It should only be modified by admins or users familiar with registering modules.

Configuration Sources

The settings of the default edition and licensing medium and whether to show license and module selection dialogs at startup can be stored in a configuration XML file. The various sources with different rights for the user and administration options are checked in the following order:

  1. Check the command line parameters which were passed to SimulationX when it was started. If the parameter /config: "Path\Filename" was found, use this path to load the configuration file. This option enables users to place shortcuts on their Desktop or Start Menu to start a certain edition of SimulationX directly. If no such parameter was given, then
  2. check the folder C:\Users\[Username]\Documents\SimulationX 4.3\Settings. If there is a licenseConfig.xml file, use it to configure SimulationX. This option enables different users on the same machine to use different license settings. If no such file exists, then
  3. check the folder C:\Users\Public\Documents\SimulationX 4.3\Settings. If there is a licenseConfig.xml file, use it to configure SimulationX. Placing a configuration file there enables different users on the same machine to share their license configurations.

The configuration settings are loaded as well as stored in these locations. In case a multi-user license is used, the set of available modules in SimulationX can be configured as well. This information can only be stored in a configuration XML files. If such a license is used, it is saved together with the selected modules to C:\Users\Public\Documents\SimulationX 4.3\Settings\licenseConfig.xml which from then on is used to save all license settings. In any other case, the license configuration source is not changed during the runtime of SimulationX.

Write-protection

The different configuration sources can be used for the rights management of the license settings:

Source

Changes allowed

Prompt confirmation before overwriting

Command line

Yes (except file is read-only)

Yes

User Documents

No

Public Documents

No

If the user is allowed to change the licensing settings, he or she can change the edition and the license medium or add modules. A read-only configuration file is the only way to keep the user from changing these settings. The user is shown a warning message when trying to save modified settings to read-only files. Any modification remains active until SimulationX is closed. This is relevant when there are no configuration dialogs shown at startup, while there are problems obtaining a valid license from the configured medium or when the configuration file is corrupted.

Configuration examples

  • If the configuration file was not found or is corrupted, SimulationX is closed after giving detailed informationon the encountered problems. In this case, the user has no priviliges to do anything about it.
  • If the configuration file passed along via command line parameters was not found, SimulationX starts with a default configuration. It is then stored under the given path, once the user changes any license-related settings.
  • If there are problems accessing the configured license medium, but the corresponding dialog is not shown, SimulationX is closed after giving detailed information on the specific problems. In the case, the user is allowed to modify the license settings and the medium selection dialog is shown at startup, the medium can be changed in the dialog.
  • Modified settings in combination with a read-only configuration file apply only for as long as SimulationX is running and are discarded once SimulationX is closed. This scenario is identical with the case where the user declines the overwrite prompt for a configuration file via command line parameters.

Creating license configuration files

You can create configuration files in the backstage area (FileLicensing) by clickingh on the button "Export Settings". The generated file holds the current license settings which can be used to restore and advanced users can also edit it if necessary. SimulationX validates the configuration files during startup reporting any problems encountered.