Register the Git adapter with the Jazz™ Team Server.
About this task
Registering the adapter with the Jazz Team Server makes the adapter web application
known to the Jazz Team Server
and the Change and Configuration Management application. For this
step, you must log in as a user with administrative access to the Jazz Team Server application. If
you are already logged in to Jazz Team
Server in your current browser session with a user ID that does not
have these privileges, log out before you start the first step.
Remember: You use the Git adapter with Change Configuration
Management applications that are registered with the same Jazz Team Server that you used during the installation
process. You must register the Git adapter with that same Jazz Team Server.
Procedure
- Start the Jazz Team
Server if it is not already started.
- Log in to the Administration page
of the Jazz Team Server.
Point your web browser to https://fully
qualified hostname:port/jts/admin.
- Click the Server tab.
- In the left pane, in the Configuration section, click Registered
Applications.
- In the Registered Applications section, click Add .
- In the Add Application window, type
the following information about your application:
- For Discovery URL, type https://fully
qualified hostname:port/gitAdapter/scr
- For Application Name, type Git
Adapter.
- For Consumer Secret, type a consumer
secret for the application that you are registering to use. Jazz Team Server automatically generates
a consumer key.
- For Re-type Secret, retype the
consumer secret for the application that you entered for Consumer
Secret.
- A Functional User ID called gitAdapter_user is
automatically created when you register the Git adapter application
with the Jazz Team Server. This
functional user ID is used to run tasks in the background and has
the same capabilities as other registered application users. There
is no need to change the name of this user. If you do want to change
the name, you can type another name in the Functional User
ID field, or browse and search for an existing name. The
functional user ID does not need to exist in the external registry;
if the user does not exist in the repository, it is automatically
created.
Tip: For more information about
the functional user ID, see
Adapter users

- Click Finish.
- After you register with the Jazz Team
Server, you configure the Git adapter application. In the message
that confirms that you registered the application, click the Application
Setup wizard. You must provide or confirm the database
settings and finalize the configuration.
Tip: If
you leave the Application Setup wizard, you
can relaunch the page with this URL https://fully
qualified hostname:port/gitAdapter/customSetup
- On the Configure Database page,
provide information to set up a connection to the Git adapter database.
This is the database that you set up to work with the Git adapter.
If you are using the Derby database, you can accept the default
value, and you are not prompted to create database tables.
If
you change the default values or set values for an enterprise database
like DB2® or Oracle, click Test
Connection to make sure that the connection is configured
correctly.
If you did not previously use repotools to
create the database tables, you might see a warning that the database
exists but that it does not contain any tables. To create the tables,
click Create tables. You might wait several
minutes for the command to finish. If you tested the connection and
you see no warnings or errors, click Next.
- In the Finalize Application page,
click Finalize Application Setup. Verify that
Finalize completes without error and the Next button
is enabled. Click Next.
- In the Configure Data Warehouse page
for the application, confirm the database connection. Click Test
Connection. Click the I do not wish to configure
the data warehouse at this time check box, and then click Next.
- Click Finish.
- On the Summary page, verify that
there are no errors.
Results
The Git adapter is registered with the Jazz Team Server.
What to do next
Establish a friend relationship between a Change and Configuration
Management application and the Git adapter application, see
Integrating applications.