Gerencia informações de conexão do conjunto de bancos de dados e do banco de dados
no registro do ClearQuest
no sistema UNIX e no Linux
Sinopse
O comando cqreg está localizado
no diretório bin do diretório de instalação do ClearQuest.
- Relate as informações de conexão para os conjuntos de bancos de dados e bancos de dados registrados:
- cqreg show [ -dbset dbset_name | -all ]
[ -terse | -errors | -verbose ] [ -help ] [ -effort_only ] [ -force
] [ -home cq_home ] [ -version cq_version ]
[ -cq_databases cq_databases ]
- Associe um diretório de instalação do ClearQuest
a um diretório de registro do banco de dados:
- cqreg initialize [ -associate ] [ registry_directory ]
[ -help ] [ -effort_only ] [ -force ] [ -verbose | -errors ] [ -home cq_home ]
[ -cq_databases cq_databases ]
- Registre um conjunto de bancos de dados e bancos de dados no registro do ClearQuest:
- cqreg add_dbset -v/endor db_vendor [ -s/erver db_server ]
[ -d/atabase db_name ] [ [ -u/ser user -p/assword password ]
] [ -dbset dbset_name ] [ -co connect_options ]
[ -help ] [ -effort_only ] [ -force ] [ -verbose | -errors ] [ -home cq_home ]
[ -cq_databases cq_databases ]
- Cancele o registro de um conjunto de bancos de dados e de bancos de dados do registro do ClearQuest:
- cqreg drop_dbset [ -dbset dbset_name ] [
-help ] [ -effort_only ] [ -force ] [ -verbose | -errors ] [ -home cq_home ]
[ -cq_databases cq_databases ]
- Atualize o registro do banco de dados com as informações no repositório de esquema:
- cqreg refresh [ -dbset dbset_name | -all
] [ -help ] [ -effort_only ] [ -force ] [ -verbose | -errors ] [ -home cq_home ]
[ -cq_databases cq_databases ]
Descrição
É possível criar, excluir e
mover bancos de dados do ClearQuest
apenas em um sistema Windows
usando a Ferramenta de Manutenção ou o Designer. Use o comando cqreg
para gerenciar informações de conexão associadas a conjuntos de bancos de dados e bancos de dados do ClearQuest
para que seja possível acessar os bancos de dados no sistema UNIX e no Linux.
O comando cqreg permite executar as seguintes tarefas:
- Relatar informações sobre os bancos de dados registrados
- Associar um diretório de instalação do ClearQuest
a um diretório de registro do banco de dados
- Conectar-se a um repositório de esquema e atualizar o registro do banco de dados após um banco de dados ser criado ou excluído usando a Ferramenta de Manutenção ou o Designer
Também é possível incluir e remover conexões com o banco de dados do
ClearQuest Client
em execução em um sistema UNIX ou Linux.
Opções e Argumentos
- -dbset dbset_name
- Nome da conexão com o banco de dados. Por padrão, esta é a versão do ClearQuest.
- -all
- Executa o comando em todos os conjuntos de bancos de dados e bancos de dados no interior dos conjuntos de bancos de dados.
- -verbose
- -errors
- -terse
- Controla a quantidade de saída que o comando exibe. Se omitida, o padrão se torna -errors.
- -effort_only
- Exibe o que o subcomando faz sem executar a ação associada.
- -force
- Força o subcomando a substituir dados ou arquivos de registro existentes que, do contrário, não seriam sobrescritos.
- -home cq_home
- Identifica o diretório de instalação do ClearQuest. Este valor substitui o valor da variável de ambiente $CQ_HOME, se configurado.
- -version version
- Use com o subcomando cqreg show para identificar a versão do produto ClearQuest
a que o subcomando se aplica. Se esta opção for omitida, a versão associada ao release atual será usada.
- -cq_databases cq_databases
- Especifica o local do diretório em que as conexões com o banco de dados são armazenadas. Este valor substitui o valor da variável de ambiente $CQ_DATABASES, se configurado.
- -associate
- Use com o subcomando cqreg initialize para associar o diretório de instalação do ClearQuest
a um diretório de registro de banco de dados. Se esta opção for omitida, o subcomando cqreg initialize inicializa o diretório de registro apenas, sem fazer a associação.
- registry_directory
- Use com o subcomando cqreg initialize para especificar o diretório do registro. Se esta opção for omitida, um dos valores a seguir será usado, listados em ordem decrescente:
- O valor de -cq_databases cq_databases, se especificado
- O valor da variável de ambiente $CQ_DATABASES, se configurado
- O valor-padrão
- -v/endor db_vendor
- Fornecedor do banco de dados. Os valores a seguir são válidos:
- -s/erver server
- Servidor do banco de dados.
- -d/atabase db_name
- Para DB2 e SQL Server,
o nome do banco de dados usado para o repositório de esquema. Para Oracle, o System Identifier (SID) do sistema de gerenciamento de banco de dados.
- -u/ser user_name
- Nome de usuário para acessar o banco de dados.
- -p/assword password
- Senha para acessar o banco de dados.
- -co connect_options
- Opções de conexão. Entre em contato com o administrador do seu sistema para as opções de conexão específicas para seu ambiente. Consulte também o tópico da ajuda Administrando o Rational ClearQuest nas propriedades de banco de dados do fornecedor.
- -help
- Exibe informações de uso.
Subcomandos
- cqreg show
- Relata informações de conexão para os conjuntos de bancos de dados e bancos de dados registrados.
- cqreg initialize
- Associa um diretório de instalação do ClearQuest
a um diretório de registro do banco de dados. Se o arquivo .Databases já existir quando o subcomando cqreg initialize for executado, ele não será substituído a menos que a opção -force seja usada.
Atenção: O subcomando cqreg initialize é executado como
parte da instalação do ClearQuest.
Execute esse subcomando apenas se desejar associar um diretório de instalação do ClearQuest a
um diretório de registro de banco de dados diferente.
- cqreg add_dbset
- Registre um conjunto de bancos de dados e bancos de dados no registro do ClearQuest ou atualize informações
de conexão existentes. Execute este subcomando após criar o repositório de esquema e bancos de dados do usuário usando o Designer.
- cqreg register
- Este subcomando está obsoleto. Use o comando cqreg add_dbset no lugar.
- cqreg drop_dbset
- Cancele o registro de um conjunto de bancos de dados e de bancos de dados do registro do ClearQuest. Execute este subcomando após um conjunto de bancos de dados ser movido para um host diferente para cancelar o registro do conjunto de bancos de dados. Depois, execute o comando cqreg add_dbset para registrar o conjunto de bancos de dados no novo host.
Se não for especificado um nome de conexão com a opção e argumento -dbset dbset_name, respectivamente, ao executar o subcomando cqreg drop_dbset, a conexão padrão será usada.
- cqreg unregister
- Este subcomando está obsoleto. Use o comando cqreg drop_dbset no lugar.
- cqreg refresh
- Atualiza o registro do banco de dados a partir das informações no repositório de esquema. Use este subcomando após usar a Ferramenta de Manutenção ou o Designer para criar, modificar ou excluir um banco de dados ou após mover repositórios de esquema e bancos de dados. Se o subcomando cqreg refresh não reestabelecer a conexão, use os subcomandos cqreg drop_dbset e cqreg add_dbset para descartar e recriar as informações de conexão com o banco de dados.
Exemplos
- Mostrar as informações de conexão sobre todos os conjuntos de bancos de dados e bancos de dados registrados:
- Atualizar o registro de banco de dados para o conjunto de bancos de dados UCM_dbset com as informações no repositório de esquema:
cqreg refresh -dbset UCM_dbset
- A seguir estão exemplos de inclusão de conexões para os bancos de dados
Oracle, SQL Server e DB2, respectivamente:
- Para Oracle:
cqreg add_dbset -v Oracle -s cqtest1 -d CQ1 -u admin -p admin_pwd -dbset CQ_DEV1 -co "PORT=50100"
- Para SQL Server:
cqreg add_dbset -v SQL_Server -s cqtest2 -d msitea -u admin -p pwd -dbset CQ_DEV1
- Para DB2:
cqreg add_dbset -v DB2 -s db2tcpnode -d msiteb -u admin -p pwd -dbset CQ_DEV3
- Cancelar o registro do conjunto de bancos de dados UCM_dbset:
cqreg drop_dbset -dbset UCM_dbset