Changing your license usage order on Linux and UNIX systems

The License_Map file is a text file that defines license usage order.
About this task

A default License_Map file is created and stored in the config subdirectory when you install an IBM Rational Suite® product. The License_Map file name can be product specific. For example, IBM Rational® PurifyPlus™ for Linux® and UNIX® systems uses the name PurifyPlus_License_Map.

The file is initially set to claim a suite license for all products. It contains lines of the following format:

component_designator product_designator {, product_designator}

For example, the initial setting in the License_Map file for IBM Rational ClearQuest® should be similar to this:

ClearQuest:1.0 DevelopmentStudioUNIX:1.0, standalone

This line tells a Rational ClearQuest license client to first request a IBM Rational Suite DevelopmentStudio license. If a Rational Suite DevelopmentStudio license is unavailable, the client will request a standalone Rational ClearQuest license. Depending on the suite product you install, the line you see might differ from the previous example.

You can modify the settings to customize license usage for all users or for individual users.

To change the license usage order on your client:
  1. Use the user setup script (such as rs_setup.csh or rs_setup.ksh) to verify that the environment variable RSU_LICENSE_MAP is set.

    This environment variable is used to find the location of the correct License_Map file. If the environment variable is not set, the setup script sets the pathname to the default license map file, for example, config/License_Map.

  2. In the License_Map file, edit the license usage order.
  3. Save your changes and close the file.

Reminder: The license_setup command creates the License_Map file when configured properly. However, you can create a License_Map file from scratch using a text file. The file name should match this wild card: *License_Map*.

For more information about the license_setup script, see Configuring a UNIX system license server.


Feedback