License Manager Startup

If the License Manager gives an error message when starting, find the error message below and follow the instructions to eliminate the error.

License Manager Log Files

On UNIX and Macintosh systems, output from the License Manager is written to a file named lmgrd_log.txt in the license directory of the product installation directory.

Invalid Server Hostname

date time (lmgrd) "Hostname1": Not a valid server hostname, 
exiting. 
date time (lmgrd) Valid server hosts are: "Hostname2" 

In spite of the error message, Hostname1 is the hostname of the server that probably should be in the license file, while Hostname2 is the incorrect hostname currently in the license file. Edit your license file to contain the correct hostname.

Inconsistent Encryption Code

date time (idl_lmgrd) Inconsistent encryption code for idl 

There is a problem with the information on the FEATURE or INCREMENT line of the license file. Verify that the license key was entered correctly. Check capitalization and spacing, making sure it is exactly the same as in the license file sent to you. Finally, check to make sure that long lines in the license file have not been inadvertently wrapped to a new line.

No Features to Serve

If you receive either of the following error messages:

No such feature exists. 

Or,

date time (idl_lmgrd) No features to serve! 

there are no valid FEATURE or INCREMENT lines. This is most commonly due to the "inconsistent encryption code" error described above.

Retrying Socket Bind and Cannot Establish Lock

date time (lmgrd) Retrying socket bind (address in use: port 1700) 

An attempt has been made to start the License Manager when it was already running. This often happens when the license file contains a mistake, the mistake is corrected, and the License Manager is started again before the first attempt has been shut down or killed. There might also be some other software product using the default port number, 1700.

(Windows) - Stop the service using the LMTools utility and restart the service. Be sure that only one ITT Visual Information Solutions network License Manager has been configured to start automatically on that machine.

(UNIX or Macintosh) Issue the lmdown command multiple times, and restart the License Manager again. To shut down the License Manager, you can issue the following commands:

ITT_DIR/idlxx/bin/lmdown -c ITT_DIR/license/license.dat 

The lmdown command should be repeated until the utility indicates that the license manger is not running. Then restart the License Manager.

If the problem occurs at boot time on UNIX or Macintosh, then it is possible that more than one instance of the boot time startup script or command was implemented on your system.

No Such File or Directory

license daemon: execl failed: .../idl -T host 2.40 3 -c 
license daemon: system error code: No such file or directory 

The path on the DAEMON line of the license file is incorrect. It should point to the IDL directory. Edit the license file and correct the DAEMON line.

No "License" Server Found

date time (lmgrd) No TCP "license" service exists. 

This error means that no TCP/IP service port number is specified or no TCP/IP service is available.

Check for the existence of the /etc/services file. Make sure that the file contains the following line:

tcpmux          1/tcp 

Cannot Find License File

License Manager: can't initialize: cannot find license file 
(No such file or directory) 
date time (lmgrd) Using license file "filename" 

The License Manager cannot find the license.dat file. Either the license.dat file is not in the default location or the file specified in the environment variable LM_LICENSE_FILE is incorrect. Also, make sure that the filename license.dat is spelled correctly and that you have read permission for the license.dat file.

IDL might use a license source different from LM_LICENSE_FILE if IDL_LMGRD_LICENSE_FILE is defined in a .flexlmrc file or as an environment variable. For more information, see License Sources.

Cannot Read License File

License Manager: can't initialize: cannot read license file 
(Permission denied)' 

The permissions are set incorrectly on the license.dat file. Set the file to allow read permission for all users.

Wrong Host ID for Server (Windows)

Wrong hostid on Server line for license file: C:\Program 
Files\ITT\License\license.dat. 
SERVER line says 000c0123454, hostid is 000c0abcde 
Invalid host on SERVER line. 

The host ID in the license file does not match the host ID of the machine. Verify that you are using the correct machine. Make sure that the license file has been correctly copied from the original information sent to you by ITT Visual Information Solutions.

If you need a corrected license file, use the License Wizard and select Activate a license using the internet. After logging on to the licensing web site, you can request a corrected license.

Path Not Found (UNIX / Macintosh)

lmgrd: PATH/bin.<platform>/lmgrd: not found. 

This error indicates that the IDL directory is not in a standard location and that the environment variable IDL_DIR is not set to the actual IDL directory. There are several solutions to the problem:

Change directories to ITT_DIR/idlxx/bin. Make a copy of the lmgrd script:

cp lmgrd lmgrd.bak 

Open the lmgrd script with an editor. Verify that the INSTALL_DIR environment variable is defined as ITT_DIR. For example, if you have installed in the default path, this should be defined as /usr/local/itt (UNIX) or /Applications/itt (Macintosh).

Invalid Server Hostname (UNIX / Macintosh)

date time (lmgrd) "Hostname1": Not a valid server hostname, 
exiting. 
date time (lmgrd) Valid server hosts are: "Hostname2" 

In spite of the error message, Hostname1 is the hostname of the server that probably should be in the license file, while Hostname2 is the incorrect hostname currently in the license file. Edit your license file to contain the correct hostname.

Alternatively, if you have installed IDL on a laptop connected to a network that dynamically assigns IP addresses, make the following change to your /etc/hosts file:

Copy the hostname (not the host ID) of your laptop from the SERVER line in your license.dat file and add it to the localhost line of the etc/hosts file. For example, if the localhost line in your /etc/hosts file reads:

127.0.0.1   localhost 

and the hostname for your laptop in the license.dat file is mylaptop, change the localhost line to read:

127.0.0.1   localhost mylaptop 

If the server hostname is dynamically assigned, the license is used only by the license server machine. Another approach is to edit the license file so that the hostname on the SERVER line is replaced with the loopback IP address 127.0.0.1. For example, if the SERVER line in the license data file reads:

SERVER mylaptop 0000123abcd 1700 

use a plain text editor to change the line to read:

SERVER 127.0.0.1 0000123abcd 1700 

Note
Improper changes to the /etc/hosts file can create network configuration problems. Consult a network administrator if you have questions about changing this file.

Alternatively, you can alter the hostname on the SERVER line of the license file to replace the existing hostname with the string this_host. For example:

SERVER this_host 12345678 1700 

Using this_host allows your license to adapt to the current hostname of the license server machine. This is particularly useful for machines that dynamically acquire a hostname through a DHCP connection.