Setting up the Rational Common Licensing token service keys

Set up the Rational® Common Licensing token service key on a Jazz™ Team Server.

Before you begin

Verify the following items:

For more details about token licensing, contact your local IBM marketing representative.

Note: The Rational License Key Server does not run on IBM i, Linux for System z®, or z/OS®. If you use Rational common licensing, you can set up a separate Jazz Team Server on any other supported platform to manage your token licenses and connect to that license server from your Jazz Team Server running on IBM i, Linux for System z, or z/OS.

About this task

The Rational Common Licensing Token Service is an extension of the Jazz Team Server that allows token requests to be forwarded to a Rational License Key Server. When the Jazz Team Server requests a certain number of tokens, the extension checks out the tokens from a Rational License Key Server. This integration allows Jazz-based products and non-Jazz based products to share the same tokens.
Note: This integration is only available for IBM Rational products.

Procedure

  1. Configure Rational License Key Server 8.1.4:
    1. Launch the License Key Administrator.
    2. Download the license.dat file that contains tokens from the License Key Center.
    3. In the License Key Administrator, click License Keys > Import License Key(s).
    4. Select the license.dat file.
    5. Stop and restart the License Key Server. You will be prompted to do this after importing the license.dat file.
    6. Close the License Key Administrator.
  2. Install the token client access licenses on your Jazz Team Server:
    1. Log in to the Administration page of the Jazz Team Server. Point your web browser to https://[fully qualified hostname]:9443/jts/admin
      Remember: The [fully qualified hostname] is the host name along with the DNS domain reference of the machine on which the Jazz Team Server is installed.
    2. On the Administration page, click the Server tab.
    3. In the left pane, in the Licensing section, click License Key management.
    4. Scroll down to the Floating License Server section.
    5. In the Floating License Server section, click Add.
    6. In the Upload License Files window, click Browse and select the JazzTokens.zip file.
    7. Click Finish. You will have to accept the license agreement for each license that you upload. After the license keys have been uploaded, you will see the licenses listed under the Floating License Server section.
  3. Enable the token license service on your Jazz Team Server:
    1. In the Floating License Server section, click the radio button next to IBM Rational Common Licensing Token Service to enable the service.
    2. Hover over IBM Rational Common Licensing Token Service until you see the Configure floating license server icon in the Actions column. Click the icon to view the server configuration dialog.
    3. Configure the following two properties in the dialog:
      1. IBM Rational License Key Server: Provide the URL (in the format license_key_port_number@license_key_hostname) for the IBM Rational License Key Server 8.1.4 you installed.
        Tip: In the License Key Administrator application, click License Keys > Host Data to display identification information for the server. You can also run the LMTOOLS program (located at License_Key_Server_install_directory/common) and click ver Status > Perform Status Inquiry to verify the connection information).
      2. Token Lease Timeout: Specify how long (in milliseconds) a user can be inactive before the token lease expires.
    4. Click Finish. If the connection succeeds, you'll see a green checkmark in the Status column.
  4. Optional: Configure other Jazz Team Servers to point to the floating license server:
    1. On the Administration page of the Jazz Team Server, click the Server tab.
    2. In the Licensing pane, click License Key Management.
    3. In the Floating License Server section, hover over a row and click the Configure floating license server icon.
    4. In the Configure Floating License Server dialog box, in the Floating License Server field, type the path to the server. For example, http://floating-license-server:9080/jts, where floating-license-server must be replaced with the fully qualified host name of your server.
    5. To test the server connection, click Test Connection.
    6. Click Finish. The Jazz Team Server is now configured so that floating CALs can be assigned to users. The floating CALs are automatically checked out from the floating license server when users require them.

What to do next

For users to participate in the pool of Token licenses, you must assign users one of the Token license types.


Feedback