Upgrading the JIRA adapter software

Uninstall the JIRA adapter software and install the latest JIRA adapter.

Before you begin

Complete these tasks before you install the adapter software:

About this task

You uninstall the adapter software and then install the latest adapter. The latest adapter software includes the latest fix pack. You can follow the same steps to upgrade from the trial version of the adapter.

These upgrade instructions apply to upgrading the adapter in to a JIRA 6.0.x application. For instructions about upgrading the adapter in to a JIRA 5.0.x application, see the 1.0 information center.

Procedure

  1. Uninstall the JIRA adapter from the JIRA server.
    1. Start the JIRA server if it is not already started. Log in to your JIRA server with administrative privileges.
    2. Click Administration > Add ons at the upper right of the page.

      You might be prompted to enter your JIRA administrative credentials.

    3. On the Administration page, click Manage Add-ons. The Manage Add-ons page opens.
    4. Click OSLC CM and then click Uninstall.

      Uninstall OSLC CM

      A message shows indicating that the adapter was successfully uninstalled.

      Important: Another message shows about reindexing the JIRA database. Since reindexing can take some time to complete, you can choose to reindex the JIRA database at a convenient time.
  2. Install the latest JIRA adapter.
    1. On the Manage Add-ons page, click Upload add-on, and in the dialog that opens, browse to where you extracted the electronic image or the product DVD to find the adapter JAR file.
    2. Select the adapter, click Open and then click Upload. A message shows indicating that the adapter was successfully installed.
      Important: Another message shows about reindexing the JIRA database. Since reindexing can take some time to complete, you can choose to reindex the JIRA database at a convenient time.
  3. If you are using PVU licensing, add the updated license files, see Licensing.
  4. Redo any server friend associations you set up previously.
    1. Delete the friend relationships from both the JIRA adapter and the CLM application administration page.
      To delete server friends from the JIRA adapter:
      • Click Administration > Add ons at the upper right of the page.
      • In the OSLC section at the lower left of the Administration page, click Rational Adapter Home.
      • In the Add Friends section, click Friends - (Manage Friend Setup). The Friends page opens.
      • In the Friend List section, delete each server friend by clicking the x icon in the Actions column of each server friend.
      To delete server friends from the CLM application:
      • Point your web browser to https://fully qualified hostname:port/ccm/admin
      • In the Communication section, click Consumers(Inbound).
      • On the OAuth Consumers page, in the Authorized Keys section, hover over a consumer name for your adapter and click the Remove Consumer icon in the Actions column.
      • Confirm that you want to delete the consumer name.
    2. Redo the friend relationships from JIRA see Establishing friend relationships from the adapter.
    3. Redo any project associations that you set up previously, see Linking between JIRA projects and CLM project areas.

Results

The adapter software is upgraded to the latest software.

What to do next

Continue to use the JIRA adapter, see Using the JIRA adapter.

Feedback