Updating to v1.0.1 (manual database migration)

If you prefer to migrate your database manually while upgrading to Rational® Quality Manager v1.0.1, you must uninstall Rational Quality Manager v1.0 before installing v1.0.1.
Note: Because important database connection information is lost when you uninstall Rational Quality Manager, you must be sure to perform a backup before uninstalling.

To migrate your database manually when upgrading to Rational Quality Manager v1.0.1:

  1. Stop the Rational Quality Manager Jazz™ Server, or if you are in a WebSphere® Application Server (WAS) environment, stop WAS.
  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 information about the database location, which Rational Quality Manager needs to know about to be able to connect to the database. By default, this file is located at <RQM_install_dir>\RQM\server\teamserver.properties.

  3. If you are using the default Tomcat application server that is installed with Rational Quality Manager, back up the <RQM_install_dir>\RQM\server\tomcat\conf directory. If you are in a WebSphere Application Server environment, back up the provision_profiles directory.
  4. 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 example:
    repotools -export toFile=c:\export.tar teamserver.properties=c:\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.

    Note: Instructions for using repotools can be found at https://jazz.net/learn/LearnItem.jsp?href=content/docs/repo-migration/index.html.
  5. Start Installation Manager, click Uninstall, and follow the uninstallation procedure to remove Rational Quality Manager from the server.
  6. Using Installation Manager, click Install, and follow the installation procedure to install the latest version of Rational Quality Manager on the server.
  7. When the installation completes, restore the teamserver.properties file that you backed up previously.
  8. If you are using the default Tomcat application server, restore the <RQM_install_dir>\RQM\server\tomcat\conf directory that you backed up previously.
  9. In a WAS environment, do the following:
    1. Restore the provision_profiles directory that you backed up previously.
    2. Uninstall the old jazz.war file and delete the jazz_war directory.
      Note: You can find the jazz.war file at <RQM_install_dir>\RQM\server\tomcat\webapps\jazz.war. You can find the jazz_war directory at C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\temp\<serverNode>\server1\.
    3. Install the new jazz.war file.
  10. Import the data from the exported repository using the repotools -import command, as shown in the following example:
    repotools -import fromFile=c:\export.tar teamserver.properties=c:\RQM\server\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.

  11. Start the Rational Team Concert client and update your reports to v1.0.1.
  12. Restart the Rational Quality Manager Jazz Server or if you are in a WebSphere Application Server (WAS) environment, restart WAS.
Related tasks
Backing up and restoring the Derby database
Backing up and restoring other supported databases
Updating your reports to Rational Quality Manager v1.0.1

Feedback