Configura o modifica i database. Anche se è possibile utilizzare installutil
con diversi sottocomandi, la sintassi descritta in questa pagina di riferimento è
specifica per i sottocomandi utilizzati per configurare l'autenticazione utente LDAP.
Il programma di utilità della riga comandi installutil è disponibile solo su Windows.
Riepilogo
- installutil subcommand -dbset dbset_name cq_login cq_password [ –site site ]
[ –domain domain ] [ subcommand_arguments ...]
Descrizione
Utilizzare il comando installutil con
i seguenti sottocomandi:
- getauthenticationalgorithm. Visualizza l'algoritmo specificato dal sottocomando setauthenticationalgorithm.
- getcqldapmap. Visualizza la stringa specificata dal sottocomando setcqldapmap.
- getldapinit. Visualizza la stringa ldapsearch
specificata dal sottocomando setldapinit per la serie di database
specificata.
- getldapsearch. Visualizza la stringa specificata dal sottocomando setldapsearch
per la serie di database specificata.
- setauthenticationalgorithm. Controlla se Rational ClearQuest supporta
sia l'autenticazione LDAP che quella ClearQuest oppure solo l'autenticazione
ClearQuest per la serie di database specificata.
- setcqldapmap. Identifica il campo profilo utente ClearQuest
e l'attributo utente LDAP che ClearQuest utilizza
per associare un account utente nella serie di database ClearQuest
ad un account utente nella directory LDAP. Questo comando viene eseguito una volta per dominio, sito o entrambi, se applicabile.
- setldapinit. Imposta la stringa del parametro richiesto per
connettersi alla serie di database ClearQuest
sulla directory LDAP utilizzata per l'autenticazione. Viene eseguito una volta per dominio, sito o entrambi, se applicabile.
- setldapsearch. Specifica i criteri di ricerca LDAP da
utilizzare per trovare un account utente LDAP da autenticare. Viene eseguito una volta per dominio, sito o entrambi, se applicabile.
- validateldap. Conferma che una configurazione LDAP sta
funzionando correttamente.
Importante: Se si abilita l'autenticazione LDAP, è necessario mantenere un account amministratore che
sia autenticato da ClearQuest.
È necessario eseguire i sottocomandi installutil da un account amministratore che
utilizza l'autenticazione ClearQuest.
Il motivo è che ClearQuest non
può autenticare le credenziali dell'amministratore se le impostazioni di configurazione di
LDAP sono incongruenti, non corrette oppure in uno stato non funzionante.
L'esecuzione dei sottocomandi da un account amministratore che utilizza
l'autenticazione ClearQuest garantisce che sia possibile accedere alle funzioni amministrative ClearQuest
se la directory LDAP non è disponibile.
ClearQuest impedisce agli utenti con privilegi di amministratore di impostare il proprio account utente
per utilizzare l'autenticazione LDAP, ma non impedisce agli utenti con privilegi di amministratore
di impostare l'account di un altro amministratore per utilizzare l'autenticazione LDAP.
Come minimo, quando
si esegue un sottocomando installutil per configurare ClearQuest per
l'autenticazione LDAP, è necessario specificare il nome della serie di database ClearQuest,
il nome utente dell'amministratore e la password dell'amministratore associata.
Opzioni e argomenti
- -dbset dbset_name
- Il nome della serie di database ClearQuest o
della connessione che contiene il database da abilitare per l'autenticazione LDAP.
- cq_login
- Il nome di accesso dell'utente amministrativo ClearQuest. Questo utente deve disporre dei privilegi Super utente ed essere indicato per l'autenticazione ClearQuest.
- cq_password
- La password per l'utente amministrativo ClearQuest. Per specificare una password null, immettere una serie vuota di virgolette "".
- –site site
- In un ambiente Rational ClearQuest MultiSite, il nome di un sito Multisite specifico. Se si utilizza questa opzione, il comando si applica solo al sito specificato. Se si omette questa opzione, il comando si applica a tutti i siti.
- –domain domain
- Rational ClearQuest supporta
ambienti in cui è possibile utilizzare configurazioni LDAP multiple per
autenticare.
Se si utilizza questa opzione, il sottocomando installutil si applica solo al dominio LDAP specificato. Se si omette questa opzione, il sottocomando si applica a tutti i domini.
- subcommand_argument
- Uno o più argomenti specifici per il sottocomando installutil.
Per i sottocomandi installutil setldapinit e installutil setldapsearch,
è necessario racchiudere gli argomenti tra virgolette. Utilizzare dei singoli apici per racchiudere gli elenchi di parametri nidificati e le stringhe che includono degli spazi.