Deploying Gerrit additions

These additions support the creation of links between commits and Rational Team Concert™ work items as well as enabling you to see and traverse existing links.

Before you begin

Prior configuration tasks about registering the Jazz™ Team Server and requesting and approving friend servers from the Rational® Adapter for Git to the Change and Configuration Management server are complete.

About this task

Perform these steps for each Gerrit server that you want to integrate with the Rational Adapter for Git.

Procedure

  1. Stop the Gerrit server.
  2. Go to the folder location where you installed Rational Adapter for Git. For example, JazzTeamServerDir/server/conf/gitAdapter
  3. Find the gerrit-yyyymmdd-hhmm.zip file.
  4. Uncompress the gerrit-yyyymmdd-hhmm.zip file to your Gerrit installation folder; for example /usr/share/Gerrit.
    Warning: If you are using a custom site header(etc/GerritSiteHeader), a custom style sheet (etc/GerrittSite.css) or both, you must merge or replace these files with the ones provided.
    This adds a number of files to the./static folder at that location.
  5. Edit the oslcConfig.js to assign the variable OSLC.GIT.AdaptedProjectURL to the Rational Adapter for Git URL as follows:
    OSLC.GIT.AdaptedProjectURL = "https://[fully qualified hostname]:[port]/gitAdapter";
    Important: [fully qualified hostname] is the host name where the Rational Adapter for Git application was deployed.
  6. Save the file and exit.
  7. Restart the Gerrit server.

Results

The adapter's Gerrit additions are deployed to the Gerrit server.

Gerrit home with additions

What to do next

Measure PVUs by which the adapter is licensed by setting up PVU licensing for the Rational Adapter for Git, see Setting up processor value unit pricing.

Feedback