配置或修改数据库。installutil 可与各种子命令一起使用,而此参考页面中描述的语法仅适用于配置 LDAP 用户认证时所用的子命令。
installutil 命令行实用程序仅可用于 Windows。
摘要
- installutil subcommand dbset_name cq_login cq_password [ –site site ]
[ –domain domain ] [ specific_subcommand_argument...]
描述
installutil 命令可与以下子命令一起使用:
- getauthenticationalgorithm。显示 setauthenticationalgorithm 子命令指定的算法。
- getcqldapmap。显示 setcqldapmap 子命令指定的字符串。
- getldapinit。显示 setldapinit 子命令针对特定数据库集指定的 ldapsearch 字符串。
- getldapsearch。显示 setldapsearch 子命令针对特定数据库集指定的字符串。
- setauthenticationalgorithm。针对指定的数据库集,控制 Rational® ClearQuest® 是同时支持 ClearQuest 和 LDAP 认证,还是仅支持 ClearQuest 认证。
- setcqldapmap。标识 ClearQuest 用户概要文件字段,以及 ClearQuest 将 ClearQuest 数据库集中的用户帐户映射到 LDAP 目录中的用户帐户时所用的 LDAP 用户属性。如果适用,将针对每个域和/或站点运行该命令一次。
- setldapinit。设置将 ClearQuest 数据库集连接到 LDAP 目录来进行认证所需的参数字符串。如果适用,将针对每个域和/或站点运行该命令一次。
- setldapsearch。指定将要用于查找要认证的 LDAP 用户帐户的 LDAP 搜索条件。如果适用,将针对每个域和/或站点运行该命令一次。
- validateldap。确认 LDAP 配置正确运行。
注意: 如果启用 LDAP 认证,那么必须确保有一个管理员帐户采用 ClearQuest 认证。
您必须使用采用 ClearQuest 认证的管理员帐户运行 installutil 子命令。
原因如下:如果 LDAP 配置设置不一致、不正确或无效,那么 ClearQuest 将无法认证管理员凭证。
如果 LDAP 目录不可用,那么使用采用 ClearQuest 认证的管理员帐户运行这些子命令,可确保您可以访问 ClearQuest 管理功能。
ClearQuest 阻止具有管理员特权的用户将其自己的用户帐户设置成使用 LDAP 认证,但是不会阻止具有管理员特权的用户将其他管理员帐户设置成使用 LDAP 认证。
当运行 installutil 子命令来配置 ClearQuest 的 LDAP 认证时,您必须至少指定 ClearQuest 数据库集名称、管理员用户名和关联的管理员密码。
选项和自变量
- dbset_name
- 包含要启用 LDAP 认证的数据库的 ClearQuest 数据库集或连接的名称。
- cq_login
- ClearQuest 管理用户的登录名。该用户必须具有“超级用户”的特权,并标记为进行 ClearQuest 认证。
- cq_password
- ClearQuest 管理用户的密码。要指定空密码,请输入一对空双引号。
- –site site
- 在 Rational ClearQuest MultiSite 环境中,特定 MultiSite 站点的名称。如果使用该选项,那么该命令仅应用于指定的站点。如果省略该选项,那么该命令将应用于所有站点。
- –domain domain
- Rational ClearQuest 支持使用多个 LDAP 配置进行认证的环境。如果使用该选项,installutil 子命令仅应用于指定的 LDAP 域。如果省略该选项,那么该子命令将应用于所有域。
- specific_subcommand_argument
- 特定于 installutil 子命令的一个或多个自变量。
对于 installutil setldapinit 和 installutil
setldapsearch 子命令,您必须用双引号将自变量括起来。使用单引号将嵌套的参数列表及包含空格的字符串括起来。