Setting up client access licenses

If you are using Client Access Licensing with the Git adapter, you can use the License Key Management section in the Administration page of the Jazz™ Team Server to install and manage client access license (CAL) keys and to view license agreements.

Before you begin

PVU licensing is disabled in the adapter administration page. For more information about disabling PVU licensing, see Enabling or disabling processor value unit licensing.

About this task

You install a client access license for the Git adapter into the Jazz Team Server. If you did not purchase entitled license keys, install the trial CAL that is included with the Git adapter installation. You must install entitled license keys when the trial license keys expire after 60 days.

Procedure

  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 system on which the Jazz Team Server is installed.
  2. On the Administration page, click the Server tab.
  3. In the Licensing pane, click License Key Management.
  4. Upload a license key to the server:
    1. On the License Key Management page, in the Client Access License Types area, click Add.
    2. In the Upload License Files dialog, in the Upload License Activation key field, click Browse and go to the location of the activation key.

      The location of the entitled CAL is where you put your entitled license. The name of the entitled CAL is either LIA_Integrator_Unlocked.jar or LIA_Integrator_Floating_Unlocked.jar.

      The location of the trial CAL is JazzInstallDir/license/gitAdapter/LIA_Integrator_Trial.jar

    3. Select the entitled CAL activation key or the trial CAL activation key.
      Important: The activation key requires you to accept a license agreement before you upload the key. A dialog box shows the license agreement with the options to Accept or Decline the agreement. If you decline, the license key is not installed.
    4. Click Finish.
    5. The entitled CAL activation key requires that you specify the purchase count, in the Purchased field. Click Edit. Enter the number of entitled licenses. If you do not complete this field, the license is not enabled even though you purchased and installed the license.

      An entitled unlocked CAL is set up

      Skip the next step. It does not apply to an entitled license key.

  5. If you are using the trial adapter software, activate a trial license:
    1. In the Client Access License Types area, find the trial license key for the adapter, click Activate Trial.

      Activate adapter trial license

    2. In the Client Access License Agreement window, review the terms for the license and then click I accept the terms in the license agreement.
    3. Click Finish. The trial license is activated.
  6. Assign adapter licenses to your users.
    1. On the Server Administration page, click Users > Client Access License Management
    2. Select the adapter client access license key to manage. A list of users with this selected license shows.
    3. Assign this selected license to a user, click Assign Client Access Licenses. Select the user in the dialog and click Add.

      Adding a user to an entitled license

      Tip: For more information about which users require a CAL, see Adapter users.

Results

An entitled or trial CAL license is set up for the adapter. The license is assigned to one or more users. For more information about managing CALs, see Installing and managing client access license keys.

What to do next

Set up Gitweb, see Setting up Gitweb.

Feedback