Upgrading from 2.0 to 2.0.0.1 (Tomcat)

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

  1. 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
  2. Stop the Rational Quality Manager Jazz server by clicking Start > All Programs > IBM Rational Quality Manager > Stop IBM Rational Quality Manager server.
  3. 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.
  4. Download the zip files for the Express® or Standard edition of Rational Quality Manager 2.0.0.1.
  5. Extract the contents of the downloaded zip files to a temporary directory.
  6. Start the launchpad application located in the RQM_SETUP folder.
  7. 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.
    1. Click File > Preferences.
    2. Click Add > Repository.
    3. Supply the path to the download directory and click OK.
    4. Click Update to start the Update installation.

    The update creates a backup in the InstallDir\server\backup-config-timestamp directory.

  8. 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.
  9. 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.

  10. 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.

  11. 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.
  12. 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.
  13. Restart the Rational Quality Manager Jazz server.
  14. Clear your browser cache.
  15. Log in to Rational Quality Manager.

Feedback