Configura ou modifica bancos de dados. Embora seja possível usar installutil com uma variedade de subcomandos, a sintaxe descrita nesta página de referência é específica para subcomandos usados para configurar a autenticação do usuário LDAP.
O utilitário de linha de comandos installutil está disponível apenas no Windows.
Sinopse
- installutil subcommand -dbset dbset_name cq_login cq_password [ –site site ]
[ –domain domain ] [ subcommand_arguments ...]
Descrição
Utilize o comando installutil com os
seguintes subcomandos:
- getauthenticationalgorithm. Exibe o algoritmo especificado
pelo subcomando setauthenticationalgorithm.
- getcqldapmap. Exibe a cadeia especificada pelo subcomando setcqldapmap.
- getldapinit. Exibe a cadeia ldapsearch especificada pelo
subcomando setldapinit para o conjunto de bancos de dados
especificado.
- getldapsearch. Exibe a cadeia especificada pelo subcomando setldapsearch para
o conjunto de bancos de dados especificado.
- setauthenticationalgorithm. Controla se Rational ClearQuest suporta
a autenticação de ClearQuest e LDAP ou apenas a autenticação de
ClearQuest para o conjunto de bancos de dados especificado.
- setcqldapmap. Identifica o campo do perfil do usuário ClearQuest e
o atributo de usuário LDAP que o ClearQuest utiliza
para mapear uma conta de usuário no conjunto de bancos de dados do ClearQuest para
uma conta de usuário no diretório LDAP. Este comando é executado uma vez por domínio, site ou ambos, se aplicável.
- setldapinit. Configura a cadeia do parâmetro requerida para
conectar um conjunto de bancos de dados do ClearQuest no
diretório LDAP utilizado para autenticação. É executado uma vez por domínio, site ou ambos, se aplicável.
- setldapsearch. Especifica o critério de procura LDAP utilizado para localizar
uma conta de usuário LDAP a ser autenticada. É executado uma vez por domínio, site ou ambos, se aplicável.
- validateldap. Confirma se uma configuração LDAP está funcionando corretamente.
Importante: Se você ativar a autenticação LDAP, é necessário manter uma conta do administrador, que é autenticada por ClearQuest.
Você deve executar os subcomandos installutil a partir de uma conta do administrador que use autenticação ClearQuest.
A razão é que ClearQuest não pode autenticar as credenciais do administrador se as definições de configuração LDAP estiverem inconsistentes, incorretas ou em um estado não funcional.
A execução dos subcomandos
em uma conta do administrador que utiliza a autenticação do ClearQuest
assegura que você poderá acessar as funções administrativas do ClearQuest
se o diretório do LDAP não estiver disponível.
ClearQuest evita que os usuários com privilégios de administrador configurem sua própria conta do usuário para usar a autenticação LDAP, mas não evita que os usuários com privilégios de administrador configurem outra conta de administrador para usar a autenticação LDAP.
No mínimo, ao executar um subcomando installutil para configurar ClearQuest para a autenticação LDAP, é necessário especificar o nome do conjunto de bancos de dados do ClearQuest, nome de usuário administrador e senha do administrador associada.
Opções e Argumentos
- -dbset dbset_name
- Nome do conjunto de bancos de dados do ClearQuest ou conexão que contém o banco de dados a ser ativado para a autenticação LDAP.
- cq_login
- O nome de login do usuário administrativo do ClearQuest. Este usuário deve ter privilégios de Superusuário
e ser marcado para autenticação do ClearQuest.
- cq_password
- Senha para o usuário administrativo do ClearQuest. Para especificar uma senha nula, insira um conjunto vazio de aspas duplas
"".
- –site site
- Em um ambiente do Rational ClearQuest MultiSite, o nome do site MultiSite específico. Se você usar esta opção, o comando aplica-se apenas ao site especificado. Se você omitir esta opção, o comando aplica-se a todos os sites.
- –domain domain
- Rational ClearQuest suporte para ambiente em que várias configurações do LDAP podem ser utilizadas para autenticação.
Se esta opção for usada, o subcomando installutil se aplicará apenas ao domínio LDAP especificado. Se omitir esta opção, o subcomando aplica-se a todos os domínios.
- subcommand_argument
- Um ou mais argumentos específicos ao subcomando installutil.
Para os subcomandos installutil setldapinit e installutil
setldapsearch, é necessário encerrar os argumentos em aspas duplas. Use aspas simples para encerrar as listas de parâmetros aninhadas e cadeias que incluem espaços.