Configuring the Rational DOORS database server

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

  1. 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.
  2. 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.

  3. 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.
  4. For the new settings to take effect, restart the Rational DOORS database server.

What to do next

Go to Identifying the database uniform resource name.