To enable communication with the Rational® DOORS® Web
Access server and broker, you must configure the Rational DOORS database
server by running the dbadmin command with command-line
switches.
Before you begin
Note: If the database server is set up to use system user
names, Rational DOORS Web Access cannot access
the Rational DOORS database server.
Procedure
- Locate the dbadmin command.
- On Windows systems, dbadmin is
in the \DOORS\9.version\bin directory on the Rational
DOORS client system.
- On Solaris and Linux® systems, dbadmin is
in the $DOORSHOME/bin directory.
- Run the dbadmin command in a command
line in the following format:
dbadmin -dcnEnable -data port@DOORSserver -P server_password -dcnBrokerUri “tcp://broker:61616“ -dcnChannelName “dcn“ -dwaHost DWAserver –dwaPort port –dwaProtocol http or https
Here is an example:
dbadmin -dcnEnable -data 36677@localhost -P password -dcnBrokerUri tcp://doors60.example.com:61616 -dcnChannelName dcn -dwaHost doors60.example.com -dwaPort 8443 -dwaProtocol https
Table 1. dbadmin parameters
Switch |
Description |
-dcnEnable |
Enables the Data Change Notifications service. |
-d
port@DOORSserver |
Identifies the Rational
DOORS database server, where port is the
number of the port that the database server is using and DOORSserver is the name
of the system where the database server is installed. |
-P
server_password |
The Rational
DOORS database server password, if a password is being
used. |
-dcnBrokerUri
"tcp://broker:61616" |
Identifies the broker, where broker is the system that is
hosting the broker and 61616 is the default port number that the broker
uses. |
-dcnChannelName "dcn" |
Sets up the Data Change Notifications service channel. The channel name is
always "dcn". |
-dwaHost
DWAserver |
This switch identifies the Rational
DOORS Web Access server, where DWAserver
is the fully qualified hostname of the computer that the Rational
DOORS Web Access server is running on, for example
dwaserver.ibm.com. |
–dwaPort
port |
Identifies the number of the port that the Rational
DOORS Web Access server is running on. If communication is
secure, the default port is 8443 . If communication is not secure, the default port
is 8080 .
|
-dwaProtocol
http or https |
Specifies the protocol that the Rational
DOORS Web Access server is using. Enter either
http or https. Do not enter both.
|
- Make a note of the values you used for -dwaProtocol, -dwaHost,
and –dwaPort. You use these values when you are
modifying the Rational DOORS Web Access configuration
files.
- For the new settings to take effect, restart the Rational DOORS database server.