Table of Contents

License Wizard Options

Using the Licensing Web Site

Entering a License

Connecting to an Existing License Server

Troubleshooting

 
Previous Next

Connecting to an Existing License Server

If a license server for your product is already running on your organization's local network, you can connect to that license server without generating or retrieving a new license file for your machine.

Using the License Wizard

The easiest method is to place a copy of the server's license.dat file in the license subdirectory of your ITT product installation directory. If you have a copy of the license.dat file, do the following:

  1. Select Install a license you have received from the main license wizard screen
  2. Select Activated License
  3. Paste the text from your license.dat file into the text area
  4. Click Next and work through the remaining steps in the license wizard.

Using an Environment Variable

Alternately, you can define the LM_LICENSE_FILE environment variable to specify the hostname and port used by the license server.


Note
Your organization may license multiple software products using the same license server. If the process outlined below does not allow you to get a license for your ITT product, consult the administrator of your organization's license server, or see the Installation and Licensing Guide in your product's online help system for additional details.

Microsoft Windows

To define the LM_LICENSE_FILE environment variable, do the following:

  1. Open the System control panel.
  2. Click the Advanced tab, and click the Environment Variables button. Click the New button below the System Variables box and enter the following information:
    1. In the Variable Name field, type LM_LICENSE_FILE in uppercase letters.
    2. In the Variable Value field, enter your server's port@host value: for example, 1700@hal. This information is in your license file. The port number is the last number on the SERVER line. The host name immediately follows the word SERVER.
    3. If LM_LICENSE_FILE has already been defined for another software product, the definition of this license file can be appended using a semi-colon (;) as the delimiter. For example:

      C:\Program Files\ITT\License\mylicense.dat;1700@hal
      
  3. Save the settings.

If you choose to copy the license.dat file from the server to your local machine, place it in the license subdirectory of your ITT product directory. If the license directory does not already exist, you can create it. If your ITT product is installed in the default location, the license directory would be

C:\Program Files\ITT\License

UNIX and Macintosh OS X

To define the LM_LICENSE_FILE environment variable, do the following:

  1. Modify your .cshrc, .profile, or .bashrc file using any text editor. You must define the UNIX environment variable for LM_LICENSE_FILE to point to the server and port of the machine running the license manager. The syntax for the defining the environment variable is:
  2. port@host
    

    For example, if you are running the license manager on a machine named "hal" with a port of 1700, then enter the following:

    For C shell: setenv LM_LICENSE_FILE 1700@hal

    For Korn or Bash shell: export LM_LICENSE_FILE=1700@hal

    If LM_LICENSE_FILE has already been defined for another software product, the definition of this license file can be appended using a colon (;) as the delimiter. For example:

    /usr/local/myapplication/license.dat:1700@al
    
  3. Log out and log back in to execute the .cshrc, .profile, or .bashrc file, or execute the file from the home directory using one of the following commands.
  4. For C shell: source .cshrc

    For Korn shell: . .profile

    For Bash shell: . .bashrc

If you choose to copy the license.dat file from the server to your local machine, place it in the license subdirectory of your ITT product directory. If the license directory does not already exist, you can create it. If your ITT product is installed in the default location, the license directory would be

/usr/local/ITT/license

on a UNIX system, or

/Applications/ITT/license

on a Macintosh system

  IDL Online Help (September 20, 2007)