Starting Rational DOORS Web Access on Windows systems

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

Before you begin

Review the Installation roadmap for Rational DOORS Web Access and related help topics for prerequisites, installation topology and minimum requirements, and license options.

If your version of Rational DOORS Web Access is earlier than 9.5.2.1, then see this topic in a previous version of the help.

Note: While you do not need to run each of the components as Administrator, to start each one successfully, the user that you log in as must have ownership of the associated data files.

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.

When you complete steps 1, 3, and 4 in the following procedure, a window opens for each process. Do not close those windows.

If you want to prevent processes from stopping after the administrator logs off from the server, you can start Rational DOORS Web Access as a Microsoft Windows service. For instructions to start as a Microsoft Windows service, see technote 1394655. For more information about running as a Microsoft Windows service, see technote 1457046.

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

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 double-click derby.start.bat.

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.bat script before you run the script. Also, add this command line parameter to the script: -Dderby.drda.portNumber=%DERBY_PORT%. Alternatively, you can add the following entry with the new port number in the derby/derby.properties file: derby.drda.portNumber=derby_port_number.
Start the web access broker:
1. On the computer that hosts the web access broker, browse to the directory where you installed Rational DOORS Web Access.
2. Double-click broker.start.bat.
On the computer that hosts the Rational DOORS database server, start the database server as a service.
Start the interoperation server:
1. On the computer that hosts the interoperation server, open a command prompt and browse to Install_directory/bin.
2. Enter the doors.exe commands, ensuring that the attributes and variables are in this format:
```
doors.exe -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 computer that hosts the Rational DOORS database server.
  - myBroker is the name of the computer that hosts the broker.
  - brokerport is the port that the broker is using, which by default is 61616.
  For more startup options, see Command-line switches for the Rational DOORS client and interoperation server.
This example, which is from an actual installation, includes a maximum memory allocation:
```
doors.exe -interop -data 36677@doorsDB -brokerHost DWAbroker -brokerPort 61616 -maxMemory 512
```
Start the web access server:
1. On the computer that hosts the web access server, browse to the directory where you installed Rational DOORS Web Access.
2. Double-click server.start.bat.
Optional: If you are running the Rational DOORS Web Access components on a single computer, for example, as a test environment, you can use the dwa.start.bat file to start the system.
1. On the computer that hosts the system, browse to the directory where you installed Rational DOORS Web Access.
2. Open the dwa.start.bat file for editing. Follow the instructions in the file, entering the values where indicated.
3. Save the file and double-click it to run it.