You can perform an update using IBM® Installation Manager to upgrade from IBM Rational® Quality Manager v2.0
to Rational Quality Manager v2.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 from v2.0 to v2.0.0.1 in a Tomcat environment:
Procedure
- 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:
https://server_name:port number/jazz/admin/cmd/requestReset
- Stop the Rational Quality Manager Jazz server by clicking .
- 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.
- 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\tomcat\conf\tomcat-users.xml (if
you are using Tomcat as a user registry)
- InstallDir\server\tomcat\conf\web.xml (LDAP
settings)
Note: If you use LDAP authentication, there is a new user group
called JazzProjectAdmins that you must add to your web.xml file and
to the com.ibm.team.repository.ldap.groupMapping section of your teamserver.properties
file. Any edits that you make to the web.xml must be made after you
start the server. Otherwise, the edits will be overwritten when the
server starts.
- 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.
- If you are upgrading from 2.0 to 2.0.0.1, you must also
use the Rational Team Concert™ client to update the predefined report templates.
For details, see Updating the predefined report templates.
This step is not required if you perform a full installation of Rational Quality Manager 2.0.0.1.
- To obtain the custom reports for 2.0.0.1, download the Rational Quality Manager Report
Updates from All Downloads tab and import the updates into Rational Quality Manager.
For details, see Quick
install.
- Restart the Rational Quality Manager Jazz server.
- Clear your browser cache.
- Log in to Rational Quality Manager.