数据库服务器命令行开关

您可以使用命令行开关来设置 dbadmin 命令的选项,以及管理 IBM® Rational® DOORS® 数据库服务器。
注: 要使用 dbadmin 命令,需要 -data 开关。如果不使用此开关或使用无效的数据值,那么此命令将无法运行,并会显示以下消息:-F- DBADMIN:未指定服务器

有关 Rational DOORS 客户机的命令行开关列表,请参阅Rational DOORS 客户机的命令行开关

表 1. Rational DOORSdbadmin 命令的命令行开关
开关(缩写) 参数 描述
-data (-d) port@DOORSserver 此开关用于标识数据库服务器,其中 port 是数据库服务器在使用的端口号,而 DOORSserver 是安装了数据库服务器的计算机的名称。始终需要此开关。
-killprocess (-k) channel_identifier 此开关用于断开 channel_identifier 参数所指定的用户连接。

channel_identifier 参数由 -userlist 开关来显示。

-killserver (-K)   此开关用于停止服务器。
-locklist (-l)   此开关用于列出当前已锁定的所有文件和各文件的通道标识。
-outfile (-o) filename 此开关用于将输出发送到文件。

请将此开关与 -locklist-userlist 开关配合使用。

-password (-P) password 此开关是服务器的当前密码。
-newpassword (-p) newpassword 此开关是服务器的新密码。
-unlock (-U) channel_identifier 此开关用于解锁 channel_identifier 参数所指定的文件。

channel_identifier 参数由 -locklist 开关来显示。

-userlist (-u)   此开关用于列出所有用户连接。
-serverLogging log_level 如果已使用 loglevellogfile 参数启动服务器,那么可以使用此开关来更改日志记录级别。

您无需重新启动服务器即可使新日志记录级别生效。

有关日志级别的描述,请参阅日志文件
-logxconfig (-X) logging_file_name log4cxx 配置文件的全名;例如,c:\Program Files\IBM\Rational\DOORS\9.6\logging-config.xml。Log4cxx 是用于记录应用程序消息的框架。在命令行上或注册表中使用此参数时,应用程序消息将输出到指定的配置文件中。将记录六种级别的消息:
  • TRACE
  • DEBUG
  • INFO,包括 ACK、CONFIRM 和 QUERY
  • WARNING
  • ERROR
  • FATAL
-tdsUserFilterLimit string 此开关用于设置对 Rational Directory Server 用户搜索的限制。
-tdsGroupFilterLimit string 此开关用于设置对 Rational Directory Server 组搜索的限制。
-useCardAuthentication   此开关用于开启智能卡认证。
-doNotUseCardAuthentication   此开关用于关闭智能卡认证。
-useOSUserAuthentication   此开关用于开启操作系统用户认证。
-doNotUseOSUserAuthentication   此开关用于关闭操作系统用户认证。
-secure on, ON, off, OFF 此开关用于指定 Rational DOORS 服务器是否配置为以安全方式启动。
-keyDB filename 此开关是密钥数据库文件(包含用于 Rational DOORS SSL 认证和验证的密钥)的完整路径,包括文件名。

缺省路径为 DOORS\9.version\certdb\server_authentication.kdb

此开关优先于 -certdb 开关。要指定 Rational Directory Server 密钥数据库文件夹的位置,请使用 -certdb 开关。要指定 Rational DOORS SSL 密钥数据库文件的单独位置,请使用 -keyDB 开关。

-certdb folder_name 此开关用于标识包含了密钥数据库文件(包含 Rational Directory Server 和 Rational DOORS SSL 的密钥)的文件夹。

缺省路径为 DOORS\9.version\certdb\

要将 Rational DOORS SSL 的密钥数据库文件置于单独的文件夹中,请使用 -keyDB 开关。-keyDB 开关优先于 -certdb 开关。

-certName string 此开关用于标识在安全认证期间标识服务器的证书的标签。

缺省标签为 IBMSV1

-serverhostname string 此开关是供服务器用来在证书验证期间标识其自身的名称。

缺省标签为 IBMEDSERV

表 2. Rational DOORS Web Access 中 dbadmin 的命令行开关
开关(缩写) 参数 描述
-dwaHost DWAserver 此开关用于标识 Rational DOORS Web Access 服务器,其中 DWAserver 是在运行 Web 服务器的计算机的标准主机名称;例如,dwaserver.ibm.com
-dwaPort port 此开关用于标识 Rational DOORS Web Access 服务器运行所在的端口号。

请参阅该表后关于缺省值和 URI 的重要注释。

-dwaProtocol httphttps 此开关用于指定 Rational DOORS Web Access 服务器在使用的协议。

如果通信是安全的,请输入 https。否则,请输入 http。请勿同时输入这两个值。

请参阅该表后关于协议与缺省端口值之间关系的重要注释。

-dcnEnable   此开关用于启用要支持与 Rational DOORS Web Access 服务器及代理程序的通信而所需的“数据更改通知”。
-dcnBrokerUri tcp://broker:61616 此开关用于标识 Rational DOORS Web Access 代理程序,其中 broker 是在托管该代理程序的计算机,而 61616 是该代理程序使用的缺省端口号。
-dcnChannelName dcn 此开关用于设置“数据更改通知”通道。通道名称始终为 "dcn"
-dcnInfo   此开关用于检查“数据更改通知”服务的状态。
-dcnEnable   此开关用于开启“数据更改通知”服务。
-dcnDisable   此开关用于关闭“数据更改通知”服务。
要点: 如果 -dwaPort 开关为空,那么端口值将缺省为所选协议的标准端口:
表 3. Rational DOORSdoorsd 的命令行开关
开关(缩写) 参数 描述
-minstall -port port_number -serverdata server_data_path 如果使用以下值设置参数,那么此开关将在具有 Windows 操作系统的计算机上创建额外一个 Rational DOORS 数据库服务器服务:
  • portnumber 等于数据连接端口
  • server_data_path 等于服务器上的数据目录文件夹
例如:"doorsd -minstall -port 36666 -serverdata C:\Program Files(x86)\IBM\Rational\DOORS\9.6\new_data"。将向新服务分配实例号,例如 00001。
-remove   此开关用于移除首次安装数据库服务器时创建的缺省服务。
-mremove -i service_instance_number 此开关用于移除数据库服务器服务的特定实例,其中 portnumber 等于分配给数据库服务名称的实例号。
-list   此开关用于按表格式输出所有已配置 Rational DOORS 数据库服务器服务及其状态的列表。
-logfile log_file 此开关用于设置用于数据库服务器事务日志记录的文件。有关日志级别的描述,请参阅日志文件
-loglevel log_level 此开关用于设置由数据库服务器事务日志记录所记录的信息的详细级别。使用值 0 可关闭日志记录。使用值 6 可生成最详细的信息。
-start   此开关用于启动缺省数据库服务器服务。
-stop   此开关用于停止缺省数据库服务器服务。

命令行命令示例

可以在命令行上和快捷方式中使用命令行开关。

要关闭在 36677@IBMEDSERV 运行的服务器,请输入以下命令:
dbadmin -data 36677@abc -killserver

快捷方式命令示例

要启动服务器,请使用以下快捷方式。修改此命令以反映您的 Rational DOORS 安装路径。
"C:\Program Files (x86)\IBM\Rational\DOORS\9.version\bin\doorsd.exe" -start

反馈