Understanding licensing for Rational Synergy

This topic contains information specific to Rational® Synergy licensing.

Rational Synergy is licensed using IBM® Rational Common Licensing. For information about Rational Common Licensing, see IBM Knowledge Center for Rational Common Licensing.

License types

Rational Synergy supports the Floating, Named-User Floating, and Token license types. For a description of license types, see “License type definitions” in IBM Knowledge Center for Rational Common Licensing.

For Rational Synergy users, the login name is seen as the user of the token license. To reserve Named-User licenses for specific users, see “Setting up the options file” in IBM Knowledge Center for Rational Common Licensing.

When configuring the options file for Rational Synergy and Rational Change, it is not necessary to put the default administrative users (ccm_root, ChangeAdmin, and csuser) in the INCLUDE list. The license file includes additional floating licenses for these users. Do not assign these licenses to other users because the products might fail.

How licensing works with Rational Synergy

When you start Rational Synergy, it contacts the License Manager to request a license. Rational Synergy uses information that was provided during the server installation process to find the License Manager. The following example describes how licenses are configured during installation. The example assumes IBM Rational Common Licensing was installed before installing Rational Synergy.

The $CCM_HOME/etc/system_info.txt file or TELELOGIC_LICENSE_FILE or LM_LICENSE_FILE system environment variable stores the location of the license server. The location is specified as port@license-server-name, that is, the port and computer on which the license manager is installed.

The location can also contain a comma-separated list of three port@host specifiers denoting a three-server redundant configuration. For example, port1@host1,port2@host2,port3@host3 specifies a three-server redundant configuration with servers on host1, host2, and host3.

Rational Synergy searches for license servers and license files in the following order:

  1. The environment variable TELELOGIC_LICENSE_FILE.
  2. The registry entry for TELELOGIC_LICENSE_FILE.
  3. The environment variable LM_LICENSE_FILE.
  4. The registry entry for LM_LICENSE_FILE.
  5. The location specified by the contents of $CCM_HOME/etc/system_info.txt.

If you move the license manager to a different system, you must edit the $CCM_HOME/etc/system_info.txt file or update the TELELOGIC_LICENSE_FILE or LM_LICENSE_FILE system environment variable to contain the new value.


Feedback