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:
- Stop the Rational Quality Manager Jazz™ Server, or if you are in a WebSphere® Application Server
(WAS) environment, stop WAS.
- 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.
- 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.
- 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.
- Start Installation Manager, click Uninstall,
and follow the uninstallation procedure to remove Rational Quality Manager from
the server.
- Using Installation Manager, click Install,
and follow the installation procedure to install the latest version
of Rational Quality Manager on
the server.
- When the installation completes, restore the teamserver.properties file
that you backed up previously.
- If you are using the default Tomcat application server,
restore the <RQM_install_dir>\RQM\server\tomcat\conf directory
that you backed up previously.
- In a WAS environment, do the following:
- Restore the provision_profiles directory
that you backed up previously.
- 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\.
- Install the new jazz.war file.
- 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.
- Start the Rational Team Concert client
and update your reports to v1.0.1.
- Restart the Rational Quality Manager Jazz Server or if you are in a WebSphere Application Server
(WAS) environment, restart WAS.