Using the Rational Adapter for Git 60-day trial with Rational Team Concert

This article presents user assistance for the 60-day trial version of the IBM® Rational Adapter for Git. This trial version is intended for internal evaluation, testing or demonstration purposes.

A supported version of the Rational Adapter for Git is generally available with the Rational Lifecycle Integration Adapters Standard Edition offering. For more details, visit this page.

Overview

The Rational Adapter for Git allows you to link Rational Team Concert work items and Git commits or Gerrit changes.

You can use the Rational Adapter for Git from any Git developer repository interface such as the Git command line or EGit, Gitweb, or Gerrit. Working from any of these interfaces, you can link a Git commit or Gerrit change to a Rational Team Concert work item. By default, links are made to your primary Rational Team Concert project. You can also create links to other Rational Team Concert projects. A single commit or Gerrit change can link to multiple Rational Team Concert work items and multiple commits or Gerrit changes can link to a single Rational Team Concert work item.

Once created, links are visible from Gitweb, Gerrit, and Rational Team Concert.

Important: This trial version of the Rational Adapter for Git is the same as the Rational Adapter for Git that is available with the Rational Lifecycle Integration Adapters Standard Edition offering, except that the trial version of the Rational Adapter for Git includes a trial license key that expires 60 days after activation. You need to purchase the entitled license key to continue to use the Rational Adapter for Git after the expiration date. Work done with the trial version of Rational Adapter for Git can continue to be used after you install the Rational Lifecycle Integration Adapters offering.

Install and configure the Git adapter

Several steps are required to install and configure the Rational Adapter for Git trial version before you can use it.

Before you begin

Verify that your hardware and software meet the minimum requirements. For a list of supported hardware and software platforms for Rational Adapter for Git, see Detailed System Requirements for Rational Lifecycle Integration Adapters Standard Edition.

About this task

This task provides an overview of the steps to complete before you can use the Git adapter.

Procedure

  1. Download and extract the Git adapter, see Download the Git adapter.
  2. Install the Git adapter, see Install the Git adapter.

Download the Git adapter

The Rational Adapter for Git is available as a 60-day trial download.

Before you begin

Your hardware and software should meet the minimum requirements for the Rational Adapter for Git.

About this task

The Rational Adapter for Git is delivered as a single zip file. The zip file contains the files and the license for the Rational Adapter for Git trial version. Follow these steps to download this zip file.

Procedure

  1. Go to Rational Adapter for Git download page.
  2. Click All (672.78 MB) under Platform.
  3. Login with your jazz.net ID.
  4. Review the accompanying license by clicking the View License link. If you agree to the license terms, select the checkbox to agree with the terms, and click Download.

    Your download should begin. If the download does not begin, follow the instructions provided.

  5. Extract the downloaded file to a location that you can access.

Install the Git adapter

Several steps are required to install the Git adapter.

Before you begin

You have downloaded the Git adapter and extracted the files to a location that you can access.

About this task

You follow the same installation steps provided in the Rational Lifecycle Integration Adapters Standard Edition information center to install the Rational Adapter for Git trial version.

Procedure

Use the installation roadmap as a guide to the high-level steps required to install and configure the Git adapter, see Installation roadmap.

Use the Git adapter

The Rational Adapter for Git supports command line and web interfaces.

Before you begin

You have installed and configured the Git adapter.

About this task

You follow the same steps provided in the Rational Lifecycle Integration Adapters Standard Edition information center to use the Rational Adapter for Git trial version.

Procedure

Associate Git commits with Rational Team Concert work items, see Using Rational Adapter for Git.

For more information

If you run into problems while completing the tasks in these topics or have general questions about the Git adapter, you can take these actions:

About the authors

Steve Wasleski, Joseph Leong and Robin Bobbitt are software developers at IBM. Sally Hehir and Melanie Steckham are technical writers at IBM.

Feedback
Was this information helpful? Yes No 0 people rated this as helpful.