Configuring the DOORS database server

To enable communication with the IBM® Engineering Requirements Management DOORS® - Web Access (DWA) server and broker, you must configure the IBM Engineering Requirements Management DOORS (DOORS) database server by running the dbadmin command with command-line switches.

Before you begin

Important: Any change to the DWA URL, including the port number, might require a rebuild of Lifecycle Query Engine (LQE) indexes in integrated applications, such as IBM Engineering Lifecycle Optimization - Engineering Insights (ENI). For more information, see the help "Completing the server rename for Lifecycle Query Engine" in the documentation for ENI.
Note: If the database server is set up to use system user names, DWA cannot access the DOORS database server.

Procedure

  1. Locate the dbadmin command.
    • On Windows systems, dbadmin is in the \DOORS\9.version\bin directory on the DOORS client system.
    • On 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 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 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 DWA server, where DWAserver is the fully qualified hostname of the computer that the DWA server is running on, for example dwaserver.ibm.com.
    –dwaPort port Identifies the number of the port that the DWA 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 DWA 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 DWA configuration files.
  4. For the new settings to take effect, restart the DOORS database server.

Feedback