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.
Procedure
- Start the Derby database server. Browse to the directory
where you installed Rational DOORS Web Access and run derby.start.sh.
- If the Rational DOORS database server is not already
started, start it.
- Start the web access broker:
- On the computer that hosts the web access broker, log in as the
owner of Rational DOORS Web Access.
- Navigate to the directory where you installed Rational DOORS Web
Access.
- Enter broker.start.sh.
- Configure and start the interoperation server:
- On the computer that hosts the interoperation server, log in as
the owner of Rational DOORS Web Access.
- 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 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.
- Start the web access server:
- On the computer that hosts the web access server, log in as the
owner of Rational DOORS Web Access.
- Navigate to the directory where you installed Rational DOORS Web
Access.
- Enter server.start.sh.