For the list of the command-line switches for the RationalDOORS client, see Command-line switches for the Rational DOORS client.
Switch (abbreviation) | Parameter | Description |
---|---|---|
-data (-d) | port@DOORSserver | This switch identifies the Rational DOORS database server, where port is the port number that the database server is using and DOORSserver is the name of the computer where the database server is installed. This switch is always required. |
-killprocess (-k) | channel_identifier | This switch disconnects the user connection
that is specified by the channel_identifier
parameter. The channel_identifier parameter is displayed by the -userlist switch. |
-killserver (-K) | This switch stops the server. | |
-locklist (-l) | This switch lists all of the files that are currently locked and the channel identifier for each file. | |
-outfile (-o) | filename | This switch sends output to a file. Use this switch with the -locklist and -userlist switches. |
-password (-P) | password | This switch is the current password for the server. |
-newpassword (-p) | newpassword | This switch is the new password for the server. |
-unlock (-U) | channel_identifier | This switch unlocks the file that is
specified by the channel_identifier
parameter. The channel_identifier parameter is displayed by the -locklist switch. |
-userlist (-u) | This switch lists all of the user connections. | |
-serverLogging | log_level | If the server was started with the
loglevel and logfile parameters,
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. For a description of log levels, see Log files. |
-logxconfig (-X) | logging_file_name | The full name of the log4cxx
configuration file; for example, c:\Program
Files\IBM\Rational\DOORS\9.6\logging-config.xml. Log4cxx is
a framework for logging application messages. When you use this
parameter on the command line or in the registry, application messages
are output to in the specified configuration file. Six levels of message
are logged:
|
-tdsUserFilterLimit | string | This switch sets limits on Rational Directory Server user searches. |
-tdsGroupFilterLimit | string | This switch sets limits on Rational Directory Server group searches. |
-useCardAuthentication | This switch turns on smart card authentication. | |
-doNotUseCardAuthentication | This switch turns off smart card authentication. | |
-useOSUserAuthentication | This switch turns on OS user authentication. | |
-doNotUseOSUserAuthentication | This switch turns off OS user authentication. | |
-secure | on, ON, off, OFF | This switch specifies whether the Rational DOORS server is configured to start in secure mode. |
-keyDB | filename | This switch is 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 path is DOORS\9.version\certdb\server_authentication.kdb. This switch takes precedence over the -certdb switch. To specify a location for the Rational Directory Server key database folder, use the -certdb switch. To specify a separate location for the Rational DOORS SSL key database file, use the -keyDB switch. |
-certdb | folder_name | This switch identifies the folder that contains the
key database files that contain the keys for the Rational Directory Server and Rational
DOORS SSL. The default path is DOORS\9.version\certdb\. To put the key database files for Rational DOORS SSL in a separate folder, use the -keyDB switch. The -keyDB switch takes precedence over the -certdb switch. |
-certName | string | This switch identifies the label of the
certificate that identifies the server during secure
authentication. The default label is IBMSV1. |
-serverhostname | string | This switch is the name that the server uses to
identify itself during certificate validation. The default label is IBMEDSERV. |
Switch (abbreviation) | Parameter | Description |
---|---|---|
-dwaHost | DWAserver | This switch identifies the Rational DOORS Web Access server, where DWAserver is the fully qualified host name of the computer that the Rational DOORS Web Access server is running on; for example, dwaserver.ibm.com. |
-dwaPort | port | This switch identifies the port number that
the Rational
DOORS Web Access
server is running on. If communication must be secure, the default port is 8443. Otherwise, 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. Otherwise, enter http. Do not enter both. |
-dcnEnable | This switch enables the Data Change Notifications required to enable communication with the Rational DOORS Web Access server and broker. | |
-dcnBrokerUri | tcp://broker:61616 | This switch identifies the Rational DOORS Web Access broker, where broker is the computer that is hosting the broker and 61616 is the default port number that the broker uses. |
-dcnChannelName | dcn | This switch sets up the Data Change Notifications channel. The channel name is always "dcn". |
-dcnInfo | This switch checks the status of the Data Change Notifications service. | |
-dcnEnable | This switch turns on the Data Change Notifications service. | |
-dcnDisable | This switch turns off the Data Change Notifications service. |
Switch (abbreviation) | Parameter | Description |
---|---|---|
-minstall | -port port_number -serverdata server_data_path | This switch creates a subsequent addtional Rational
DOORS database server service on
machines running Windows
operating systems, where portnumber is equal to the
data connection port and server_data_path is equal to
the data directory folder on the server. For example: "doorsd -minstall -port 36666 -serverdata C:\Program Files(x86)\IBM\Rational\DOORS\9.6\new_data._ An instance number, such as 00001, is assigned to the new service. |
-remove | This switch removes the default service created when Rational DOORS database server is installed the first time. | |
-mremove | -i service_instance_number | This switch removes a specific instance of a Rational DOORS database server service where portnumber is equal to the instance number assigned to the name of the database service. |
-list | This switch outputs a list, in table format, of all configured Rational DOORS database server services and their status. | |
-logfile | log_file | This switch set the file used for Rational DOORS database server transaction logging. For a description of log levels, see Log files. |
-loglevel | log_level | This switch sets the level of detail for information that is recorded by the Rational DOORS database server transactional logging. Use the value 0 to turn off logging. Use the value 6 to produce the most verbose details. |
-start | This switch starts the default Rational DOORS database server service. | |
-stop | This switch stops the default Rational DOORS database server service. |
You can use command-line switches on the command line and in shortcuts.
dbadmin -data 36677@abc -killserver
"C:\Program Files\IBM\Rational\DOORS\9.version\bin\doorsd.exe" -start -debug