Setting up processor value unit licensing

If you are using PVU licensing for the Git adapter, some setup is required, which includes copying license files to each endpoint system of an adapter session.

Processor Value Unit (PVU) licensing is one method of licensing software that is used by the adapter. For more information about PVU licensing, see Processor Value Unit [PVU] licensing for Distributed Software.

Before you begin

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

About this task

You copy a license file to each endpoint system that is the origin or destination of an adapter session. For example, the endpoints for adapter software can be one or more of the following locations:
  • One or more Change and Configuration Management application servers that the adapter communicates with
  • One or more Gitweb and Gerrit servers that the adapter communicates with
During the installation process, the license files are copied to the Jazz™ Team Server, where you installed the adapter application.

Procedure

  1. Change to the JazzInstallDir/properties/version directory.
  2. If you installed the 1.1 adapter software, copy the license file named IBM_Rational_Lifecycle_Integration_Adapters_Standard_Edition__3rd-party_systems_-1.1.0.swtag from the directory JazzInstallDir/properties/version to the directory properties/version for these locations:
    • Each Change and Configuration Management application server that the adapter communicates with, for example, JazzInstallDir/properties/version.
    • Each Gitweb and Gerrit server that the adapter communicates with. For each Gitweb and Gerrit server, you must create a directory properties/version in the root of the Gitweb and Gerrit products to copy the license file in to.
  3. If you installed the 1.1.0.1 adapter software, copy the license file named IBM_Rational_Lifecycle_Integration_Adapters_Standard_Edition__3rd-party_systems_1.1.0.1-1.1.0.1.fxtag from the directory JazzInstallDir/properties/version to the directory properties/version for these locations:
    • Each Change and Configuration Management application server that the adapter communicates with, for example, JazzInstallDir/properties/version.
    • Each Gitweb and Gerrit server that the adapter communicates with. For each Gitweb and Gerrit server, you must create a directory properties/version in the root of the Gitweb and Gerrit products to copy the license file in to.
  4. If you installed the 1.1.1 adapter software, copy the license file named IBM_Rational_Lifecycle_Integrations_Adapters_Standard_Edition__3rd_party_systems_-1.1.1.swtag from the directory JazzInstallDir/properties/version to the directory properties/version for these locations:
    • Each Change and Configuration Management application server that the adapter communicates with, for example, JazzInstallDir/properties/version.
    • Each Gitweb and Gerrit server that the adapter communicates with. For each Gitweb and Gerrit server, you must create a directory properties/version in the root of the Gitweb and Gerrit products to copy the license file in to.
  5. If you installed the 1.1.1.1 adapter software, copy the license file named IBM_Rational_Lifecycle_Integration_Adapters_Standard_Edition__3rd-party_systems_1.1.1.1-1.1.1.1.fxtag from the directory JazzInstallDir/properties/version to the directory properties/version for these locations:
    • Each Change and Configuration Management application server that the adapter communicates with, for example, JazzInstallDir/properties/version.
    • Each Gitweb and Gerrit server that the adapter communicates with. For each Gitweb and Gerrit server, you must create a directory properties/version in the root of the Gitweb and Gerrit products to copy the license file in to.
    License files for 1.1, 1.1.0.1, 1.1.1, and 1.1.1.1 show in the location mentioned in the previous steps.
  6. If you installed the adapter into an instance of Jazz Team Server that does not have a Change and Configuration Management application server, then you must delete the following license files from the directory JazzInstallDir/properties/version:
    • IBM_Rational_Lifecycle_Integration_Adapters_Standard_Edition__3rd-party_systems_-1.1.0.swtag
    • IBM_Rational_Lifecycle_Integration_Adapters_Standard_Edition__3rd-party_systems_1.1.0.1-1.1.0.1.fxtag
    • IBM_Rational_Lifecycle_Integrations_Adapters_Standard_Edition__3rd_party_systems_-1.1.1.swtag
    • IBM_Rational_Lifecycle_Integration_Adapters_Standard_Edition__3rd-party_systems_1.1.1.1-1.1.1.1.fxtag
    Tips:
    • To delete the IBM_Rational_Lifecycle_Integration_Adapters_Standard_Edition__3rd-party_systems_1.1.0.1-1.1.0.1.fxtag license file, you must have installed the 1.1.0.1 adapter software mentioned in step 3.
    • To delete the IBM_Rational_Lifecycle_Integration_Adapters_Standard_Edition__3rd-party_systems_1.1.1.1-1.1.1.1.fxtag license file, you must have installed the 1.1.0.1 adapter software mentioned in step 5.

Results

Processor value unit licensing is set up on each endpoint system that is the origin or destination of an adapter session.

What to do next

Set up Gitweb, see Setting up Gitweb.

Feedback