Previous Installing and Licensing IDL 6.2: Installing and Licensing IDL 6.2 for Windows Next

Licensing IDL for Windows

This section explains how to license IDL 6.2 under Windows.

Requesting a License

If you are licensing with a node-locked or floating license, you need a permanent license file from RSI or your distributor. The license file is created using information from the machine on which you have installed IDL. A built-in licensing program has been created to simplify the request and installation of your license file.


Note
You do not need to use the licensing wizard to request a license if you are using an evaluation license or a personal use license. For more information, see Evaluation License or Personal Use License.


Note
The electronic request program will not be able to retrieve the correct information if you do not have a configured network interface card and do not have one or more of the following network protocols:

    NETBEUI Transport Protocol
    NW Link (IPX/SPX) Transport Protocol
    SNMP service

Preparing a License Request

The licensing wizard lets you easily generate and send a license request, which contains information necessary for RSI to generate your license key. If you have exited the installation program, access the licensing wizard by selecting Start Programs RSI IDL 6.2 License.

If you are requesting a license from an IDL Virtual Machine installation, select Start Programs RSI IDL Virtual Machine 6.2 Evaluate IDL.


Note
If you have purchased a floating license, the licensing wizard must be run from the designated license server machine on which you have installed IDL. This ensures proper generation of the server LMHostid and Hostname for your license file.

  1. Begin the license request process. Click Permanent from the Product Licensing dialog.
  2.  

  3. Prepare a request file. Click Request to prepare a license request file to submit to RSI. The licensing wizard guides you through the creation of a license request file that will contain all the information necessary for RSI to create a valid license file for your software installation.
  4.  

  5. Enter your information. Fill in the following text fields in the Permanent Licensing dialog:
    • Contact Person - enter the name of the person to whom the license file should be sent.
    •  

    • Email Address - enter the email address of the contact person.
    •  

    • License Number - enter the installation number found on the RSI Product Registration Form. You should have already received this form by email or fax. If you have not received the form, contact RSI technical support. See Contacting RSI for more information.
    •  

    • Site Notice - enter the name that you want to appear when you launch the software. The name you select will replace <your site notice> in the following statement: "licensed for use by <your site notice>." This is typically your company's name, department, or project.

     

  6. Select the license type. Select either Node Locked or Floating. The license wizard automatically generates the correct Hostname and LMHostid. Do not modify these values.
  7.  

  8. Enter comments. Enter any comments you might have and click Next to continue.
  9.  

  10. Review your license request. If the information is correct, click Next to save the license request file and proceed. If the information is incorrect, edit it in the text window or click Back to make any corrections.
  11.  

  12. Send the license request file. Click Next to send the license request file to RSI. If you did not purchase your software directly from RSI, modify the email address and send the file to your local distributor.
  13.  


    Note
    If you cannot send email from your machine or if you receive a message stating that an attempt to send the email was unsuccessful, see Manually Sending a License Request. A license file will be generated and sent to you at the email address or fax number you supply.

     

  14. Exit the license wizard. Click Finish to exit the license request program.

If you do not receive a license file or any confirmation that the request was received, see the section below to manually resend the request. To contact RSI, see Contacting RSI.

Manually Sending a License Request

To manually send a license request, select the appropriate step below and email your request to register@RSInc.com or fax the request file text to RSI at (303) 786-9909. If you did not purchase IDL directly from RSI, send the file to your local distributor.

Evaluation Licensing

After installing IDL, use the licensing wizard to install the license key for your evaluation license. If you do not have a license key, contact your RSI sales representative to request an evaluation license.

  1. Start the licensing wizard. If you have exited the installation program, access the licensing wizard by doing one of the following:
    • Select Start  Programs  RSI IDL 6.2  License.
    •  

    • If you are evaluating IDL from an IDL Virtual Machine installation, select Start  Programs  RSI IDL Virtual Machine 6.2  Evaluate IDL.

     

  2. Access the Evaluation Licensing dialog. Select the Evaluation button on the Product Licensing dialog.
  3.  

  4. Enter your license information.
    • Select the product you want to license from the drop-down list. Only installed products are displayed
    •  

    • Enter the expiration date exactly as it appears on your registration form (for example, 1-Sep-2004)
    •  

    • Enter the license key exactly as it appears and click Next.

     

  5. Exit the licensing wizard. Click Finish.

IDL is now licensed. After your trial period expires, a message stating this fact appears when you start IDL. Until relicensed, IDL will operate only in seven-minute demonstration mode.


Note
If you encounter a problem, see Evaluation Licenses for troubleshooting information.

Personal Use Licensing

After installing IDL, use the licensing wizard to install the license key for your personal use license. Your license key will be sent to you via email or fax. If you have not received your license key, contact your RSI sales representative to request a personal use license

1. Save the License File

If your license key arrived via email, you can save the email message out to an unformatted text file so that the licensing wizard can import it. Complete the following steps:

  1. From your email application, save the license key email anywhere on your system as a text-only file.
  2.  

  3. With a plain text editor such as Notepad, remove any lines that appear before and after the actual license information, keeping the comment lines that begin with the "#" character.
  4.  

  5. Either save the text file or copy the edited license information text to the Windows clipboard. For an example of a license key, see Personal Use License.

2. Enter the License Key

To enter your license key:

  1. Start the IDL Licensing Wizard. If you have already exited the installation program and licensing wizard, click the Windows Start button, and select Programs  RSI IDL 6.2  License.
  2.  

  3. Display the Permanent Licensing dialog. Click Permanent and then License from the licensing wizard.
  4.  

  5. Enter your license key. Paste the text of the license key into the dialog, or click Browse to select the license file you saved on your system. If you paste in your license key text, remove any header lines that are included in the file, but keep the comment lines that begin with the "#" character. If you have received your license key via fax or other hardcopy method, type the information directly into the text window.
  6.  


    Note
    The license key consists of non-indented lines, indented lines, and blank lines. Besides the comment lines (lines beginning with the number sign [#]), non-indented lines should begin with a keyword such as FEATURE or INCREMENT. Because of email/fax limitations, extra-long lines of the license key might have been inadvertently wrapped to a new line. If a non-indented line begins with a character other than a number sign (#) or a FEATURE or INCREMENT keyword, then it is likely that an extra-long line has been incorrectly wrapped and that the segment belongs at the end of the previous line. Make sure that you review your license key for these errors. If the key does contain an error, the software will not be licensed.

     

  7. Save the license file. Click Next to save the license file in the directory where you have installed the software. The licensing wizard recognizes the installation location and generates the appropriate path: RSI-DIR\license\license.dat.
  8.  


    Note
    If you receive a message that there is an existing license file, save the existing file under a different name before proceeding. While the new license usually contains information for all currently licensed products, save the old file as a safeguard against destroying license information. Run the license wizard again to save the new license file in the default location.

     

  9. Exit the licensing wizard. Click Finish to save the license file.
  10.  


    Note
    If you need to save the license file in a directory other than the default RSI-DIR\license\license.dat, you must set an environment variable pointing to the license.dat file before starting the software or the license manager. See Saving the License File in an Alternative Location for instructions.

     


    Note
    If you encounter a problem, see Personal Use Licenses for troubleshooting information.

Node-Locked Licensing

After installing IDL, use the licensing wizard to install the license key for your node-locked license. Your license key will be sent to you via email or fax. If you have not received your license key, see Requesting a License.

1. Save the License File

If your license key arrived via email, you can save the email message out to an unformatted text file so that the licensing wizard can import it. Complete the following steps:

  1. From your email application, save the license key email anywhere on your system as a text-only file.
  2.  

  3. With a plain text editor such as Notepad, remove any lines that appear before and after the actual license information, keeping the comment lines that begin with the "#" character.
  4.  

  5. Either save the text file or copy the edited license information text to the Windows clipboard. For an example of a license key, see Node-Locked License.

2. Enter the License Key

To enter your license key:

  1. Start the IDL Licensing Wizard. If you have already exited the installation program and licensing wizard, click the Windows Start button, and select Programs RSI IDL 6.2  License.
  2.  

  3. Display the Permanent Licensing dialog. Click Permanent and then License from the licensing wizard.
  4.  

  5. Enter your license key. Paste the text of the license key into the dialog, or click Browse to select the license file you have saved on your system. If you paste in your license key, remove any header lines that are included in the file but keep the comment lines that begin with the "#" character. If you have received your license key via fax or other hardcopy method, type the information directly into the text window.
  6.  


    Note
    The license key consists of non-indented lines, indented lines, and blank lines. Besides the comment lines (lines beginning with the number sign [#]), non-indented lines should begin with a keyword such as FEATURE or INCREMENT. Because of email/fax limitations, extra-long lines of the license key might have been inadvertently wrapped to a new line. If a non-indented line begins with a character other than a number sign (#) or a FEATURE or INCREMENT keyword, it is likely that an extra-long line has been incorrectly wrapped and that the segment belongs at the end of the previous line. Make sure that you review your license key for these errors. If the key does contain an error, the software will not be licensed.

     

  7. Save the license file. Click Next to save the license file in the directory where you have installed the software. The licensing wizard recognizes the installation location and generates an appropriate path: RSI-DIR\license\license.dat.
  8.  


    Note
    If you receive a message that there is an existing license file, save the existing file under a different name before proceeding. While the new license usually contains information for all currently licensed products, save the old file as a safeguard against destroying license information. Run the license wizard again to save the new license file in the default location.

     

  9. Exit the licensing wizard. Click Finish to save the license file.
  10.  


    Note
    If you need to save the license file in a directory other than the default RSI-DIR\license\license.dat, you must set an environment variable pointing to the license.dat file before starting the software or the license manager. See Saving the License File in an Alternative Location for instructions.

     


    Note
    If you encounter a problem, see Node-Locked Licenses (Windows) for troubleshooting information.

Floating Licensing

With a floating or server-based node-locked license, you need to start the license server before RSI products can access a network license and run in licensed mode. You can also set up your system so that the license manager is automatically started when your system is booted.

The license manager needs to be started only on the designated license server machine, not on separate license client machines accessing the IDL licenses from the network. However, client machines do need to be set up to access the RSI software and licensing.

1. Install the License Server

The license server is a custom install option in the software product installation for Windows. You must install the license server on the Windows 2000 or XP machine that will be the license server machine.


Note
Carefully consider the machine you have chosen as your license server machine before saving your license file and starting the license manager. Since "client" machines will be sending requests for licenses to the "server" machine, the ability of client machines to access the license manager software depends on the reliability of the server machine and the network connection to that machine. Therefore, the machine chosen as the server must be one that has a history of reliable operation and one that is running most of the time.

If you are installing the license server on the same machine with IDL, check the Network License Server option during your software installation.

If you are installing the license server on a different machine, or if the network license server was not installed during your software installation, you can install it by running setup.exe from the RSI\FlexLM directory on the IDL CD-ROM.


Note
After installing the license server files, you will still need to configure and start the license server as described later in this section.

2. Save the License File

Your license key will be sent to you via email or fax. If you have not received your license key, see Requesting a License.

If your license key arrived via email, you can save the email message to a file so that the licensing wizard can import it. If your information was faxed to you or you prefer to enter the text directly into the licensing wizard, continue with the next section.

To save the license key to a file:

  1. From your email application, save the license key email anywhere on your system as a text-only file.
  2.  

  3. With a plain text editor such as Notepad, remove any lines that appear before and after the actual license information, keeping the comment lines that begin with the "#" character.
  4.  

  5. Either save the text file or copy the edited license information text to the Windows clipboard. For an example of a license key, see Floating License.

3. Enter the License Key

To enter your license key:

  1. Start the IDL Licensing Wizard. On your designated license server machine, click the Windows Start button, and select Programs  RSI IDL 6.2  License.
  2.  

  3. Display the Permanent Licensing dialog. Select Permanent and then License from the licensing wizard dialogs
  4.  

  5. Enter your license file. Paste the text of the license key into the dialog, or select Browse to select the license file that you have saved on the designated license server machine. If you paste in your license key, remove any header lines that are included in the file but keep the comment lines that begin with the "#" character. If you have received your license key via fax or other hardcopy method, type the information directly into the text window.
  6.  


    Note
    The license key consists of non-indented lines, indented lines, and blank lines. Besides the comment lines (lines beginning with the number sign (#)), non-indented lines should begin with a keyword such as SERVER, DAEMON, FEATURE, or INCREMENT. Because of email/fax limitations, extra long lines of the license key might have been inadvertently wrapped to a new line. If a non-indented line begins with a character other than a number sign (#), or a word other than a keyword (SERVER, DAEMON, FEATURE, INCREMENT, etc.), it is likely that an extra-long line has been incorrectly wrapped and that the segment belongs at the end of the previous line. Make sure that you review your license key for these possible errors. If such an error is not corrected, the software will not be licensed.

     

  7. Save the license file. Click Next to save the license file in the directory where you have installed the software. The licensing wizard recognizes the installation location and generates an appropriate path: RSI-DIR\license\license.dat.
  8.  


    Note
    If you receive a message that there is an existing license file, save the existing file under a different name before proceeding. While the new license usually contains information for all currently licensed products, save the old file as a safeguard against destroying license information.

     

  9. Exit the licensing wizard. Click Finish to save the license file.
  10.  


    Note
    If you need to save the license file in a directory other than the default RSI-DIR\license\license.dat, you must set an environment variable pointing to the license.dat file before starting the license manager. See Saving the License File in an Alternative Location for instructions.

     


    Note
    If you have other software that is using the Macrovision FLEXlm license manager, you might want to combine the RSI license file with the existing ones. See Multiple Applications Using the Same License Server for options and instructions.

4. Configure the License Server

After entering and saving the license file, you must start the license server on your server machine. Included with your installation is a graphical interface for configuring the license manager, the LMTools utility. With this utility, you can configure, start, stop, and monitor the license manager.

  1. Open LMTOOLS. Click Start  Programs  RSI IDL 6.2  Network License Server  LMTools. The LMTools dialog appears.
  2.  

  3. Check for existing license managers. The license server installation created a service named RSI Flexlm License Server. On the LMTools dialog's Service/License tab, select Configuration using Services, and click the Config Services tab. If more than one service is listed, the potential exists for conflict between the license manager services. See Multiple Applications Using the Same License Server for options and instructions.
  4.  


    Note
    If you are upgrading the license server from a previous installation, see Upgrading the Network License Server from a Previous Installation.

     

  5. Change configuration options if desired. You can change certain options on the Config Services tab by doing the following:
    • Specify a path and a filename for the FlexLM licensing log file and click Open. (You can use the View Log... button to view the contents of the log or the Close Log button to stop logging contents to this file.)
    •  

    • Click to select Use Services, and click to select Start Server at Power Up.

     

  6. Save any configuration changes. Click Save Service and answer Yes to save your configuration.

5. Start the License Manager

You can start the license manager from the LMTools utility.

  1. Select Start  Programs  RSI IDL 6.2  Network License Server  LMTools. The LMTools dialog appears.
  2.  

  3. Click the Start/Stop/Reread tab.
  4.  

  5. Make sure the name of your service is highlighted, and click Start Server.
  6.  


    Note
    If you receive a message that the service is already started, click Stop Server to stop it and then click Start Server to restart it with the new licensing configuration.

     

  7. Click the window's close button exit the LMTools utility.

For more information on license-manager utilities, see Working with the License Server.

6. Configure Clients to Access the License Server

To allow network access to a license manager installed on a server, the license client machines must set up the client environment to use the license server or have access to a copy of the license file used by the license manager. RSI recommends having a local installation of your RSI product on each client machine and setting the client environment to use the license server. See the following instructions for your platform: Windows 2000 or Windows XP.

Windows 2000

Complete the following steps for each client machine:

  1. Select Start  Settings  Control Panel and double-click the System icon.
  2.  

  3. Click the Advanced tab and then click Environment Variables. Click the New button below the System Variables box and enter the following in the New System Variable dialog:
    1. In the Variable Name field, type LM_LICENSE_FILE in uppercase letters.
    2.  

    3. 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 SERVER.
    4.  


      Note
      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:\license\mylicense.dat;1700@hal

     

  4. Save the settings by clicking OK, OK, and OK.

Alternatively, you can place a copy of the server's license.dat file in the \rsi\license directory on your client machine. If this directory does not exist, you need to create it (e.g., as C:\rsi\license).

Windows XP

Complete the following steps for each client machine:

  1. Access the System Control Panel. Select Start  Control Panel, select the Performance and Maintenance category, and select the System icon.
  2.  

  3. Select the Advanced tab, and click the Environment Variables button.
  4.  

  5. Enter a new system variable. Click the New button below the System Variables list and enter the following information:
    1. In the Variable Name field, enter LM_LICENSE_FILE.
    2.  

    3. 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 SERVER.
    4.  


      Note
      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:\license\mylicense.dat;1700@hal

     

  6. Save the settings by clicking OK, OK, and OK.

Alternatively, you can place a copy of the server's license.dat file in the \rsi\license directory on your client machine. If this directory does not exist, you need to create it (e.g., as C:\rsi\license).

Customizing Floating Licenses

For information on customizing floating licenses, see Customizing Your Floating Licenses.

Working with the License Server

A license server support utility, LMTools, is provided to control the operation of the license server. For information on setting up the license manager, see Configure the License Server.

Starting and Stopping the License Manager

With the LMTools utility, you can easily start, stop and see the status of the license manager. To open the LMTools utility, select Start  Programs  RSI IDL 6.2  Network License Server  LMTools. The LMTools dialog appears.

Removing the License Manager Service

To remove the license manager service, open the LMTools utility by selecting Start  Programs  RSI IDL 6.2  Network License Server  LMTools. Select the name of the license manager service on the Config Services tab and click Remove Service.


Note
This command removes the license manager service and should not be used to stop the service. To stop the service, see Starting and Stopping the License Manager.

Reclaiming an Unused License

If a licensed user is running IDL when the machine crashes, that user's license might fail to return to the server. In this case, the license is not available to other users. The lmremove command lets the system administrator remove a single user's license for a specified feature and return the license to the pool of available licenses.


Note
The lmremove command does not permanently free licenses from IDL sessions that are currently active or in an idle state.

To free the license:

  1. Find the lmutil program. Open a DOS-based Command Prompt window from the server machine and change the directory to access the license manager utility by typing the following at the prompt:
  2.  

    cd RSI-DIR\Flexlm

     

    Enter lmutil at the prompt to access the utility program. A list of possible commands is displayed.

     

  3. Gather the information necessary to remove the license. Review the license manager status by entering the following at the command prompt:
  4. lmutil lmstat -c RSI-DIR\license\license.dat -a  
    

     

    This command displays available licenses and which users have licenses checked out. An example of lmstat -a output follows:

    robin hal7 josh (v6.2) (hal7/1700/395), start Mon 10/12 4:34, 
    # licenses  
    

     

    The format of this line is:

    user host display (version) (host/port/license handle), 
    start_date, available_licenses   
    

     

    Note the user, host, and display values.

     

  5. Remove the unused license. Use the following to remove a license:
  6. lmutil lmremove -c RSI-DIR\license\license.dat feature user 
    host display  
    

     

    For example (enter this command as one line):

    lmutil lmremove -c C:\RSI\license\license.dat idl robin hal7 
    josh  
    

     

    where idl is the feature, robin is the user, hal7 is the host, and josh is the display. Other feature values for RSI products appear in Table 2-2.

     

    Table 2-2: Feature Values for lmremove 

    Table 2-2: Feature Values for lmremove 
    RSI Software Product
    Feature Value
    IDL
    idl
    IDL Runtime
    idl_rt
    IDL Student
    idl_student<version>
    IDL with the Wavelet Toolkit
    idl_wavelet
    IDL DataMiner
    idl_dm
    IDL GIF
    idl_gif
    IDL MPEG
    idl_mpeg
    IDL TIFF LZW
    idl_tifflzw
    IDLffDicomEx
    idl_dicomex_rw
    Right to Distribute
    devkit
    ENVI
    envi, envi_flash, envi_nitf
    ION Script
    ion_script
    ION Java
    ion_java
    RiverTools
    idl_rivertools
    Noesys
    noesys, noesysplus
    VIP
    vip

     

  7. Verify that the license has been removed. You can check to make sure the license was freed by typing the following at the DOS command prompt:
  8. lmutil lmstat -c RSI-DIR\license\license.dat -a   
    

     

    The license you removed should no longer appear in the list of licenses checked out.

If the license manager gives an error message when starting, see License Manager Startup.

Multiple Applications Using the Same License Server

IDL's network license server facility is provided by the FLEXible License Manager (FLEXlm), a product of Macrovision Software. Since this license manager is not unique to IDL, the possibility exists that you need to run software from two or more software vendors that all use FLEXlm. In this case, the potential for license server conflict exists. You have the following options if all products using FLEXlm are installed on the same license server:

Combining License Files

If an RSI product and other vendor products also using FLEXlm will all be using the same license server machine to administer licenses, and if all of the vendor license files are compatible, you can combine the license files in a single license file.

Different FLEXlm vendor licenses are compatible for combination if the LMHostid value on the SERVER line for each file is exactly the same. For example, if the SERVER line in two different vendor license files are the following:

SERVER server1.acme.com 12345678 1700  

and

SERVER server1 12345678 1800  

you can combine the licenses into a single license file using either of the SERVER lines above, because the third item is the same in both (12345678).


Note
Manually combining the information from multiple separated RSI license.dat files that contain a SERVER line will invalidate the license and prevent the license manager from running. The newest version of an RSI product license file will normally work with previous versions of the supported products.

After shutting down the license servers, use a text editor to create a single license file. In this single license file, combine all license files by taking the SERVER lines from any one license file and adding all the DAEMON, FEATURE, FEATURESET, and INCREMENT lines from all of the license files.

Multiple copies of this combined license file can be placed in the locations required by the various software vendors. Alternatively, a single copy of the license file can be located in any convenient location, in which case each client machine must set the LM_LICENSE_FILE environment variable to point to it. For more information, see Configure Clients to Access the License Server.

When you have finished editing the license file and saved it in the appropriate locations, restart the license manager with the most recent version of lmgrd that you have installed. To determine the version of lmgrd.exe:

  1. Launch a MS-DOS command prompt.
  2.  

  3. Change directory (use the cd command) to RSI-DIR\Flexlm, where RSI-DIR is the main installation directory.
  4.  

  5. Enter the following command at the prompt:
  6. lmgrd -version  
    

If an older version of lmgrd is used, the license manager from the product with a more recent lmgrd will not operate correctly.


Note
Changes to an altered license file will not take effect until the license server program is restarted using that license file.

Configuring Unique FLEXlm License Manager Services on the Same Server

As an alternative to combining the license information from multiple vendors licenses and running a single instance of the FLEXlm license manager service, a separate instance of the FLEXlm license manager service (with a unique name) can be installed and started for each separate vendor's license file.

Using separate instances of the FLEXlm license manager service with separate vendor licenses requires administering multiple services and license files. However, multiple license manager services and separate vendor license files let the system administrator stop and start FLEXlm services freely for particular vendors without regard for other vendors' FLEXlm services running on that same system.


Warning
Be certain that only one instance of the FLEXlm license manager will start on the server machine with respect to any RSI product license file. If an instance of FLEXlm license manager service is already running for an RSI product on this same license server machine, installing a second instance of the FLEXlm service for an RSI product under a different name can cause a conflict when Windows is loaded. (To resolve such a conflict, quickly stop all but one of the conflicting FLEXlm services immediately after logging on to that Windows license server machine.)

After verifying that there is not already an RSI product-configured license manager service running on your server machine, you can configure a uniquely named instance of the license manager service for RSI products to avoid conflict with other vendors' license managers. To install a unique instance of the FLEXlm license manager for an RSI product license file:

  1. Confirm that your updated RSI product license is already properly installed on the license server machine.
  2.  

  3. Select Start  Programs  RSI IDL 6.2  Network License Server  LMTools. The LMTools dialog appears.
  4.  

  5. Select the Config Services tab and enter a new (unique) FLEXlm service name in the Service Name field. By default, the FLEXlm license manager service is called "FLEXlm License Manager." If the name "FLEXlm License Manager" is configured and already being used for another vendor's product license file, we recommend using the name "RSI FLEXlm License Manager" instead.
  6.  

  7. Enter the paths to the RSI product's lmgrd.exe (located in RSI-DIR\FlexLM) and license.dat (located in RSI-DIR\license) files. If not already created, the Debug Log File, typically saved in the license directory, will be created when the license manager is started. The Browse buttons can help to ensure that the file path entered is valid.
  8.  

  9. Select the Use Services and the Start Server at Power-Up check boxes.
  10.  

  11. Start the newly named license manager. Select the Start/Stop/Reread tab, select the name of the updated service, and start the service by clicking the Start Server button.
  12.  

  13. Click the window's close button to exit the LMTools utility.
  14.  


    Note
    If you encounter any problem, see Licenses Requiring a License Server or License Manager Startup for troubleshooting information.

Saving the License File in an Alternative Location

RSI strongly recommends saving your license file with the default path and filename: RSI-DIR\license\license.dat, where RSI-DIR is the directory in which your RSI product is installed. If you put your license file in this directory, you do not have to redefine any environment variables.

If you choose a location other than RSI-DIR\license\license.dat for the license file, it must be accessible to RSI software products that you have installed on your machine.

Therefore, you must define the environment variable LM_LICENSE_FILE to point to the actual path of the license file prior to using your software. For example, if you save your license file as C:\RSI\mylicensefiles\license.dat, RSI products will not run properly until you define the LM_LICENSE_FILE variable.


Note
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:\license\mylicense.dat;1700@hal

Windows 2000

  1. Click Start  Settings  Control Panel and double-click on the System icon.
  2.  

  3. Click the Advanced tab, and then click Environment Variables. Click the New button below the System Variables box and enter the following in the New System Variable dialog:
    1. Type, in uppercase letters, LM_LICENSE_FILE in the Variable Name field.
    2.  

    3. Type the path to the license file in the Variable Value field: in this example, C:\RSI\mylicensefiles\license.dat. Replace this value with the actual path to your license file.

     

  4. Click OK, OK, and OK.

Windows XP

  1. Access the System Control Panel. Click Start  Control Panel, select the Performance and Maintenance category, and select the System icon.
  2.  

  3. Select the Advanced tab, and click the Environment Variables button.
  4.  

  5. Enter a new system variable. Click the New button below the System Variables list.
    1. In the Variable Name field, type LM_LICENSE_FILE.
    2.  

    3. In the Variable Value field, type the path to the license file. For example:
    4. C:\RSI\mylicensefiles\license.dat  
      

     

  6. Click OK, OK, and OK.

Upgrading the Network License Server from a Previous Installation

When the RSI network license server is installed on Windows, in addition to installing the license server files (IDL 6.2 uses FLEXlm version 9.2), the installer automatically configures an NT service named RSI FLEXlm License Manager, using default file settings. The installed license manager service is not configured to automatically start at boot time. (For instructions on how to configure the RSI FLEXlm License Manager service to start at boot time, see Configure the License Server.)


Note
If a previously configured RSI license manager service with a different name (e.g., FLEXlm License Manager) is running on the same server machine that will be administering your IDL 6.2 license file, RSI recommends that you stop, and then disable or remove, the previously configured RSI license manager service to avoid a potential system conflict that would be caused by simultaneously running two RSI license manager services on one machine. Additionally, using the IDL 6.2 default RSI FLEXlm License Manager configuration as your RSI license manager service will make it easier to update the RSI license manager service for future releases of RSI products.

To manually stop and remove the old RSI license manager service, do the following:

  1. Launch the LMTools utility by selecting Start Programs RSI IDL 6.2 Network License Server LMTools.
  2.  

  3. Select the Config Services tab.
  4.  

  5. From the Service Name pull-down list, select the older RSI license manager service name that you would like to remove (e.g., FLEXlm License Manager).
  6.  


    Note
    The operational status of configured NT services can be identified within the Services control panel utility. If the Status field reads "Started," then the service is currently running.

     


    Note
    If the machine is serving licenses for other products that use the FLEXlm license manager service, and you are unsure which is the unneeded RSI license manager service, contact your system or network administrator for assistance.

     

  7. Select the Stop/Start/Reread tab. Notice that the selected license manager service is highlighted.
  8.  

  9. Click Stop Server to stop the service. If the selected service is not currently running, then clicking Stop Server displays a Status field message that verifies that LMTools is unable to stop the selected service (e.g., "Unable to Stop Server").
  10.  

  11. After stopping the service, return to the Config Services tab and click Remove to complete the removal of the old RSI license manager service.

  IDL Online Help (June 16, 2005)