Upgrading to 3.0 (Tomcat)

This topic describes how to upgrade to version 3.0 in the default Apache Tomcat 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.

To upgrade to version 3.0:

Procedure

Stop the Jazz™ Team Server.
Back up your database and the teamserver.properties file to a temporary location outside the Jazz Team Server 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.

If you are using a database other than the default Derby database, see the topics in c_instl_setup_db.html for further details about the use of the teamserver.properties file with your particular database.
Back up the InstallDir\server\tomcat\conf directory.
Note any modifications you have made to the following files so you can preserve those changes after the update:
- InstallDir\server\tomcat\conf\tomcat-users.xml (if you are using Tomcat as a user registry)
- InstallDir\server\tomcat\conf\web.xml (LDAP settings)
If you have configured cross-repository integrations, back up the InstallDir\server\conf\jazz\friendsconfig.rdf file, which contains a list of servers set up for cross-repository integration.
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.
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.
When the installation completes, copy the files that you backed up previously to the new installation location. These files may include teamserver.properties, the files in the InstallDir\server\tomcat\conf directory, and friendsconfig.rdf.
If you are using an Oracle or SQL Server database, be sure to copy the database driver to the correct location.
1. For Oracle, in the same directory as the server scripts (InstallDir/server), create a directory named oracle. Then, copy the Oracle JDBC driver JAR file, named ojdbc14.jar to the oracle directory. For further details, see Setting up an Oracle database.
2. For SQL Server, in the same directory as the server scripts (InstallDir/server), create a directory named sqlserver. Then, locate the SQL Server JDBC driver JAR file, named sqljdbc.jar, and copy the file into the newly created sqlserver directory. Finally, set up the environment variable SQLSERVER_ABSPATH to point to the directory that contains the JAR file. If the path contains space characters, you must include them with quotations. For further details, see Setting up a SQL Server database.
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.
If you created a security certificate for use with the previous release, copy the certificate from the previous release or create a new one. See c_instl_security_certificates.html for details.
If you are running the Tomcat application server as a Windows service, you must remove and reinstall the service. See t_run_rqm_win_service.html for the command syntax.
Restart the Rational Quality Manager Jazz Server.
Open your browser, clear the browser cache, and reconnect to the Rational Quality Manager project area.
Upgrade your licenses.
Start the Rational Team Concert client and update your reports.
Verify that the imported content is there.