You can perform an update using IBM® Installation Manager to upgrade from IBM Rational® Quality Manager 2.0
to Rational Quality Manager 2.0.0.1.
No data migration is required.
Before you begin
You must be logged in as a user with JazzAdmins repository
permissions.
About this task
To upgrade to version 2.0.0.1 in a
WebSphere® Application Server environment:
Procedure
- Back up your Rational Quality
Manager database repository. If you are using the supplied Derby database,
simply copy the InstallDir\server\repositoryDB directory
to a safe location. If you are running another database, refer to
your database vendor's instructions for backup procedures.
- In the WebSphere Application
Console, stop and uninstall the jazz_war and help_war applications.
- Stop the WebSphere Application Server.
- Delete the jazz_war and help_war directories from the WebSphere temporary data directory,
for example, C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\temp\ServerNode01\server1.
- Download the zip files for the Express® or Standard edition of Rational Quality Manager 2.0.0.1.
- Extract the contents of the downloaded zip files to a temporary
directory.
- Start the launchpad application located in the RQM_SETUP folder.
- Start IBM Installation
Manager and perform an Update installation. If necessary, follow the
steps below to add a local repository that points to the download
directory.
- Click .
- Click .
- Supply the path to the download directory and click OK.
- Click Update to start the Update
installation.
The update creates a backup in the InstallDir\server\backup-config-timestamp directory.
- When the installation completes, review the files in the InstallDir\server\backup-config-timestamp directory
and determine if you had modified any of these files. If so, merge
your changes into the newly installed versions of the following files:
- InstallDir\server\conf\jazz\teamserver.properties (database
settings)
- InstallDir\server\conf\jazz\friendsconfig.rdf (list
of servers set up for cross-repository integration)
- InstallDir\server\conf\jazz\provision_profiles (settings
for WebSphere Application Server)
- InstallDir\server\tomcat\conf\tomcat-users.xml (if
you are using Tomcat as a user registry)
- Go to the InstallDir\server directory and run the following
command, which adds a new database table that is required for 2001:
repotools -clean -addTables
When the
command completes, it should report that the database tables were
added successfully.
- If you deploy Rational Quality
Manager 2.0.0.1 to a server with a repository on DB2® running on the Windows®, Linux®,
or AIX® platforms, you must create
a temporary tablespace called JAZZTMPSPACE before running the server
for the first time.
This tablespace is required by
recent changes in the planning component. You can find detailed instructions
about creating a tablespace in the DB2 documentation.
If automatic storage is enabled, the temporary tablespace can usually
be created with the following DB2 command:
create user temporary tablespace JAZZTMPSPACE managed by automatic storage
If
you fail to perform this operation, errors may occur when invoking
planning operations. If you are unable to perform this operation before
running the server, you can still perform the operation later without
compromising the integrity of the repository.
- Restart the WebSphere Application Server.
- Install the 2.0.0.1 jazz.war and help.war files (see InstallDir\server\tomcat\webapps\)
and update the user and group mappings to the jazz_war application.
These mappings specify the repository permissions for each user and
group.
- Start the new jazz.war and help.war applications.
- While the Rational Quality Manager Jazz™ server is running, configure
the server to reset the cache the next time it starts by typing the
following URL into your browser:
https://server_name:port number/jazz/admin/cmd/requestReset
For
example, if you are logged on to the server locally, you can type
the following command:
https://localhost:9443/jazz/admin/cmd/requestReset
If
this command works successfully, you should see the following message:
The Jazz Server has been flagged to reset and reload from the configured update-site when it is next restarted
- Restart the jazz.war application.
- Clear your browser cache.
- Log in to Rational Quality Manager.