数据库服务器命令行开关

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

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

表 1. Rational DOORS 中 dbadmin 命令的命令行开关
开关(缩写) 参数 描述
-data (-d) port@DOORSserver 此开关用于标识 Rational DOORS 数据库服务器,其中 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 是在运行 Rational DOORS Web Access 服务器的计算机的标准主机名;例如,dwaserver.ibm.com
-dwaPort port 此开关用于标识 Rational DOORS Web Access 服务器运行所在的端口号。

如果通信必须安全,那么缺省端口为 8443。否则,缺省端口为 8080

-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   此开关用于关闭“数据更改通知”服务。
表 3. Rational DOORS 中 doorsd 的命令行开关
开关(缩写) 参数 描述
-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   此开关用于移除首次安装 Rational DOORS 数据库服务器时创建的缺省服务。
-mremove -i service_instance_number 此开关用于移除 Rational DOORS 数据库服务器服务的特定实例,其中 portnumber 等于分配给数据库服务名称的实例号。
-list   此开关用于按表格式输出所有已配置 Rational DOORS 数据库服务器服务及其状态的列表。
-logfile log_file 此开关可设置用于 Rational DOORS 数据库服务器事务日志记录的文件。有关日志级别的描述,请参阅日志文件
-loglevel log_level 此开关用于设置由 Rational DOORS 数据库服务器事务日志记录所记录的信息的详细级别。使用值 0 可关闭日志记录。使用值 6 可生成最详细的信息。
-start   此开关用于启动缺省 Rational DOORS 数据库服务器服务。
-stop   此开关用于停止缺省 Rational DOORS 数据库服务器服务。

命令行命令示例

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

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

快捷方式命令示例

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

反馈