管理 UNIX 系统和 Linux 上 ClearQuest® 注册表中的数据库集和数据库连接信息
摘要
cqreg 命令位于 ClearQuest 安装目录下的 bin 目录中。
- 报告已注册的数据库集和数据库的连接信息:
- cqreg show [ -dbset dbset_name | -all ]
[ -terse | -errors | -verbose ] [ -help ] [ -effort_only ] [ -force
] [ -home cq_home ] [ -version cq_version ]
[ -cq_databases cq_databases ]
- 将 ClearQuest 安装目录与数据库注册表目录关联起来:
- cqreg initialize [ -associate ] [ registry_directory ]
[ -help ] [ -effort_only ] [ -force ] [ -verbose | -errors ] [ -home cq_home ]
[ -cq_databases cq_databases ]
- 在 ClearQuest 注册表中注册数据库集和数据库:
- cqreg add_dbset -v/endor db_vendor [ -s/erver db_server ]
[ -d/atabase db_name ] [ [ -u/ser user -p/assword password ]
] [ -dbset dbset_name ] [ -co connect_options ]
[ -help ] [ -effort_only ] [ -force ] [ -verbose | -errors ] [ -home cq_home ]
[ -cq_databases cq_databases ]
- 从 ClearQuest 注册表注销数据库集和数据库:
- cqreg drop_dbset [ -dbset dbset_name ] [
-help ] [ -effort_only ] [ -force ] [ -verbose | -errors ] [ -home cq_home ]
[ -cq_databases cq_databases ]
- 用模式存储库中的信息刷新数据库注册表:
- cqreg refresh [ -dbset dbset_name | -all
] [ -help ] [ -effort_only ] [ -force ] [ -verbose | -errors ] [ -home cq_home ]
[ -cq_databases cq_databases ]
描述
只能在 Windows 系统中用 Maintenance Tool 或 Designer 创建、删除和移动 ClearQuest 数据库。cqreg 命令用于管理与 ClearQuest 数据库集和数据库关联的连接信息,以便可以访问 UNIX 系统和 Linux 上的数据库。使用 cqreg 命令可以执行以下任务:
- 报告有关已注册数据库的信息
- 将 ClearQuest 安装目录与数据库注册表目录关联起来
- 连接到模式存储库,在使用 Maintenance Tool 或 Designer 创建或删除某个数据库后刷新数据库注册表
您还可从 UNIX 或 Linux 系统上运行的 ClearQuest 客户机中添加和除去数据库连接。
选项和参数
- -dbset dbset_name
- 数据库连接的名称。缺省情况下,为 ClearQuest 的版本。
- -all
- 对所有数据库集以及数据库集内的所有数据库执行该命令。
- -verbose
- -errors
- -terse
- 控制该命令所显示的输出数量。如果省略该选项,那么缺省情况下为 -errors。
- -effort_only
- 显示在不执行关联操作情况下子命令所执行的操作。
- -force
- 强制子命令替换现有注册表数据或文件,否则不会覆盖这些注册表数据或文件。
- -home cq_home
- 标识 ClearQuest 安装目录。如果设置了该值,那么它将覆盖环境变量 $CQ_HOME 的值。
- -version version
- 与 cqreg show 子命令一起使用,标识该命令所针对的 ClearQuest 产品的版本。如果省略该选项,那么将使用与当前发行版关联的版本。
- -cq_databases cq_databases
- 指定存储数据库连接的目录位置。如果设置了该值,那么它将覆盖环境变量 $CQ_DATABASES 的值。
- -associate
- 与 cqreg initialize 子命令一起使用,将 ClearQuest 安装目录与数据库注册表目录关联起来。
如果省略了该选项,那么 cqreg initialize 子命令将仅初始化注册表目录,而不会建立关联。
- registry_directory
- 与 cqreg initialize 子命令一起使用,指定注册表目录。如果省略该选项,那么将采用以下某个值,这些值按降序列出:
- -cq_databases cq_databases 的值(如果指定)
- 环境变量 $CQ_DATABASES 的值(如果已设置)
- 缺省值
- -v/endor db_vendor
- 数据库供应商。有效值包括:
- -s/erver server
- 数据库服务器。
- -d/atabase db_name
- 对于 DB2 和 SQL Server,为模式存储库使用的数据库名称。对于 Oracle,为数据库管理系统的系统标识 (SID)。
- -u/ser user_name
- 用于访问数据库的用户名。
- -p/assword password
- 用于访问数据库的密码。
- -co connect_options
- 连接选项。对于您的环境的连接选项,请联系系统管理员。也可参阅供应商数据库属性中的“管理 Rational® ClearQuest”帮助主题。
- -help
- 显示用法信息。
子命令
- cqreg show
- 报告已注册的数据库集和数据库的连接信息。
- cqreg initialize
- 将 ClearQuest 安装目录与数据库注册表目录关联起来。如果运行 cqreg initialize 子命令时 .Databases 文件已存在,那么只有在采用 -force 选项时才会替换该文件。
注意: 在安装 ClearQuest 过程中,会运行 cqreg initialize 子命令。仅在要将 ClearQuest 安装目录与另一个数据库注册表目录关联时,才会运行该子命令。
- cqreg add_dbset
- 在 ClearQuest 注册表中注册数据库集和数据库,或更新现有的连接信息。在用 Designer 创建模式存储库和用户数据库后,运行该子命令。
- cqreg register
- 该子命令已废弃。而改用 cqreg add_dbset 命令。
- cqreg drop_dbset
- 从 ClearQuest 注册表注销数据库集和数据库。在将数据库集移至另一个主机后,运行该子命令,以注销该数据库集。然后运行 cqreg add_dbset 命令,以便在新的主机上注册该数据库集。
在运行 cqreg drop_dbset 子命令时,如果没有分别用 -dbset dbset_name 选项和参数指定连接名称,那么将使用缺省连接。
- cqreg unregister
- 该子命令已废弃。而改用 cqreg drop_dbset 命令。
- cqreg refresh
- 用模式存储库中的信息刷新数据库注册表。在使用 Maintenance Tool 或 Designer 创建、修改或删除某个数据库之后,或在移动模式存储库和数据库之后,使用该子命令。如果 cqreg refresh 子命令没有重新建立连接,那么使用 cqreg drop_dbset 和 cqreg
add_dbset 子命令断开数据库连接,然后重新创建数据库连接信息。
示例
- 显示所有已注册的数据库集和数据库的连接信息:
- 用模式存储库中的信息刷新针对数据库集 UCM_dbset 的数据库注册表:
cqreg refresh -dbset UCM_dbset
- 以下分别为针对 Oracle、SQL Server 和 DB2 数据库添加连接的示例:
- 对于 Oracle:
cqreg add_dbset -v Oracle -s cqtest1 -d CQ1 -u admin -p admin_pwd -dbset CQ_DEV1 -co "PORT=50100"
- 对于 SQL Server:
cqreg add_dbset -v SQL_Server -s cqtest2 -d msitea -u admin -p pwd -dbset CQ_DEV1
- 对于 DB2:
cqreg add_dbset -v DB2 -s db2tcpnode -d msiteb -u admin -p pwd -dbset CQ_DEV3
- 注销数据库集 UCM_dbset:
cqreg drop_dbset -dbset UCM_dbset