Upgrading from the trial version

You use IBM® Installation Manager to upgrade the adapter trial. You upgrade to the supported version that is available with the Rational® Lifecycle Integration Adapters Standard Edition offering.

Before you begin

Obtain the installation files. To order an electronic image, see Downloading the installation media. To order a product DVD, see ibm.com®.

About this task

You use Installation Manager to access a repository that contains the package update to upgrade the trial software to the supported product software.
Important: You cannot use the launchpad to upgrade the trial software to the supported product software.

Procedure

  1. Start Installation Manager.
  2. In Installation Manager, click File > Preferences and then select Add Repository.
  3. For the Repository location, browse to the location of the diskTag.inf file.
    • If you are installing from the DVD, insert the DVD into your DVD drive. Find the diskTag.inf file, which is in the root folder.
    • If you are installing from the electronic image, change to the directory where you extracted the disk image. Find the diskTag.inf file, which is in the GIT/Disk1 folder.
  4. Click OK to finish editing the repository preference list.

    The new repository location is added to the list.

  5. Click OK to close the Preferences page.
  6. In Installation Manager, click Update.
  7. If a new version of Installation Manager is found, you are prompted to confirm the installation before you can continue. Click OK to proceed.

    Installation Manager automatically installs the new version, restarts, and resumes.

  8. In the Update Packages window, select the package group that contains the package for updating. The package group is the location of the installed adapter trial that you want to update. Click Next.

    Installation Manager searches for updates by using the predefined repository that you just added.

    The available update is shown and selected in the Update list on the Update Packages page.

  9. Click Next.
  10. Read and accept the license agreement by selecting the appropriate radio button, then click Next.
  11. In the Features window, review the item to be installed and then click Next.
  12. Confirm that the server that is being updated is stopped and then click Next.
  13. In the Summary window, review your selection and click Update to install the update.
  14. When the update is complete, click Finish.
  15. Restart the server that you stopped during installation.
  16. Update the Gitweb additions on the Gitweb server by replacing the Gitweb additions that are deployed when you installed the Git adapter trial version.
    1. Back up the oslcConfig.js file.
    2. Go to the folder location where you installed Rational Adapter for Git.

      For example, JazzTeamServerDir/server/conf/gitAdapter

    3. Find the gitwebAdditions-yyyymmdd-hhmm.zip file.
    4. Uncompress the gitwebAdditions-yyyymmdd-hhmm.zip file to your Gitweb installation folder that you used for the adapter trial.
    5. Restore the oslcConfig.js file.
  17. Update the Gerrit additions on the Gerrit server by replacing the Gerrit additions that are deployed when you installed the Git adapter trial version.
    1. Stop the Gerrit server.
    2. Back up the oslcConfig.js file.
    3. Go to the folder location where you installed Rational Adapter for Git.

      For example, JazzTeamServerDir/server/conf/gitAdapter

    4. Find the gerrit-yyyymmdd-hhmm.zip file.
    5. Uncompress the gerrit-yyyymmdd-hhmm.zip file to your Gerrit installation folder that you used for the adapter trial.
    6. Restore the oslcConfig.js file.
    7. Restart the Gerrit server.
  18. Measure PVUs by which the adapter is licensed by setting up PVU licensing for the adapter, see Setting up processor value unit pricing

Results

The trial software is upgraded to the supported product software.

What to do next

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

Feedback