Upgrading from the trial

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

Complete these tasks:
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

  1. Install Rational Adapter for HP ALM by using Installation Manager, see Installing from Installation Manager.
  2. 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.
  3. 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.
    1. Update the application server port numbers
      1. Stop the application server.
      2. In a text editor, open HPInstallDir/server/tomcat/conf/server.xml
      3. 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.
      4. 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"
      5. 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"
      6. 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"
      7. 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"
      8. Save the server.xml file.

      Change ports in 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.
    1. Change the application server startup file to use the derby database that you defined when you set up the HP adapter trial.
      1. In a text editor, open HPInstallDir/server/server.bat.
      2. Replace set JAVA_OPTS=%JAVA_OPTS% -Dderby.system.home=%PATH_URL% with set JAVA_OPTS=%JAVA_OPTS% -Derby.system.home=C:\derby
      3. Save the server.bat file.

      Set JAVA_OPTS to the location of derby.system.home

      This change retains the server friends that are defined when you set up the HP adapter trial.
    2. Start the application server, see Starting Apache Tomcat.
  4. 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.
    1. Back up the HP adapter installed web application that you deployed when you installed the trial software. From the Admin console, click Applications > Application Types > Websphere enterprise applications. Select the application (hpqm.war) and click Export File.
    2. Stop the HP adapter installed web application. With the application selected on the Enterprise applications page, click Stop
    3. Update the HP adapter web application, click Update.

      The Preparing for application update page is displayed.

    4. 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
    5. Select Replace the entire application option and click Next.
    6. Select Fast Path - Prompt only when additional information is required and click Next.
    7. Click Next to accept the default options until you reach the Map context roots for web modules page.
    8. In the Map context roots for web modules, set Context root to /hpqm and click Next.
    9. Click Finish.
    10. 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.
    11. Click Applications > Application Types > Websphere enterprise applications to exit the page and to see your updated application in the list of installed applications.
    12. Next, click Restart. A green arrow indicates that the application restarted.
    13. 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.
  5. 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.

  6. 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.

  7. 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.

Feedback