Installation prerequisites for Rational DOORS Web Access

Before you begin your product installation, plan the installation, and familiarize yourself with the components that will be installed on your machines.

About this task

Note: If you are upgrading Rational® DOORS® Web Access from an earlier version to 1.5.0.1 or later and you choose to copy your old server.xml file to the new installation, you must remove the reference to the Composite Application Framework (CAF) JavaScript library. Remove the following lines from the server.xml file:
<Context crossContext="true" debug="0" docBase="caf.war" path="/caf" reloadable="true">
   <Valve className="com.telelogic.dwa.catalina.valve.GlobalisationRequestInterceptor"/>
</Context>
Note: When you upgrade Rational DOORS Web Access to version 9.5.1 or later, you must also upgrade the interoperation server to the same version.
Installing Rational DOORS Web Access involves the installation of a number of discrete components.
Table 1. Rational DOORS Web Access Components
Component Description
Rational DOORS Web Access server An adaptation of Apache Tomcat. Tomcat is an application server that runs Java™ servlets and renders web pages that include JavaServer Pages code.
Rational DOORS Web Access broker An adaptation of Apache ActiveMQ. ActiveMQ is an open source message broker that implements the Java Message Service (JMS).
Rational DOORS database server Stores the data that you will be accessing.
Interoperation server A Rational DOORS client that you run from the command line.

For a description of a basic Rational DOORS Web Access configuration, see this article in IBM® developerWorks®: Basic Rational DOORS Web Access installation.

Procedure

  1. Ensure that you meet the system requirements for installing and running Rational DOORS Web Access. Details of system requirements are on the Rational DOORS Web Access System Requirements website.
  2. Shut down all other applications.
  3. Access the files that you need, and copy them to the appropriate machine.

    The following table lists the files that you need for each platform:

    Table 2. Rational DOORS Web Access Files
    Platform File Description

    Windows
    Solaris
    Linux

    ratlDOORS_WebAccess
    _version.zip

    Contains:
    • Rational DOORS Web Access server.
    • Rational DOORS Web Access broker.
    • IBM JRE for use with Rational DOORS Web Access. No other external JDK/JRE is needed.
    Windows

    ratlDOORS_InteropServer
    _version_Windows.zip

    A Rational DOORS client, which acts as the interoperation server for Rational DOORS Web Access.
    Solaris

    ratlDOORS_InteropServer
    _version_solaris.zip

    Contains an interoperation server installer and a Rational DOORS database server installer.
    Linux

    ratlDOORS_InteropServer
    _version_Linux.zip

    Contains the interoperation server installer.

    ratlDOORS_Server
    _version_Linux.zip

    Contains a Rational DOORS database server installer.
  4. Ensure that you have a valid license for Rational DOORS Web Access.

    You must have the Rational License Key Server installed on your system.

    For information about the Rational License Key Server, see Rational Common Licensing information.

  5. On Windows, if you are upgrading from a previous version, follow the instructions that were provided with that version to shut down the components before you continue.

Feedback