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:
- On the computer that hosts the web access broker, browse to the
directory where you installed Rational DOORS Web Access.
- 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:
- 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 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:
- On the computer that hosts the web access server, browse to the
directory where you installed Rational DOORS Web Access.
- 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.
- On the computer that hosts the system, browse to the directory
where you installed Rational DOORS Web Access.
- 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.