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
- 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
- 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.
- In Installation Manager, click and then select Add
Repository.
- 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.
- Click OK to finish editing the repository
preference list.
The new repository location is added
to the list.
- Click OK to close the Preferences page.
- In Installation Manager, click Update.
- 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.
- 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.
- Click Next.
- Read and accept the license agreement by selecting the
appropriate radio button, then click Next.
- In the Features window, review the
item to be installed and then click Next.
- If you deployed the adapter war file on Apache Tomcat,
stop the server before it is updated.
- Click Next.
- In the Summary window, review your
selection and click Update to install the update.
- When the update is complete, click Finish.
- If you deployed the adapter war file on Apache Tomcat,
start that server that you stopped during installation.
- If you deployed the adapter war file on WebSphere® Application Server,
complete these steps:
- Stop the adapter installed web application. With the
application selected on the Enterprise applications page,
click Stop.
- Update the adapter web application, click Update.
The Preparing for application update page
is displayed.
- 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
- Select Replace the entire application option,
enter the location of the web application HPInstallDir/server/webapps/hpqm.war,
and click Next.
- Select Fast Path - Prompt only when additional
information is required and click Next.
- Click Next to accept the default
options until you reach the Map context roots for web modules page.
- In the Map context roots for web modules, set Context
root to /hpqm and click Next.
- Click Finish.
- 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.
- Click to exit the page and to see
your updated application in the list of installed applications.
- Next, click Start. A green arrow indicates that the application restarted.
- 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 . 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.
- Replace the keystore file at HPInstallDir/server/tomcat/ibm-team-ssl.keystore with
the copy that you made in step 1.
- If you are using PVU licensing, add the updated license
files, see Licensing.
- 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.