Upgrading to 2.0.1 (Tomcat)

This topic describes how to upgrade to IBM® Rational® Quality Manager 2.0.1 in the default Apache Tomcat environment.

About this task

To upgrade to 2.0.1, you must export your data from the earlier release, install 2.0.1, and import the data into 2.0.1.

By default, version 2.0.1 will be installed into the C:\Program Files\IBM\RQM201 directory.

To upgrade to version 2.0.1:

Procedure

  1. Stop the Rational Quality Manager Jazz™ Server.
  2. Back up your database and the teamserver.properties file to a temporary location outside the Rational Quality Manager installation directory.

    The teamserver.properties file contains the database location, which Rational Quality Manager needs to connect to the database. By default, this file is located at InstallDir\server\teamserver.properties in version 1 and InstallDir\server\conf\jazz\teamserver.properties in version 2.

  3. Back up the InstallDir\server\tomcat\conf directory.
  4. If you are upgrading from a version older than 1.0.1, be sure to note all of the users that had access to the default Quality Manager project area. You will need to add these users manually to the Quality Manager project area in 2.0.1.
  5. Export the data from your existing repository using the repotools -export command and save the file outside the Rational Quality Manager directory structure, as shown in the following examples:

    If upgrading from version 1:

    repotools -export toFile=c:\export.tar teamserver.properties=c:\Program%20Files\IBM\RQM\server\teamserver.properties

    where toFile specifies the name of the TAR file that the repository is exported to and teamserver.properties specifies the path to the teamserver.properties file.

    If upgrading from version 2:

    repotools -export toFile=c:\export.tar teamserver.properties=c:\Program%20Files\IBM\RQM20\server\conf\jazz\teamserver.properties
    Note: Detailed instructions for using repotools can be found at https://jazz.net/learn/LearnItem.jsp?href=content/docs/repo-migration/index.html and at Migrating the Jazz Server. Be sure to use the version of repotools that is included with the existing product.
  6. Using Installation Manager, click Install, and follow the installation procedure to install the latest version of Rational Quality Manager on the server.

    If another version of Rational Quality Manager is installed, you will see a notification message. Click Continue to install the package to a new package group.

    Note: You cannot install 2.0.1 into the same package group and location as a previous version.
  7. When the installation completes, copy the teamserver.properties file that you backed up previously to the new installation location.
  8. Copy the InstallDir\server\tomcat\conf directory that you backed up previously to the new installation location.
  9. Import the data from the exported repository using the newly installed version of the repotools -import command, as shown in the following example:
    repotools -import fromFile=c:\export.tar teamserver.properties=c:\Program%20Files\IBM\RQM201\server\conf\jazz\teamserver.properties

    where fromFile specifies the name of the TAR file that the repository will be imported from and teamserver.properties specifies the path to the teamserver.properties file.

    Note: Be sure to use the version of repotools that is included with the newly-installed product.
  10. Restart the Rational Quality Manager Jazz Server.
  11. Open your browser, clear the browser cache, and reconnect to the Rational Quality Manager project area.
  12. Upgrade your licenses.
  13. Start the Rational Team Concert client and update your reports.
  14. Verify that the imported content is there.

Feedback