Upgrading Rational DOORS Web Access

To upgrade to a newer version of IBM® Rational® DOORS® Web Access, you simply install the new version. However, you must ensure that the interoperation server is the same version as the new version that you install. In addition, if your previous installation integrated with IBM Rational Insight or Tracked Resource Set (TRS) consumer applications, such as IBM Rational Engineering Lifecycle Manager, you must also preserve integration data.

Procedure

  1. Shut down all components of the previous Rational DOORS Web Access installation: the web access broker, interoperation servers, and the Tomcat and Derby servers. For instructions, see the related concepts below.
  2. Rename the existing Rational DOORS Web Access directory; for example, C:\Program Files\IBM\Rational\DOORS Web Access_old.
  3. Install the new version of Rational DOORS Web Access. For instructions, see the related concepts below.

    When you upgrade Rational DOORS Web Access, you must also install the same version of the interoperation server. For more details, see the technote Version compatibility for Rational DOORS Web Access, interoperation server, Rational DOORS database server and client.

  4. If your previous installation was integrated with Rational Insight or TRS consumer application, such as Rational Engineering Lifecycle Manager, copy the contents of the previous festival\derby directory to the new installation. For example, locate this directory in your old installation:
    C:\Program Files\IBM\Rational\DOORS Web Access_old\9.version\server\festival\derby
    Copy the old derby directory to the new installation:
    C:\Program Files\IBM\Rational\DOORS Web Access\9.version\server\festival\derby
  5. If you customized the following files in your previous installation, identify the custom settings in the old files and enter those settings in the files in the new installation. Custom entries might include host names, port numbers, user names, and passwords.
    \IBM\Rational\DOORS Web Access\9.version\derby\derby.properties
    \IBM\Rational\DOORS Web Access\9.version\derby\scripts\init_settings.bat or init_settings.sh
  6. Complete the remaining steps to install Rational DOORS Web Access.
    Important: For installations that integrate with Rational Insight or TRS consumer applications, do not rerun the Derby initialization scripts on the copied Derby database. The default location of the init* scripts is C:\Program Files\IBM\Rational\DOORS Web Access\9.version\derby\scripts.
  7. Restart Rational DOORS Web Access and its components.
  8. Clear your browser cache, and instruct team members to clear the browser cache on client machines before connecting to Rational DOORS Web Access.
Related concepts:
Running (and shutting down) Rational DOORS Web Access
Installing Rational DOORS Web Access

Feedback