The Rational® Adapter
for Git must be registered with the Jazz™ Team
Server.
Before you begin
Make sure that you have set up the application server that
hosts the adapter and you have set up a database for the Git adapter.
Important: If you installed the Rational solution for Collaborative Lifecycle
Management and the Rational Adapter
for Git at the same time, the Rational Adapter
for Git is registered with the Jazz Team
Server. This is because as part of the installation process, the Jazz Team Server set up steps recognized
the Rational Adapter for
Git, registered it and automatically guided you through the set up
of the Rational Adapter
for Git.
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 Rational Team Concert™ user
with administrator or project administrator privileges. If you are
already logged into Rational
Team Concert in your current browser session with a userid that
does not have these privileges, log out before beginning this step.
Remember: Since you use the Rational Adapter
for Git 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 Rational Adapter for
Git with that same Jazz Team
Server.
Procedure
- Login 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 Application Name, type Git
Adapter.
- For Discovery URL, type https://[fully
qualified hostname]:[port]/gitAdapter/scr
- For Consumer Secret, type a consumer
secret for the application that you are registering to use. Jazz Team Server will automatically
generate 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.
- Click Finish.
- After you register with the Jazz Team
Server, you configure the application. To do so, in the message that
confirms that you've registered the application, click Application
Setup Wizard. You must provide or confirm the database
settings and finalize the configuration. The application that is registered
with the Jazz Team Server can
then share project areas. The following steps are for the setup wizard
for a CCM application.
Tip: In case you navigate
away from the Application Setup Wizard, the URL to relaunch the page
is https://[fully qualified hostname]:[port]/gitAdapter/setup
- On the Configure Database page, provide information
to set up a connection to the Git database. This is the database that
you set up to work with the Git adapter.
If you are
using the Derby database, you should not have to change the default
values, 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 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 have to wait several minutes for the
command to finish. If you have 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
You have registered the Rational Adapter
for Git with the Jazz Team Server.
What to do next
Configure linking between projects in Change and Configuration
Management applications and the Rational Adapter
for Git, see
Integrating applications.