Windows Setup Instructions for lmgrd

Information Required to Create the License Server File

To generate a FlexNet server license file, you must collect the following information from the system that will host the license server:

  • Host ID (that is, Ethernet address)

  • Hostname (or IP address)

Use the steps below to obtain this information.

  1. On the system where the FlexNet server is running or will run, start LMTOOLS. It is typically located in:

    <server_install_dir>\FlexNetLicenseServerTools\lmtools.exe

  2. Open the System Settings tab.
    • The Computer/Hostname field shows the required hostname.
    • The Ethernet Address field shows the required Host ID.
    • The IP Address field shows the optional IP address.
  3. Save the lmhostid output along with the hostname (or IP address). You will need this information to create the server license file.

 

Install the FlexNet Server

  • Create the server license file in:

<server_install_dir>/FlexNetLicenseServerTools/passwordServer.dat

  • Enter your server information using the following format:

SERVER <hostName> <hostId> [<portNumber>]

VENDOR <vendor name> [port=<vendor portNumber>]

Example:

SERVER BOD1060 0024e83de91e

VENDOR asglmd

Note: If multiple Ethernet addresses are listed, use the first one.

At this point, we assume the FlexNet files are installed in the default location:

<server_install_dir>/FlexNetLicenseServerTools/

FlexNet uses the lmgrd program to manage licenses. On Windows, FlexNet provides an advanced tool called LMTOOLS, which allows you to configure lmgrd to run as a service. This is the recommended configuration method.

Caution: Administrator privileges are required to configure a license server as a service.

Note: Ensure the vendor daemon (asglmd.exe or mcslmd.exe) is located in the same directory as lmgrd.exe.

  1. Launch LMTOOLS and navigate to the Service/License File tab. Select the Configugation using Services option.
  2. LMTOOLS Service/License File tab with highlight on Configuration using Services option

  3. Open the Config Services tab and configure the following fields:
  4. LMTOOLS Config Services tab with highlights on steps 4 to 10 of the protocol

  1. Service Name: Enter a name for the service that you wish to define. It is recommended to use the name "Thermo Scientific Applications License Manager".

  2. Path to the lmgrd.exe file: Specify or browse to the lmgrd.exe for this license server. Typically, the path will be:

  3. <server_install_dir>\FlexNetLicenseServerTools\lmgrd.exe

  4. Path to the license file: Enter or browse to the server license file. It is recommended to store the license file in:

  5. <server_install_dir>\FlexNetLicenseServerTools\passwordServer.dat

  6. Path to the debug log:

    • Specify or browse to the debug log file that this license server writes to, such as FlexNet.log.

    • Prefixing the debug log filename with a "+" appends to the log.

    • The default log location is C:\WINDOWS\System32. If specifying a custom location, use a fully qualified path. For most users, the following path should be appropriate:

  7. <server_install_dir>\FlexNetLicenseServerTools\flexnet.log

  8. (Optional) Click View Log to verify the log file opens and contains readable text. Select Close Log when finished.

  9. To ensure the license service starts automatically, select both:

    • Use Services

    • Start Server at Power Up

  10. Click Save Service to create the Thermo Scientific Applications License Manager service.

 

Start the Server

After configuring the license manager service, start lmgrd by initiating the service from the LMTOOLS interface:

  1. Launch LMTOOLS if it is not already running.
  2. In the Service/License File tab, select Configuration using Services.
  3. From the service list, select Thermo Scientific Applications License Manager.
  4. LMTOOLS Service/License File tab with highlights on steps 2 to 4 of the protocol

  5. Open the Start/Stop/Reread tab.
  6. Click Start Server.

The license server should now be running, and debug log entries will be written to <server_install_dir>\FlexNetLicenseServerTools\flexnet.log.

LMTOOLS Start/Stop/Read tab with highlight on Start Server button

Note: After modifying the server configuration, stop and restart the server for changes to take effect.

Note: After modifying license files, use ReRead License File in the Start/Stop/Reread tab. If the operation fails, wait a few seconds and try again.

 

Manage Your Licenses

  • To reread the license file and restart the Vendor Daemon, use the following command:

./lmgrd lmreread -c <server_license_file> -vendor <vendor_name (asglmd or mcslmd)>

Note: After making any changes to the license server configuration, you must stop the asglmd or mcslmd process. The vendor daemon will be automatically restarted by lmgrd to apply the changes.

Note: If you experience any issues with your configuration, verify that lmgrd and the vendor daemon have the required permissions to communicate through your system's firewall.