Registering the Git adapter with the Jazz Team Server

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

  1. Login to the Administration page of the Jazz Team Server. Point your web browser to https://[fully qualified hostname]:[port]/jts/admin.
  2. Click the Server tab.
  3. In the left pane, in the Configuration section, click Registered Applications.
  4. In the Registered Applications section, click Add .
  5. In the Add Application window, type the following information about your application:
    1. For Application Name, type Git Adapter.
    2. For Discovery URL, type https://[fully qualified hostname]:[port]/gitAdapter/scr
    3. 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.
    4. For Re-type Secret, retype the consumer secret for the application that you entered for Consumer Secret.
    5. 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.
    6. Click Finish.
  6. 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
    1. 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.

    2. In the Finalize Application page, click Finalize Application Setup. Verify that Finalize completes without error and the Next button is enabled. Click Next.
    3. 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.
    4. Click Finish.
    5. 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.

Feedback