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
- Stop the Gerrit server.
- Go to the folder location where you installed the adapter.
For example, JazzInstallDir/server/conf/gitAdapter
- Find the gerritAdditions-yyyymmdd-hhmm.zip file.
- 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.
- 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
- Start the Gerrit server.
Results
The adapter's Gerrit additions are deployed to the Gerrit
server.

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