To start running IBM®
Engineering Requirements Management DOORS® - Web
Access
(DWA),
you must start its components in a specific order.
Before you begin
Review the Installation roadmap for DWA and related help topics for prerequisites, installation topology and minimum requirements,
and license options.
If your version of DWA 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 DWA 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 DWA 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:
- On the computer that hosts the web access broker, browse to the directory where you installed
DWA.
- Double-click broker.start.bat.
- On the computer that hosts the IBM Engineering Requirements
Management DOORS
(DOORS)
database server, start the database server as a service.
- Start the interoperation server:
- On the computer that hosts the interoperation server, open a command
prompt and browse to Install_directory/bin.
- 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 DOORS
database server is using.
- myserver is the name of the computer that hosts the 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 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:
- On the computer that hosts the web access server, browse to the directory where you installed
DWA.
- Double-click server.start.bat.
- Optional: If you are running the DWA
components on a single computer, for example, as a test environment, you can use the
dwa.start.bat file to start the system.
- On the computer that hosts the system, browse to the directory where you installed DWA.
- Open the dwa.start.bat file for editing. Follow the instructions in the
file, entering the values where indicated.
- Save the file and double-click it to run it.