You use IBM® Installation
Manager to upgrade the HP adapter trial. You upgrade to the supported
version that is available with the Rational® Lifecycle
Integration Adapters Standard Edition offering.
Before you begin
In addition, consider these points before you upgrade
the trial software to the supported software:
- 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 Installation Manager to upgrade the trial software
to the supported product software. Installation Manager installs the
supported product software into a product directory, which is different
from the location where you installed the trial software.
Procedure
- Install Rational Adapter for HP ALM by using Installation
Manager, see Installing from Installation Manager.
- 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.
- Set up the Apache Tomcat application server to work with
the HP adapter. If you want to use WebSphere Application Server, skip
to the next step.
- Update the application server port numbers
- Stop the application server.
- In a text editor, open HPInstallDir/server/tomcat/conf/server.xml
- Search for the Connector element for the non-secure
port. By default, this Connector element is not commented
out, has a comment above it that days Define a non-SSL HTTP/1.1
Connector on port 9080, and has a redirectPort attribute.
- Modify the value of the port attribute with the port number 8080 to
use for non-secure connections. To use port 8080, type port="8080"
- Modify the value of the redirectPort attribute
with the port number 8443 to use for non-secure connections.
To use port 8443, type port="8443"
- After you modified the Connector for the non-secure
port, search for the Connector element for the secure
port. By default, this Connector element is not commented
out and has the attribute secure="true"
- Modify the value of the port attribute with the port number 8443 to
use for secure connections. You must use the same number that you
typed for the redirectPort attribute for the non-secure
connection. To use port 8443, type port="8443"
- Save the server.xml file.

Changing the
default port numbers enables you to continue to use the server friends
and project associations that you set up for the HP adapter trial.
- Change the application server startup file to use the
derby database that you defined when you set up the HP adapter trial.
- In a text editor, open HPInstallDir/server/server.bat.
- Replace set JAVA_OPTS=%JAVA_OPTS% -Dderby.system.home=%PATH_URL% with set
JAVA_OPTS=%JAVA_OPTS% -Derby.system.home=C:\derby
- Save the server.bat file.

This change retains the server friends that are defined
when you set up the HP adapter trial.
- Start the application server, see Starting Apache Tomcat.
- Set up WebSphere Application Server to work
with the HP adapter. Skip to the next step if you set up the Apache
Tomcat application server.
- Back up the HP adapter installed web application that
you deployed when you installed the trial software. From the Admin
console, click . Select the application (hpqm.war)
and click Export File.
- Stop the HP adapter installed web application. With
the application selected on the Enterprise applications page,
click Stop
- Update the HP 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 HP 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
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 displays again.
- Click to exit the page and to see
your updated application in the list of installed applications.
- Next, click Restart. 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 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.
- Set up HP ALM projects, as required, see Setting up HP ALM projects.
You might want to set up more HP ALM projects to work with
CLM projects.
- Establish server relationships and associate projects,
as required, see Integrating applications.
You might want
to set up more server friends and project associations between HP
ALM projects and CLM project areas.
- Delete the directory that you installed the trial software
in to.
Results
The trial software is upgraded to the supported product software.
What to do next
Continue to use the HP adapter, see
Using the HP adapter.