Upgrading from 2.0 to 2.0.0.1 (WebSphere Application Server)

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

  1. 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.
  2. In the WebSphere Application Console, stop and uninstall the jazz_war and help_war applications.
  3. Stop the WebSphere Application Server.
  4. 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.
  5. Download the zip files for the Express® or Standard edition of Rational Quality Manager 2.0.0.1.
  6. Extract the contents of the downloaded zip files to a temporary directory.
  7. Start the launchpad application located in the RQM_SETUP folder.
  8. 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.

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

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

  12. Restart the WebSphere Application Server.
  13. 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.
  14. Start the new jazz.war and help.war applications.
  15. 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
  16. Restart the jazz.war application.
  17. Clear your browser cache.
  18. Log in to Rational Quality Manager.

Feedback