IBM Support

How to point a Rational Change server to multiple license servers

Technote (FAQ)


How do you point IBM Rational Change server to get licenses from more than one License server?


Unlike other Rational (Telelogic) products, Rational Synergy and Rational Change do not follow the TELELOGIC_LICENSE_FILE environment variable rule, when it comes to pointing to different/multiple license servers.


Usually all the Telelogic client applications read the value that has been set onto theTELELOGIC_LICENSE_FILE environment variable, that has been set locally, to pull out licenses from the specified hosts. Rational Change is slightly different.

  • Rational Change 4.7 and previous: Change used to pick up licenses via Rational Synergy, hence the content of license_data.txt in the synergy installation area decides where does the Change server pick up licenses from.
  • Rational Change 5.0 and later: Change no longer requires the Rational Synergy backend to get licenses, hence the Rational Change admin would have to up update the license_data.txt file in the following directory: <CS_HOME>5.x\jetty\webapps\<instance_name>\WEB-INF\wsconfig

The content of the license_data.txt should have the following format as appropriate:
  • For Microsoft Windows servers:
  • For UNIX and Linux servers:

Note: The difference between the two environments is the delimiter: Microsoft Windows uses a semicolon ";" as the delimiter, while UNIX requires a colon ":".

Related information

Pointing an IBM Rational Synergy server to get licenses

Document information

More support for: Rational Change

Software version: 4.6, 4.6.1, 4.7, 5.0, 5.1, 5.2,,,,,,,,, 5.3,,,,,,, 5.3.1,

Operating system(s): Linux, Solaris, Windows

Reference #: 1423404

Modified date: 10 July 2014