Starting Rational DOORS Web Access on Linux systems

To start running Rational® DOORS® Web Access, you must start its components in a specific order.

Before you begin

Before you start the interoperation server, you must set up a valid DISPLAY variable and then make it accessible to the user who starts the interoperation server. You can use either an X server or virtual DISPLAY with a solution, such as Xvfb.
Attention: Do not use a remote DISPLAY variable. If you export a DISPLAY variable from another system for the interoperation server to use, the interoperation server becomes vulnerable to network interruptions that can stop the interoperation server and cause Rational DOORS Web Access to fail.

About this task

If users and groups are managed in IBM® Rational Directory Server, and the directory server is backed up or restarted, users cannot log in to the web client until all of the interoperation servers are restarted.

For instructions to start Rational DOORS Web Access on Linux systems when the server starts, see technote 1420620.

The Derby installation supports data exchange and reporting that uses tracked resource sets (TRS) and the Lifecycle Query Engine (LQE). For more information, see Tracking changes by using TRS and LQE

Procedure

  1. If your system is configured for data exchange and reporting, start the Derby database server. Browse to the directory where you installed Rational DOORS Web Access and run derby.start.sh.
    Important: If you use a Derby port number other than the default port 1527, you must change the value of the DERBY_PORT variable in the derby.start.sh script before you run the script.
  2. If your version of Rational DOORS Web Access is earlier than 9.5.2.1, then run the script dwa_install/derby/scripts/init_trs.sh.
    Important: If you use a Derby port number other than the default port 1527, you must change the value of the DERBY_PORT variable in the init_settings.sh script before you run the script.
  3. Start the web access broker:
    1. On the computer that hosts the web access broker, log in as the owner of Rational DOORS Web Access.
    2. Navigate to the directory where you installed Rational DOORS Web Access.
    3. Enter broker.start.sh.
  4. If the Rational DOORS database server is not already started, start it.
  5. Configure and start the interoperation server:
    1. On the computer that hosts the interoperation server, log in as the owner of Rational DOORS Web Access.
    2. Set these environment variables:
      DOORSHOME=doors-home-path
      DOORSDATA=36677@myserver
      PATH=$DOORSHOME/bin:$PATH
      export DOORSHOME PATH DOORSDATA

      where the DOORSHOME variable relates to where the interoperation server is installed. This variable might be different from the DOORSHOME variable that you use for the database server.

    3. Browse to $DOORSHOME/bin and start the interoperation server by entering its command-line attributes in this format:
      ./doors9 -interop -data port@myserver -brokerHost myBroker -brokerPort brokerport &
      where:
      • port is the port number that the Rational DOORS database server is using.
      • myserver is the name of the system where the Rational DOORS database server is installed.
      • myBroker is the name of the system that hosts the broker.
      • brokerport is the port that the broker is using, which by default is 61616.
  6. Start the web access server:
    1. On the computer that hosts the web access server, log in as the owner of Rational DOORS Web Access.
    2. Navigate to the directory where you installed Rational DOORS Web Access.
    3. Enter server.start.sh.
Related concepts:
Starting, stopping, and removing Rational DOORS Web Access

Feedback