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: Rational DOORS Web Access cannot access the Rational DOORS database server if the database server is set up to use system user names.

Procedure

  1. Locate the dbadmin command.
    • On Windows systems, dbadmin is in the DOORS_9_4\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 -data port@DOORSserver -P server_password -dcnEnable -dcnBrokerUri 
    “tcp://broker:61616” -dcnChannelName “dcn” –dwaProtocol http or https -dwaHost DWAserver –dwaPort port
    Table 1. dbadmin parameters
    Switch Description
    -data 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 has been set.
    -dcnEnable Enables the Data Change Notifications service.
    -dcnBrokerUri "tcp://broker:61616" Identifies the broker, where broker is the system 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".
    -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.

    -dwaHost DWAserver Identifies the Rational DOORS Web Access server, where DWAserver is the name of the system that the Rational DOORS Web Access server is running on.
    –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.

  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.

Feedback