O comando cqtsdbcrawler executa o extrator de registro da procura de texto completo.
Sinopse
- cqperl cqtsdbcrawler.pl { -batch | -update | -optimize | -repair repair_file } CQ-db_name-dbset_name.xml [ -site site_name ]
- cqperl cqtsdbcrawler.pl -encrypt -s dbset -d dbname -u user -p password -kf output_key_file_name -pf output_encrypted_password_file_name -jvmpar "jvm_options"
Descrição
Embora o índice seja atualizado continuamente
após a configuração da procura de texto completo, há circunstâncias em que
é necessário utilizar o comando
cqtsdbcrawler.pl:
- Para indexar registros pela primeira vez.
- Para atualizar o índice explicitamente.
- Para reindexar registros que não foram processados corretamente.
- Para gerar uma senha criptografada e um arquivo de chave.
- Para otimizar o arquivo de índice de procura de texto completo para melhorar o desempenho.
Os registros não processados corretamente são registrados em um
arquivo de reparo denominado record_type_time_stamp.xml e
gravados no mesmo diretório no qual o arquivo de propriedades de procura do ClearQuest,
CQ-dbname-dbset-name.xml, é gravado. Utilize o arquivo como entrada para cqtsdbcrawler.pl –repair.
Quando executado em modos em lote ou de atualizações, cqtsdbcrawler.pl registra o último registro processado com sucesso nos arquivos batch_recovery.properties e update_recovery.properties, respectivamente. Esses arquivos fornecem os pontos de partida para processamento quando a
execução do comando é interrompida e reiniciada. Eles são gravados no diretório inicial
do usuário atual.
cqtsdbcrawler.pl é instalado
no diretório de instalação padrão do produto.
Opções e Argumentos
- –batch
- Executa o extrator no modo em lote. Essa opção lê todos os registros que
foram configurados para a procura de texto completo e os transmite para o Solr para indexação
por Lucene. O processamento é limitado pela CPU e pela ES, portanto, para evitar diminuição no
desempenho, talvez você queira executar o modo em lote quando o uso do sistema for mínimo.
- –update
- Executa o extrator no modo de atualização. Essa opção monitora o banco de dados para
inclusão, exclusão ou modificação de registros. As alterações feitas no
banco de dados são lidas e transmitidas para o Solr para indexação. (Essa opção é o modo de
execução padrão para a instância do WebSphere Application Server Express do extrator;
ela é fornecida para ativar a mesma funcionalidade a partir da linha de comandos.)
- –optimize
- Otimiza o índice do mecanismo de procura para melhorar o desempenho.
- –repair repair_file
- Executa o extrator no modo de reparo. Os registros listados em repair_file são
aqueles não processados corretamente nos modos de lote ou de atualização.
- cq_search_properties_file
- O arquivo de propriedades de procura do ClearQuest, que é gerado pelo comando,
cqtssetup.pl ... –o CQ.
- –site site
- O site padrão é <local>, o que significa que o banco de dados
não está replicado. Essa opção será necessária se o banco de dados estiver replicado: especifique
o site (MultiSite) a partir do qual reunirá os parâmetros de configuração para extração de
registro.
- –s dbset
- Nome do conjunto de bancos de dados.
- –d dbname
- Nome do banco de dados.
- -u user
- O nome do usuário.
- -p password
- A senha.
- -encrypt
- Criptografa a senha.
- -kf key_file
- O arquivo no qual a chave de criptografia de senha será gravada.
- -pf password_file
- O arquivo no qual a senha criptografada será gravada.
- -jvmpar "jvm_options"
- Use para configurar as opções do Java Virtual Machine (JVM).
Exemplos
Execute
cqtsdbcrawler.pl no modo em lote:
cqperl cqtsdbcrawler.pl -batch CQ_SAMPLE-TextSearch.xml -site "<local>"
Execute
cqtsdbcrawler.pl no modo de reparo:
cqperl cqtsdbcrawler.pl -repair ~bert/Defect207294053937.xml ~bert/CQ_SAMPLE-TextSearch.xml
Crie a senha criptografada e o arquivo de senha:
cqperl cqtsdbcrawler.pl -encrypt -s TextSearch -d SAMPL -u admin -p admin_password -kf key.txt -pf password.txt
Otimize o arquivo de índice de procura de texto completo:
cqperl cqtsdbcrawler.pl -optimize CQ-SAMPL-TextSearch.xml
Execute
cqtsdbcrawler.pl no modo em lote
com a opção JVM:
cqperl cqtsdbcrawler.pl -jvmpar "-Xms512m -Xmx1024m" -batch CQ_SAMPLE-TextSearch.xml -site "<local>"