Upgrading to 1.0.0.1 from 1.0

You use IBM® Installation Manager to upgrade to 1.0.0.1.

Before you begin

Download the 1.0.0.1 fix pack, see Rational Lifecycle Integration Adapters Standard Edition Fix Pack 1 (1.0.0.1) for 1.0.

About this task

You use Installation Manager to access a repository that contains the package update to upgrade the 1.0 software to the 1.0.0.1 software.
Important: You cannot use the launchpad to upgrade the 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, which is in the HPQM/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 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. Set up WebSphere Application Server to work with the adapter. Skip to the next step if you set up the Apache Tomcat application server.
    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 displays 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 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.
  16. Measure PVUs by which the adapter is licensed by setting up PVU licensing for the Rational Adapter for HP ALM, see Setting up processor value unit pricing.

Results

The 1.0 software is upgraded to the 1.0.0.1 software.
Tip: If you experience issues with the 1.0.0.1 software update, you can revert the software to 1.0 by using the Installation Manager 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