The Gitweb projects must be registered with the Rational® Adapter for Git.
Before you begin
Make sure that you have registered the Gitweb server to make
it known to the Rational Adapter
for Git so that it can be recognized by Gitweb projects.
Restriction: Check that your project name does not contain special
characters other than a space or 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 Gitweb 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 space or forward slash before you register
the project.
About this task
Registering a Gitweb project makes the project known to the
Change and Configuration Management project and enables the Gitweb
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 Gitweb home page; for example http://our.git.server/git
The Rational Adapter
for Git banner shows. This is one of the Gitweb additions that you
deployed to the Gitweb server.

- From the Gitweb home page, navigate to a project page.
Warning: Project names can contain a space or
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.

The Register Git Project opens in
a new web browser window.
.gif)
- 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 Gitweb project with.
.gif)
- Click Associate Projects.
.gif)
- Click Register.
- The Gitweb 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 the links when commits are pushed to a Gitweb project. Record
the Gitweb project URL. You need the Gitweb project URL to install
and configure the receive hook for the project.
.gif)
- Configure the receive hook for your registered project.
- Click Receive Hook
- Add change request tags and separate each one with a
comma. For example, bug,task
- Add branch names and mark them as include or exclude
to limit which branches the Git receive hook applies to. You can use
the * glob pattern to match zero or more characters in a branch name.
The adapter reviews all of the globs, and the last glob to match the
branch name applies. For example, if you have a branch
named bug180 and include bug1* and
then exclude bug18*, the adapter excludes the branch
named bug180 because the last glob to match the branch
name applies.

Results
You have registered the Gitweb project with the Rational Adapter for Git. Registering the
Gitweb project completes the configuration of the Gitweb server to
work with Rational Adapter
for Git.
What to do next
Configure the Git receive hook for the Gitweb project, see
Deploying the Git receive hook.