Upgrading to 3.0 (WebSphere Application Server environment)

This topic describes how to upgrade to IBM® Rational® Quality Manager 3.0 in a WebSphere® Application Server environment.

About this task

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

By default, version 3.0 will be installed into the C:\Program Files\IBM\JazzTeamServer directory by default. In a WebSphere Application Server environment, it is recommended that you change the installation path to one that contains no spaces, such as C:\IBM\JazzTeamServer.

Procedure

Stop the WebSphere Application Server.
Export the data from your existing repository using the repotools -export command and save the TAR 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.
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, the file is located at InstallDir\server\teamserver.properties in version 1 and InstallDir\server\conf\jazz\teamserver.properties in version 2.
Back up the InstallDir\server\conf\jazz\provision_profiles directory.
Start the WebSphere Application Server.
Uninstall the jazz.war and help.war files.
Stop the WebSphere Application Server.
Delete the jazz_war and help_war directories at C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\temp\<server>Node01\server1.
Using Installation Manager, click Install, and follow the installation procedure to install the latest version of Rational Quality Manager.
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.
When the installation completes, copy the teamserver.properties file that you backed up previously to the new installation location.
By default, this file is located at InstallDir\server\conf\jazz\teamserver.properties.
Restore the provision_profiles directory that you backed up previously and update the provision profiles as needed to ensure they are accurate for this version of Rational Quality Manager.
The provision profiles include profile.ini, nlprofile.ini, rqm-license-profile.ini, and rqm-profile.ini. In most cases, it will be necessary to update the directory paths in these files.
Restart the WebSphere Application Server.
In the Generic JVM arguments section on the Java™ Virtual Machine page, update the JVM arguments using the new directory paths.
Note: New parameters were added to the JVM arguments section in v2.0. In addition, be sure that the WAS security setting "Use available authentication data when an unprotected URI is accessed" is checked. For further details, see t_instl_config_rqm_was.html
Install the new jazz.war and help.war files.
Update user and group mappings to the jazz_war application.
These mappings specify the repository permissions for each user and group.
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.
Start the jazz.war and help.war .
Upgrade your licenses.
Start the Rational Team Concert client and update your reports.
Open your browser, clear the browser cache, and reconnect to the Rational Quality Manager project area.
Verify that the imported content is there.