Licensing Troubleshooting

Manuals for Download (Also Included with All Installers)

 

License Server or License Client ?

The license file is locked to a computer based on the SERVER line in the license file. That computer must run the license server software (called license daemons and named "lmgrd" and "reaction") before any product can checkout a license. If you have received the license file from Reaction Design, please be sure to start the License Server as documented in the Installation_and_Licensing.pdf. The License Server software is included with the product installers, but additional steps are needed to start the License Server.

If you have been told that the License Server is located on another computer, then you are installing the product(s) as a License Client. In this case, you must specify how to connect to the License Server (typically 28850@server-name) and make sure that the communication channels are not blocked by any firewall or other impediments. A local network connection or VPN connection to the License Server computer is required to run the product.

Please select one of the 4 options below that will take you to the appropriate help section:

I am using a License Client.

  1. I am using Windows. My computer is a License Client.
  2. I am using Linux or Unix. My computer is a License Client.

I am using the License Server. I have a license file and will be starting the License Server -- or confirming it has already started.

  1. I am using Windows. My computer is the License Server.
  2. I am using Linux or Unix. My computer is the License Server.

 

The sections below have help for each of the 4 cases listed above.

1. Windows License Client Help

The client license connection is achieved by performing the following steps:

      1. Install the product(s). This also installs the license utilities used to connect to the License Server.
      2. Specify the location of the license server. Typically, this is specified as a port@host location, such as 28850@your-lic-server . Use the Manage Reaction Design License utility that is launched from your Start Menu as follows:
        Start ->
                 All Programs ->
                    Reaction Design ->
                        License Tools ->
                            Manage Reaction Design License  (Important:  Use right-click and select "Run as Administrator")
      3. Confirm the License Server is receiving the connection using the Test Reaction Design License Server Status utility.
            Start ->
                 All Programs ->
                    Reaction Design ->
                        License Tools ->
                            Test Reaction Design License Server Status
        
The information that verifies the license server connection is working is found at the top of the output. You are looking for license server UP and reaction: UP. You can also see the version number of the license server daemons. In the example output (click this link), both daemon programs are UP and both are version 11.4.
 
Please see the below reference for more help.
      1. Once you confirm the License Server is responding, then run the product, such as CHEMKIN-PRO. Running the product as a test of the License Server connection is NOT as efficient for trouble-shooting as the Test Reaction Design License Server Status command.

2. Linux/Unix License Client Help

The client license connection is achieved by performing the following steps:

      1. Install the product(s). This also installs the license utilities used to connect to the License Server.
      2. Specify the location of the license server. Typically, this is specified as a port@host location, such as 28850@your-lic-server. Use the manage_license.sh utility as follows:
        $REACTION_DIR/licenses/license_utilities/manage_license.sh setpath 28850@your-lic-server
        where $REACTION_DIR is the location where you installed the Reaction Design product(s). The above will update a UNIX hidden file in the license_utilties directory named .reaction_license_server_path that is used by our CHEMKIN-PRO, CHEMKIN, ENERGICO, and FORTE setup scripts to locate the license server.
         
        If you are using  the CHEMKIN-CFD/Fluent Module, then please see this reference:
      3. Confirm the License Server is receiving the connection using the Test Reaction Design License Server Status utility.
        $REACTION_DIR/licenses/license_utilities/check_license.sh
        where $REACTION_DIR is the location where you installed the Reaction Design product(s).

        The information that verifies the license server connection is working is found at the top of the output. You are looking for license server UP and reaction: UP. You can also see the version number of the license server daemons. In the example output (click this link), both daemon programs are UP and both are version 11.4.
         
        Please see the below reference for more help.

      4. Once you confirm the License Server is responding, then run the product, such as CHEMKIN-PRO. Running the product as a test of the License Server connection is NOT as efficient for trouble-shooting as the Test Reaction Design License Server Status command.

3. Windows License Server Help

The license server is installed and started by performing the following steps:

      1. You must obtain a license file from Reaction Design license fulfillment as part of a product trial or purchase. You will need this license file to obtain access to the product download web site. By default, our license file is placed in C:\Program Files\reaction\licenses folder. This folder is created when you install our products or our license server utilities (in the next step). If you do not plan to install any of our products on the License Server, you will need to create a directory to contain the license file and the license server utilities.
      2. Install the license server utilities in one of these ways:
        • Install the product(s). This also installs the license utilities used to start and manage the License Server.
        • Install just the license utilities. These can be downloaded from the Reaction Design License Utilities page and provide the license utilities that are included with the product installations.
      3. Specify the location of the license server. On the license server, you must specify the license file path, not port@host. Use the Manage Reaction Design License utility that is launched from your Start Menu as follows:
                Start ->
                       All Programs ->
                          Reaction Design ->
                             License Tools ->
                                Manage Reaction Design License   (Important:  Use right-click and select "Run as Administrator")
                            

        We recommend installing the License Server as a Windows Service by using the Start Service button and checking the Start Service at Boot Time option (on by default). See the License Service section for more details.  

      4. Confirm the License Server is receiving the connection using the Test Reaction Design License Server Status utility.
             Start ->
                     All Programs ->
                        Reaction Design ->
                           License Tools ->
                              Test Reaction Design License Server Status
                        

        The information that verifies the license server connection is working is found at the top of the output. You are looking for license server UP and reaction: UP. You can also see the version number of the license server daemons. In the example output (click this link), both daemon programs are UP and both are version 11.4.
         
        Please see the below reference for more help.

      5. Once you confirm the License Server is responding, then run can also run the product, such as CHEMKIN-PRO, on the machine hosting the license server. Running the product as a test of the License Server status is NOT as efficient for trouble-shooting as the Test Reaction Design License Server Status command.

4. Linux/Unix License Server Help

The license server is installed and started by performing the following steps:

      1. You must obtain a license file from Reaction Design license fulfillment as part of a product trial or purchase. You will need this license file to obtain access to the product download web site. By default, our license file is placed in ~/reaction/licenses folder, where ~ is the home directory of the user performing the installation. This folder is created when you install our products or our license server utilities (in the next step). If you do not plan to install any of our products on the License Server, you will need to create a directory to contain the license file and the license server utilities. For a central installation, /usr/local/reaction/licenses would be a typical location.
      2. Install the license server utilities in one of these ways:
        • Install the product(s). This also installs the license utilities used to start and manage the License Server.
        • Install just the license utilities. These can be downloaded from Reaction Design License Utilities page and provide the license utilities that are included with the product installations.
        • Download just the FLEXnet daemons and utilities needed to run the License Server. If you are very familiar with using FLEXnet licensing, this may be all you need. You can obtain these daemons from Reaction Design License Utilities page.
      3. Specify the location of the license file. On the License Server, this is the file path, not port@host. Use the manage_license.sh utility in two steps as follows:
        $REACTION_DIR/licenses/license_utilities/manage_license.sh setpath license-file-path
        
        $REACTION_DIR/licenses/license_utilities/manage_license.sh start
        where $REACTION_DIR is the location where you installed the Reaction Design product(s).

        The above will update a UNIX hidden file in the license_utilties directory named .reaction_license_server_path that is used by our manage_license.sh utility to locate the license file.
         
        We recommend installing the License Server as a Windows Service by using the Start Service button and checking the Start Service at Boot Time option (on by default). See the License Service section for more details 
        If you are using CHEMKIN-CFD/Fluent Module, then please see this reference:

      4. Confirm the License Server is successfully started by using the check_license.sh utility.
        $REACTION_DIR/licenses/license_utilities/check_license.sh
        where $REACTION_DIR is the location where you installed the Reaction Design product(s).

        The information that verifies the license server connection is working is found at the top of the output. You are looking for license server UP and reaction: UP. You can also see the version number of the license server daemons. In the example output (click this link), both daemon programs are UP and both are version 11.4.
         
        Please see the below reference for more help.

      5. Once you confirm the License Server is responding, then you can also run the product, such as CHEMKIN-PRO, on the machine hosting the license server. Running the product as a test of the License Server status is NOT as efficient for trouble-shooting as the check_license.sh command.

Example Output of Check License Utility

    lmutil - Copyright (c) 1989-2007 Macrovision Europe Ltd. and/or Macrovision Corporation. All Rights Reserved.
    Flexible License Manager status on Thu 9/23/2010 12:31

    [Detecting lmgrd processes...]
    License server status: 28850@HQMGT01
        License file(s) on HQMGT01: C:\Licenses\hqmtg01_rd.lic:

       HQMGT01: license server UP (MASTER) v11.4

    Vendor daemon status (on HQMGT01):

      reaction: UP v11.4
    Feature usage info:

    Users of AURORA:  (Total of 100 licenses issued;  Total of 0 licenses in use)
    etc.
                        

License Server Log File ("debug.log")

When investigating License Server problems, either at startup or when the License Server has been running for a while, the first and best place to start the investigation is with the lmgrd's "debug log" file. For the Reaction Design license servers, this log file is placed in the same directory as the license file and is named "debug.log" or "reaction_debug.log".

By default, the log file contains a record of the license daemons starting, license checkout and checkin, license denials, and any other problems detected by the license daemons. When the License Server (the license daemon programs "lmgrd" and "reaction") fails to start, the reason is typically listed in the debug.log file


License Service

Defining the License Server programs as a system service is the preferred way to ensure that the License Server is automatically restarted when the computer is rebooted. On Windows systems, our Manage Reaction Design License utility has that as the default behavior (requires Administrator access). On Linux, the system manager will need to define an /etc/init.d/ directory program to perform this task. An example is found in the Installation_and_Licensing.pdf.