To upgrade to a newer version of IBM®
Engineering Requirements Management DOORS® - Web
Access
(DWA),
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 Jazz™ Reporting
Service or
Tracked Resource Set (TRS) consumer applications, such as IBM
Engineering Lifecycle Optimization - Engineering Insights (ENI), you
must also preserve integration data.
Procedure
- Shut down all components of the previous DWA
installation: the web access broker, interoperation servers, and the Tomcat and Derby servers. For
instructions, see the related concepts below.
- Rename the existing DWA
directory; for example, <install_dir>\DOORS Web Access_old.
- Install the new version of DWA. For
instructions, see the related concepts below.
When you upgrade DWA, you
must also install the same version of the interoperation server. For more details, see the technote
Version compatibility for DWA,
interoperation server, DOORS
database server and client.
- If your previous installation was integrated with Jazz Reporting
Service or TRS
consumer application, such as ENI, copy
the contents of the previous festival\derby directory to the new installation.
For example, locate this directory in your old installation:
<install_dir>\DOORS Web Access_old\9.version\server\festival\derby
Copy
the old derby directory to the new
installation:<install_dir>\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 DWA.
Important: For installations that integrate with Jazz Reporting
Service or TRS
consumer applications, do not rerun the Derby initialization scripts on the copied Derby database.
The default location of the init* scripts is <install_dir>\DOORS
Web Access\9.version\derby\scripts.
- Restart DWA and
its components.
- Clear your browser cache, and instruct team members to clear the browser cache on client
machines before connecting to DWA.