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
- 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.
- Rename the existing Rational
DOORS Web Access directory; for example,
C:\Program Files\IBM\Rational\DOORS Web Access_old.
- 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.
- 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
- 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
- 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.
- Restart Rational DOORS Web Access and its components.
- Clear your browser cache, and instruct team members to
clear the browser cache on client machines before connecting to Rational DOORS Web Access.