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.
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. These interruptions can stop the interoperation server and cause DWA to
fail.
If your version of DWA is
earlier than 9.5.2.1, then see this topic in a previous version of the help.
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 DWA 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
- If your system is configured for data exchange and reporting, start the Derby database server.
Browse to the directory where you installed DWA 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. 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, log in as the owner of DWA.
- Go to the directory where you installed DWA.
- Enter broker.start.sh.
- If the IBM Engineering Requirements
Management DOORS
(DOORS)
database server is not already started, start it.
- Configure and start the interoperation server:
- On the computer that hosts the interoperation server, log in as the owner of DWA.
- 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.
- 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 DOORS
database server is using.
- myserver is the name of the system where the 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.
For more startup options, see
Command-line switches for the DOORS
client and interoperation server.
- Start the web access server:
- On the computer that hosts the web access server, log in as the owner of DWA.
- Go to the directory where you installed DWA.
- Enter server.start.sh.