Registering the Git adapter with the Jazz Team Server

Register the Git adapter with the Jazz™ Team Server.

Before you begin

An application server is set up to work with the adapter, see Setting up the application server. A database for the Git adapter is set up, see Setting up a database.

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

  1. Start the Jazz Team Server if it is not already started.
  2. Log in to the Administration page of the Jazz Team Server.

    Point your web browser to https://fully qualified hostname:port/jts/admin.

  3. Click the Server tab.
  4. In the left pane, in the Configuration section, click Registered Applications.
  5. In the Registered Applications section, click Add .
  6. In the Add Application window, type the following information about your application:
    1. For Discovery URL, type https://fully qualified hostname:port/gitAdapter/scr
    2. For Application Name, type Git Adapter.
    3. For Consumer Secret, type a consumer secret for the application that you are registering to use. Jazz Team Server automatically generates 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.
      Tip: For more information about the functional user ID, see Adapter users

      Add application page to register the adapter with JTS

    6. Click Finish.
  7. 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
    1. 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.

    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

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.

Feedback