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:
- Stop the Rational Quality Manager Jazz™ Server.
- 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.
- Back up the InstallDir\server\tomcat\conf directory.
- 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.
- 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.
Note: You cannot install
2.0.1 into the same package group and location as a previous version.
- When the installation completes, copy the teamserver.properties file
that you backed up previously to the new installation location.
- Copy the InstallDir\server\tomcat\conf directory
that you backed up previously to the new installation location.
- 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.
- 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.