installutil

Sets up or modifies databases. Although you can use installutil with a variety of subcommands, the syntax described in this reference page is specific to subcommands used to configure LDAP user authentication. The installutil command line utility is available on Windows® only.

Synopsis

installutil subcommand dbset_name cq_login cq_password [ –site site ] [ –domain domain ] [ specific_subcommand_argument...]

Description

Use the installutil command with the following subcommands:

Note: If you enable LDAP authentication, you must keep one administrator account in Rational ClearQuest who is Rational ClearQuest authenticated. You must run these subcommands from an administrator account that uses Rational ClearQuest authentication; otherwise, Rational ClearQuest cannot authenticate the administrator's credentials if the LDAP configuration settings are in an inconsistent, incorrect, or nonfunctioning state. Running the subcommands from an administrator account that uses Rational ClearQuest authentication ensures that you can access Rational ClearQuest administrative functions if the LDAP directory is unavailable. Rational ClearQuest prevents users with administrator privileges from setting their own Rational ClearQuest user account to use LDAP authentication, but it does not prevent users with administrator privileges from setting another administrator's account to use LDAP authentication.

Every installutil subcommand that you use to configure Rational ClearQuest LDAP must specify, at a minimum, the Rational ClearQuest database set and the administrator's user name and password. The arguments must all be on one line.

Options and Arguments

dbset_name
Name of the database set or connection that contains the database to be enabled for LDAP.
cq_login
Rational ClearQuest login name of the administrative user. This user must have Super User privileges and be marked for Rational ClearQuest authentication.
cq_password
Rational ClearQuest password for the administrative user. To specify a null password enter an empty set of double quotes.
–site site
In a Rational ClearQuest MultiSite environment, the name of one specific MultiSite site. The command line applies to that site only. If you do not specify –site, the command line applies to all sites.
specific_subcommand_argument
One or more arguments specific to the installutil subcommand. For the setldapinit and setldapsearch subcommands you must enclose the arguments in double quotes. Use single quotes around interior parameter lists, and parameter strings that include spaces.

Feedback