Upgrading the HP adapter software

You use IBM® Installation Manager to upgrade the adapter software.

Before you begin

Download the 1.1.1.1 fix pack, see Rational® Lifecycle Integration Adapters Standard Edition Fix Pack 1 (1.1.1.1) for 1.1.1.

If you have Internet access, you can skip downloading the software and steps 3 - 6 in these upgrade instructions. With Internet access, the Update Packages wizard in IBM Installation Manager can search for updates to installed product packages. For more information about using Installation Manager to install updates, see Updating packages by using wizard mode.

If you are upgrading from the trial software to the supported software, consider these points:
  • If you used the default derby database for the trial software, use the location for derby.system.home so that you can reuse your database configuration. Back up the derby database before you upgrade.
  • If you used a Public URI Root for a production server when you installed the trial software, use that same Public URI Root when you upgrade.
  • If you customized Apache Tomcat, you must customize Apache Tomcat again when you upgrade.

About this task

You use IBM Installation Manager to access a repository that contains the package update to upgrade the software. The latest adapter software includes the latest fix pack. You can follow the same steps to upgrade from the trial version of the adapter.
Important: You cannot use the launchpad to upgrade the software.

Procedure

  1. If the adapter web application was installed on an Apache Tomcat application server, back up the keystore file at HPInstallDir/server/tomcat/ibm-team-ssl.keystore
  2. Start Installation Manager. Skip to step 7 if you have Internet access. With Internet access, Installation Manager can access the IBM update repository locations for updates to your installed packages.
  3. In Installation Manager, click File > Preferences and then select Add Repository.
  4. 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 HPQM/disk1 folder.
  5. Click OK to finish editing the repository preference list.

    The new repository location is added to the list.

  6. Click OK to close the Preferences page.
  7. In Installation Manager, click Update.
  8. 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.

  9. 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 that you want to update. Click Next.

    If you added a repository, Installation Manager searches for updates by using that repository. If you did not add a repository but have Internet access, Installation Manager searches for updates to the installed product packages.

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

  10. Click Next.
  11. Read and accept the license agreement by selecting the appropriate radio button, then click Next.
  12. In the Features window, review the item to be installed and then click Next.
  13. If you deployed the adapter war file on Apache Tomcat, stop the server before it is updated.
  14. Click Next.
  15. In the Summary window, review your selection and click Update to install the update.
  16. When the update is complete, click Finish.
  17. If you deployed the adapter war file on Apache Tomcat, start that server that you stopped during installation.
  18. If you deployed the adapter war file on WebSphere® Application Server, complete these steps:
    1. Stop the adapter installed web application. With the application selected on the Enterprise applications page, click Stop.
    2. Update the adapter web application, click Update.

      The Preparing for application update page is displayed.

    3. Under Specify the EAR, WAR, JAR, RAR, or SAR module to upload and update
      • Ensure that Application to be updated refers to the application to be updated.
      • Under Application update options, select the installed application (hpqm.war)
      • Under Full path, enter the path to the hpqm.war web application file. If you did not install Apache Tomcat when you installed the adapter, the directory that contains the web application is the one that you defined during the installation. The default directory is HPInstallDir/server/webapps/hpqm.war
    4. Select Replace the entire application option, enter the location of the web application HPInstallDir/server/webapps/hpqm.war, and click Next.
    5. Select Fast Path - Prompt only when additional information is required and click Next.
    6. Click Next to accept the default options until you reach the Map context roots for web modules page.
    7. In the Map context roots for web modules, set Context root to /hpqm and click Next.
    8. Click Finish.
    9. Verify that the hpqm_war application was updated correctly and click Save directly to the master configuration. The Preparing for the application installation page opens again.
    10. Click Applications > Application Types > WebSphere enterprise applications to exit the page and to see your updated application in the list of installed applications.
    11. Next, click Start. A green arrow indicates that the application restarted.
    12. Point your browser to https://fully qualified hostname:port/hpqm. Log in to the Rational Adapter for HP ALM server by using an account that has administrator privileges.
      Tip: You can find the port number that is used for your application server from the administrative console. Click Servers > Server Types > WebSphere Application Servers > server_ name > Ports. Look for the value for the port name WC_defaulthost if you are using an HTTP Transport Port or the value for the port name WC_defaulthost_secure if you are using an HTTPS Transport Secure Port.
  19. Replace the keystore file at HPInstallDir/server/tomcat/ibm-team-ssl.keystore with the copy that you made in step 1.
  20. If you are using PVU licensing, add the updated license files, see Licensing.
  21. Customize your existing HP ALM projects to work with the adapter, see Customizing HP ALM projects.

Results

The adapter software is upgraded to the latest software.
Tip: If you experience issues with the software update, you can revert the software to the version installed before the upgrade by using the Installation Manager GUI rollback feature. For more information about the rollback feature, see Roll back updates by using wizard mode.

What to do next

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

Feedback