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 a unique directory path.
If you are upgrading from version 1.x, 2.0.1 will be installed into
the C:\Program Files\IBM\RQM20 directory by default.
If you are upgrading from version 2.x, version 2.0.1 will be installed
into the C:\Program Files\IBM\RQM201 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\RQM201.
To
upgrade to version 2.0.1 in a WebSphere Application Server environment:
- 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.
- 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.
- 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.
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.
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
Setting up a WebSphere Application Server
- 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.