Set up the Rational® Common
Licensing token service key on a Jazz™ Team Server.
Before you begin
Verify the following items:
- You have installed IBM® Rational License Key Server
8.1.4. See the Rational Common
Licensing product documentation for instructions on how to
install this product.
- You have administrative access to Jazz Team Server.
- You have the license.dat and JazzTokens.zip files
that you downloaded from the Rational License
Key Center.
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
- Configure Rational License
Key Server 8.1.4:
- Launch the License Key Administrator.
- Download the license.dat file that
contains tokens from the License Key Center.
- In the License Key Administrator, click .
- Select the license.dat file.
- Stop and restart the License Key Server. You will be
prompted to do this after importing the license.dat file.
- Close the License Key Administrator.
- Install the token client access licenses on your Jazz Team Server:
- 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.
- On the Administration page, click
the Server tab.
- In the left pane, in the Licensing section, click License
Key management.
- Scroll down to the Floating License Server section.
- In the Floating License Server section, click Add.
- In the Upload License Files window, click Browse and
select the JazzTokens.zip file.
- 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.
- Enable the token license service on your Jazz Team Server:
- In the Floating License Server section, click the radio
button next to IBM Rational Common Licensing Token
Service to enable the service.
- Hover over IBM Rational Common Licensing Token
Service until you see the
icon in the Actions column.
Click the icon to view the server configuration dialog.
- Configure the following two properties in the dialog:
- 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 to display identification information for the server.
You can also run the LMTOOLS program (located at License_Key_Server_install_directory/common)
and click to verify the connection
information).
- Token Lease Timeout: Specify how long (in milliseconds)
a user can be inactive before the token lease expires.
- Click Finish. If the
connection succeeds, you'll see a green checkmark in the Status
column.
- Optional: Configure other Jazz Team Servers
to point to the floating license server:
- On the Administration page of the Jazz Team Server,
click the Server tab.
- In the Licensing pane, click License
Key Management.
- In the Floating License Server section,
hover over a row and click the
icon.
- 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.
- To test the server connection, click Test
Connection.
- 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.