The Gerrit projects must be registered with the Rational® Adapter for Git.
Before you begin
Make sure that you have registered the Gerrit server to make
it known to the Rational Adapter
for Git so that it can be recognized by Gerrit projects.
Restriction: Check that your project name does not contain special
characters other than a forward slash. Other special characters might
not resolve correctly when the project is registered and the project
URL is assigned. For example, when the Gerrit project name is robin+new.git the
resolved URL for the project is robin%2Bnew.git.
Rename any projects that contain characters other than a forward slash before you
register the project.
About this task
Registering a Gerrit project makes the project known to the
Change and Configuration Management project and enables the Gerrit
features of the Rational Adapter
for Git. For this step you must be logged in as a Rational Team Concert™ user
with administrator or project administrator privileges. Repeat this
step for each project you want to register.
Procedure
- Point your web browser to the Gerrit home page; for example http://our.gerrit.server/gerrit
The Rational Adapter
for Git banner shows. This is one of the Gerrit additions that you
deployed to the Gerrit server.

- From the Gerrit home page, navigate to a list of changes
for a project that you want to register.
Warning: Project names can contain a forward slash. Other special
characters might not display correctly in the resolved project URL.
Rename the project before you register it.
- Click the Admin (Administration) icon in the top right
portion of the banner and then click Register This Project.
.gif)
The Register Git Project opens in a new web browser
window.

- Confirm that the name of the project is prefilled to the
project name that you navigated to.
- Optional: Add a summary.
- Associate the project with a Rational Team Concert project.
- Click Add.
- In the Associate Rational Team Concert Projects window,
select the check box next to the Rational Team Concert project or
projects that you want to associate this Gerrit project with.
.gif)
- Click Associate Projects.
Gerrit.gif)
- Click Register.
- The Gerrit project is registered with the adapter. Check
that the project name and resolved project URL match. If the project
name and resolved project URL do not match, rename the project and
repeat the steps to register the project. If the project name and
resolved project URL do match, further instructions direct you to
set up links when commits are pushed to a Gerrit project. Record the
Gerrit project URL. You need the Gerrit project URL to install and
configure the receive hook for the project.
Gerrit.gif)
Results
You have registered the Gerrit project with the Rational Adapter for Git. Registering the
Gerrit project completes the configuration of the Gerrit server to
work with Rational Adapter
for Git.
What to do next
Configure the Gerrit receive hook for the Gerrit project,
see
Deploying the Gerrit receive hook.