LSF_LICENSE_FILE parameter

The LSF_LICENSE_FILE parameter in LSF_CONFDIR/lsf.conf points to the LSF license file.

The installation program lsfinstall configures the LSF_LICENSE_FILE parameter automatically for demo licenses only. You must set LSF_LICENSE_FILE manually if you do either of the following:

  • Install a permanent license

  • Install a DEMO or permanent license manually and change the location of the license file

To configure LSF_LICENSE_FILE, specify the full path name to the license file. A permanent license file should also be visible to the FlexNet license server host using the same path.

The value for LSF_LICENSE_FILE can be either of the following:
  • The full path name to the license file.

    • UNIX example:
      LSF_LICENSE_FILE=/usr/share/lsf/cluster1/conf/license.dat
    • Windows examples:

      LSF_LICENSE_FILE= C:\licenses\license.dat

      LSF_LICENSE_FILE=\\HostA\licenses\license.dat

  • For a permanent license, the name of the license server host and TCP port number used by the lmgrd daemon, in the format port@host_name. For example:

    LSF_LICENSE_FILE="1700@hostD"
  • For a license with redundant servers, use a comma (,) to separate each port@host_name or configure the full path of the license file. For port@host_name, the port number must be the same as that specified in the SERVER line of the license file. For example:

    LSF_LICENSE_FILE="port@hostA,port@hostB,port@hostC"
  • For a license with distributed servers, use a pipe (|) to separate the port@host_names on UNIX, Linux and Windows. The port number must be the same as that specified in the SERVER line of the license file. For example:

    LSF_LICENSE_FILE="port@hostA|port@hostB|port@hostC"
For example, after you run lsfinstall, the default setting is:
  • If you installed LSF with a default installation, the license file is installed in the LSF configuration directory (LSF_CONFDIR/license.dat).

  • If you installed LSF with a custom installation, the license installation directory is the one you specified. The default is the LSF configuration directory (LSF_SERVERDIR for the custom installation).

  • If you installed FlexNet separately from LSF to manage other software licenses, the default FlexNet installation puts the license file a location you specify, usually:

    • UNIX: /usr/share/flexlm/licenses/license.dat

    • Windows: C:\flexlm\license.dat

LSF_LICENSE_FILE can also be the name of the license server host and the port number used by lmgrd in the form port_number@host_name. For example, if your license file contains the line:

SERVER hosta 68044d20 1700

LSF_LICENSE_FILE would be:

LSF_LICENSE_FILE="1700@hosta" 

Troubleshooting

If this parameter points to an older or incorrect license key, correct the problem using one of these two methods:

  • Change the path to point to the location of the new key.

  • Put the new key in the location specified by the path (make a backup copy of your old license key before you overwrite it).