Flexible Single-User and Windows Node-Locked Licenses

This section suggests possible courses of action if you encounter problems with a license that does not require a license server. Solutions described here apply if you have one of the following license types:

A flexible single-user license (available on Windows, Macintosh, and Linux platforms)

A node-locked license on a Windows platform

If you have a different type of license, see Licenses Requiring a License Server.

Note
The sample error messages and license text in this section refer to IDL. They are the same for ENVI, except that the FEATURE and INCREMENT lines refer to envi and the current version number of ENVI.

Check the License Format

After installing the permanent license information via the License Wizard, one of the following error messages appears when attempting to start IDL:

% LICENSE MANAGER: Future license file format or misspelling in 
license file 
The file was issued for a later version of FLEXnet than this 
program understands. 
Feature:       idl 
License path:  C:\Program Files\ITT\License\license.dat;C:\Program 
Files\ITT\License\*.lic 
FLEXlm error:  -90,313.  System Error: 2 "" 
 
% LICENSE MANAGER: Invalid license file syntax 
Feature:       idl 
License path:  C:\Program Files\ITT\License\license.dat;C:\Program 
Files\ITT\License\*.lic 
FLEXlm error:  -2,134.  System Error: 2 ""

These errors might indicate that the license information has been corrupted.

Some email programs can corrupt license text, replacing original characters with invalid characters. For example, the string:

VENDOR_STRING="000011vendor" HOSTID=00b012345678 PLATFORMS=i86_r \ 
   NOTICE=PERSONAL_USE ck=99

could be inadvertently changed to:

VENDOR_STRING="000011vendor" HOSTID?00b012345678 PLATFORMS?i86_r \ 
   NOTICE?PERSONAL_USE ck?99

Another cause of license corruption is inadvertent line wrapping or concatenation introduced by the email program. For example, a line in the license might be changed from (2 lines).

Correct format:

INCREMENT idl idl_lmgrd x.xxx 1-jan-0000 0 1234567890abcdef \ 
   VENDOR_STRING="000011ITT Visual Information Solutions" \ 
   HOSTID=00b012345678 ck=123

Incorrect format:

INCRMENT idl idl_lmgrd x.xxx 1-jan-0000 0  
1234567890abcdef \ 
   VENDOR_STRING="000011ITT Visual Information Solutions" \ 
   HOSTID=00b012345678 ck=123

(Where x.xxx represents the current software version.)

For an example of a correctly formatted flexible single-user file, see Flexible Single-User License.

If the license file appears to have been corrupted, try to restore the problem characters or line wrapping to its original state. Or, if a separate file attachment of the license information was provided, please use the license information in the file attachment to replace the corrupted license information. You can use the License Wizard to edit the license file information that has already been installed. You can also install your license information by connecting to the ITT Visual Information Solutions Web site via the License Wizard (see Flexible Single-User License).

Host ID of This System Does Not Match the Host ID

After installing the permanent license information via the License Wizard, a form of the following error message appears when starting IDL or ENVI:

% LICENSE MANAGER: Invalid host 
   The hostid of this system does not match the hostid 
   specified in the license file 
  Feature:       idl 
  Hostid:        00b0d0911470 
  License path:  C:\Program 
Files\ITT\License\license.dat;C:\Program Files\ITT\License\*.lic 
  FLEXlm error:  -9,57.  System Error: 2 ""

Confirm that the node-locked host ID in the license matches the actual host ID of the machine that is running IDL or ENVI:

Start the License Wizard by clicking one of the following:

Start → Programs → IDL x.x → License Wizard

Start → Programs → ENVI x.x → License Wizard

Click Request a license if you don't have internet access.

Compare the Host ID value shown in the license request file with the HOSTID value in your IDL license file.

For example, the following IDL license feature line:

INCREMENT idl idl_lmgrd x.xxx 1-jan-0000 0 EC3B7DA4CA19E85C0A71 \ 
   VENDOR_STRING=000011RSI HOSTID=00b012345678 ck=123

is built for the Host ID "00b012345678".

If the host ID information obtained from the License Wizard is different from the information listed in the license file, then the license will not work with your machine. The license HOSTID value cannot be altered by a user without invalidating the license. If the host ID of the machine on which you are installing is different from the host ID in the license, you must request another license. See Using the License Wizard for more information.

Files Needed for Initialization of the Licensing Program Could Not Be Found

You might encounter this error when running the License Wizard if you do not have read permissions for the ITT_DIR/license directory, where ITT_DIR is the main installation directory. Possible ways to resolve this problem include the following actions:

Obtain read permissions for the ITT_DIR/license directory

Run IDL or ENVI as root, administrator, or the user who performed the original installation

If the error persists, the installation may be incomplete. Re-run the installation program to repair your IDL or ENVI installation.

License File Does Not Support This Version

After installing the permanent license information via the License Wizard program, a form of the following error message appears when attempting to start IDL:

% LICENSE MANAGER: License file does not support this version 
Feature:       idl 
Application version > License version: x.x > x.xxx 
License path:  C:\Program Files\ITT\License\license.dat;C:\Program 
Files\ITT\License\*.lic 
FLEXlm error:  -21,126.  System Error: 2 ""

Where x.x is the more recent software version, and x.xxx is an older version.

Confirm that the license being referenced contains the correct version. Check the license(s) listed in the "license path" of the error message to verify the contents of the referenced license. Below is an example of an IDL license feature (2 lines):

INCREMENT idl idl_lmgrd x.xxx 1-jan-0000 0 EC3B7DA4CA19E85C0A71 \ 
   VENDOR_STRING=000011RSI HOSTID=00b012345678 ck=123

If the listed IDL version is less than the version you are trying to license, then an old version of the license is being referenced. Make sure that the correct version of the license.dat file is being referenced. See License Sources for more information.

If you do not have a license with the correct version, you must request another license. See Using the License Wizard for information on how to request a license.

Cannot Find License

After installing the license information via the License Wizard, an error message appears that indicates that the license.dat file cannot be found. Following is an example for Windows:

% LICENSE MANAGER: Cannot find license file 
The license files (or server network addresses) attempted are  
listed below.  Use LM_LICENSE_FILE to use a different license file, 
or contact your software provider for a license file. 
Feature:       idl 
Filename:      C:\Program Files\ITT\License\license.dat 
License path:  C:\Program Files\ITT\License\license.dat 
FLEXlm error:  -1,359.  System Error: 2 "No such file or directory"

Make sure that you have either installed the license.dat file in the default location:

Windows:
ITT_DIR\License\license.dat

Unix and Macintosh:
ITT_DIR/license/license.dat

or that you have defined your LM_LICENSE_FILE environment variable to the path where the license.dat file exists. See Saving the License File in an Alternative Location for more information.

Note
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.

Additionally, be sure that you have read permissions for the license.dat file and for the default installation directory in which it resides.