Deploying Gerrit additions

With these additions, you can create links between changes and Rational Team Concert™ work items and view and traverse existing links.

Before you begin

Previous post-installation tasks are complete.

About this task

Do these steps for each Gerrit server that you want to integrate with the adapter.

Procedure

  1. Stop the Gerrit server.
  2. Go to the folder location where you installed the adapter.

    For example, JazzInstallDir/server/conf/gitAdapter

  3. Find the gerritAdditions-yyyymmdd-hhmm.zip file.
  4. Uncompress the gerritAdditions-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.html), a custom style sheet (etc/GerrittSite.css) or both, you must merge or replace these files with the ones provided.
    Extracting the compressed file adds several files to the ./static folder. GerritSiteHeader.html and GerritSite.css are added to gerrit_install_root/etc.
  5. To add the Gerrit additions to the Gerrit server, from the ./static folder, run gerrit_setup.sh with the -i command.

    The -i command performs the initial configuration of the Gerrit additions. The parameter --adapter_url is the root URL to the Rational® Adapter for Git. For more information about this parameter, see gerrit_setup.sh in the static folder of the Gitweb server directory.

    Tip: You can run the gerrit_setup.sh script without defining a command and its parameters. The gerrit_setup.sh script when first run, prompts you for the command, either -i to deploy the Gerrit additions, -r to register the Gerrit server, or --hook to deploy the receive hook for Gerrit. When you run the script with the command, for example, gerrit_setup.sh -r, the script prompts you for the required parameters.
    ./static/gerrit_setup.sh -i --adapter_url https://your.git.adapter.server.com:9443/gitAdapter  
  6. Start the Gerrit server.

Results

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

Gerrit home with additions

What to do next

Register Gerrit servers to work with the adapter, see Registering Gerrit servers.

Feedback