IBM Support

How to point a Rational Change server to multiple license servers

Question & Answer


Question

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

Cause

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.

Answer

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:
    <port#>@<license_server1>;<port#>@<license_server2>
  • For UNIX and Linux servers:
    <port#>@<license_server1>:<port#>@<license_server2>

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

[{"Product":{"code":"SSYQQ2","label":"Rational Change"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Licensing","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"4.6;4.6.1;4.7;5.0;5.1;5.2;5.2.0.1;5.2.0.2;5.2.0.3;5.2.0.4;5.2.0.5;5.2.0.6;5.2.0.7;5.2.0.8;5.3;5.3.0.1;5.3.0.2;5.3.0.3;5.3.0.4;5.3.0.5;5.3.0.6;5.3.1;5.3.1.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
16 June 2018

UID

swg21423404