Command-line switches for the Rational DOORS database server

Use these command-line switches to set options for the dbadmin command, and to manage the Rational® DOORS® database server.

For a list of the Rational DOORS client command-line switches, see Command-line switches for the Rational DOORS client.

Table 1. Command-line switches for dbadmin
Switch (abbreviation) Parameter Description
-data (-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 machine where the database server is installed.
-killprocess (-k) channel_identifier Disconnects the user connection specified by channel_identifier.

The channel_identifier is displayed by -userlist.

-killserver (-K)   Stops the server.
-locklist (-l)   Lists all the files that are currently locked, and the channel identifier for each file.
-outfile (-o) filename Sends output to a file.

Use with the -locklist and -userlist switches.

-password (-P) password The current password for the server.
-newpassword (-p) newpassword The new password for the server.
-unlock (-U) channel_identifier Unlocks the locked file specified by channel_identifier.

The channel_identifier is displayed by -locklist.

-userlist (-u)   Lists all the user connections.
-serverLogging loglevel 1 - 6 If the server has been started with the loglevel and logfile parameters in place, you can use this switch to change the level of logging.

You do not need to restart the server for the new log level to take effect.

-tdsUserFilterLimit string Sets limits on Rational Directory Server user searches.
-tdsGroupFilterLimit string Sets limits on Rational Directory Server group searches.
-useCardAuthentication   Switches on smart card authentication.
-doNotUseCardAuthentication   Switches off smart card authentication.
-useOSUserAuthentication   Switches on OS user authentication.
-doNotUseOSUserAuthentication   Switches off OS user authentication.
-secure on, ON, off, OFF Specifies whether the Rational DOORS server is configured to start in secure mode.
-keyDB filename The full path to the key database file that contains the keys that are used for Rational DOORS SSL authentication and validation, including the file name.

The default is DOORS\9.3\certdb\server_authentication.kdb.

This switch takes precedence over -certdb. You can specify a location for the Rational Directory Server key database folder using -certdb and specify a separate location for the Rational DOORS SSL key database file using -keyDB.

-certdb folder_name Identifies the folder that contains the key database files that contain the keys for the Rational Directory Server and Rational DOORS SSL.

The default is DOORS\9.3\certdb\.

If you want to put the key database files for Rational DOORS SSL in a separate folder, use the -keyDB switch. The -keyDB switch takes precedence over -certdb.

-certName string Identifies the label of the certificate that is used to identify the server during secure authentication.

The default is IBMSV1.

-serverhostname string The name that is used by the server to identify itself during certificate validation.
This table lists the command-line switches that you use when you are running Rational DOORS Web Access:
Table 2. Command-line switches for dbadmin for Rational DOORS Web Access
Switch (abbreviation) Parameter Description
-dwaHost DWAserver This switch identifies the Rational DOORS Web Access server, where DWAserver is the name of the machine that the Rational DOORS Web Access server is running on.
-dwaPort port This switch identifies the number of the port that the Rational DOORS Web Access server is running on.

If the communication needs to be secure, the default port is 8443. If the communication does not need to be secure, the default port is 8080.

-dwaProtocol http or https This switch specifies the protocol that the Rational DOORS Web Access server is using.

If communication is secure, enter https. If communication is not secure, enterhttp. Do not enter both.

-dcnEnable   Enables the DCNs.
-dcnBrokerUri tcp://broker:61616 Identifies the Rational DOORS Web Access broker, where broker is the machine hosting the broker and 61616 is the default port number that the broker uses.
-dcnChannelName dcn Sets up the DCN channel. The channel name is always "dcn".
-dcnInfo   This switch checks the status of the DCN service.
-dcnEnable   This switch switches on the DCN service.
-dcnDisable   This switch switches off the DCN service.

Example command-line command

You can use command-line switches in the command line and in shortcuts.

You can shut down the server that is running at 36677@abc with this command:
dbadmin -data 36677@abc -killserver
You can shut down the server that is running at 36677@abc with this shortcut:
"C:\Program Files\IBM\Rational\DOORS\9.3\bin\doors.exe" -data "36677@abc" -killserver

Feedback