Use the setupCQLDAP.pl Perl script from the command
line to set a user's authentication mode.
Rational® ClearQuest® provides the following
ways to set a user's authentication mode:
- Use the User Administration GUI.
- Write a Visual Basic or Perl script that calls the setLDAPAuthentication or setCQAuthentication API.
- Run the SetupCQLDAP.pl Perl script from the command line.
- Use the Import Wizard.
For information about using the Rational ClearQuest LDAP
APIs, see the API documentation. This section describes the syntax
for SetupCQLDAP.pl, which is installed in the \Rational\ClearQuest directory
on Windows.
Synopsis: setting mode to ClearQuest
- cqperl SetupCQLDAP.pl [ –help ] | [ –dbset database-set ]
[ –cqadminuser cq-admin-user ] [ –cqadminpassword cq-admin-pswd ]
[ –mode cq ] [ –cquser cq-user-name ]
[ –cqpassword cq-user-password ]
Synopsis: setting mode to LDAP
- cqperl SetupCQLDAP.pl [ –help ] | [ –dbset database-set ]
[ –cqadminuser cq-admin-user ] [ –cqadminpassword cq-admin-pswd ]
[ –mode ldap ] [ –cquser cq-user-name ]
[ –ldapuser ldap-user-name ]
Options and Arguments
- –help
- Displays a list of the command switches and a brief description
of each switch.
- –mode { cq | ldap }
- Sets the user's authentication mode to Rational ClearQuest or
LDAP. The default is LDAP.
- –cquser user-name
- Required. Identifies the Rational ClearQuest user
record to be set to the desired authentication mode. For users authenticated
by Rational ClearQuest,
this is the name that Rational ClearQuest users
enter in the Login window. For users authenticated by LDAP, this is
the user record's UserLoginName identifier. Rational ClearQuest stores
this name in the user profile field.
- –cqpassword cq-user-password
- Optional. Identifies the password that the user enters in the Rational Login
window. Specify this option only if you set the user's authentication
mode to Rational ClearQuest.
- –ldapuser ldap-user-name
- Optional. Identifies the login user name that Rational ClearQuest uses
to authenticate the user against the LDAP directory. If you set the
user's authentication mode to LDAP you can specify this option to
validate that the LDAP account exists. In addition to validating the
LDAP account, Rational ClearQuest copies
the mapping attribute value from the user's LDAP account to the user's Rational ClearQuest user
record.
- –dbset database-set
- Optional. The default is the default database set. Identifies
the name of the Rational ClearQuest database
set that contains the user profile record for the user whose authentication
mode you are setting. The script updates all user databases in the
database set. If the user belongs to multiple database sets, run the
script against each database set.
- –cqadminuser cq-admin-user
- Required. Identifies the login user name of the Rational ClearQuest administrator
who has administration privileges (Super User) for the database set.
- –cqadminpassword cq-admin-pswd
- Required. Identifies the password that the Rational ClearQuest administrator
uses to log in to the Rational ClearQuest database
set.