cqtsdbcrawler

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>"

Consulte também

cqtssetup.pl, setmasterpropertyfromfile


Feedback