cqtsdbcrawler

El mandato cqtsdbcrawler ejecuta el extractor de registros de la búsqueda de texto completo.

Sinopsis

cqperl cqtsdbcrawler.pl { -batch | -update | -optimize | -repair archivo_reparación } CQ-nombre_bd-nombre_conjuntobd.xml [ -site nombre_sitio ]
cqperl cqtsdbcrawler.pl -encrypt -s conjunto_bd -d nombre_bd -u usuario -p contraseña -kf nombre_archivo_clave_salida -pf nombre_archivo_contraseña_cifrada_salida -jvmpar "opciones_jvm"

Descripción

Aunque el índice se actualiza continuamente tras la configuración de la búsqueda de texto completo, existen circunstancias en las cuales resulta necesario utilizar el mandato cqtsdbcrawler.pl:
  • Para indexar registros por primera vez.
  • Para actualizar el índice de forma explícita.
  • Para volver a indexar los registros que todavía no se han procesado correctamente.
  • Para generar una contraseña cifrada y un archivo de claves.
  • Para optimizar el archivo de índice de búsqueda de texto completo de cara a mejorar el rendimiento.

Los registros que todavía no han sido procesados correctamente se registran en un archivo de reparación denominado record_type_time_stamp.xml y se graban en el mismo directorio en el cual se ha grabado el archivo de propiedades de búsqueda de ClearQuest, CQ-nombre_bd-nombre_conjuntobd.xml. El archivo se utiliza como entrada para cqtsdbcrawler.pl –repair.

Cuando la ejecución se lleva a cabo en modalidad de actualización o de proceso por lotes, cqtsdbcrawler.pl registra el último registro procesado satisfactoriamente en los archivos, batch_recovery.properties y update_recovery.properties, respectivamente. Estos archivos proporcionan puntos de entrada para el procesamiento cuando la ejecución del mandato se detiene y se reinicia. Se escriben en el directorio de inicio del usuario actual.

cqtsdbcrawler.pl se instala en el directorio de instalación del producto predeterminado.

Opciones y argumentos

–batch
Ejecuta el extractor en modalidad de proceso por lotes. Esta opción lee todos los registros configurados para la búsqueda de texto completo y los traslada a Solr para que Lucene los indexe. El procesamiento está relacionado directamente con la CPU y con ES; para evitar que el rendimiento se degrade, por consiguiente, posiblemente deseará ejecutar la modalidad de proceso por lotes cuando la utilización del sistema sea mínima.
–update
Ejecuta el extractor en modalidad de actualización. Esta opción supervisa la base de datos para la adición, la supresión o la modificación de registros. Este tipo de cambios en la base de datos se leen y se trasladan a Solr para indexarlos. (Esta es la opción de modalidad de ejecución predeterminada para la instancia de WebSphere Application Server Express del extractor; se proporciona para habilitar la misma funcionalidad desde la línea de mandatos).
–optimize
Optimiza el índice del motor de búsqueda de cara a mejorar el rendimiento.
–repair archivo_reparación
Ejecuta el extractor en modalidad de reparación. Los registros enumerados en archivo_reparación son los que no se han procesado correctamente en las modalidades de proceso por lotes o de actualización.
archivo_propiedades_búsqueda_cq
El archivo de propiedades de búsqueda de ClearQuest, generado por el mandato, cqtssetup.pl ... –o CQ.
–site sitio
El sitio predeterminado es <local>, que significa que la base de datos no se replica. Esta opción es obligatoria si la base de datos se replica: especifique el sitio (MultiSite) desde el cual desea recopilar los parámetros de configuración para la extracción de registros.
–s conjunto_bd
Nombre del conjunto de bases de datos.
–d nombre_bd
Nombre de la bases de datos.
-u usuario
Nombre del usuario.
-p contraseña
La contraseña.
-encrypt
Cifra la contraseña.
-kf archivo_clave
El archivo en el cual debe escribirse la clave de cifrado de contraseña.
-pf archivo_contraseña
El archivo en el cual debe escribirse la contraseña cifrada.
-jvmpar "opciones_jvm"
Utilice esta opción para definir las opciones de la Máquina Virtual Java (JVM).

Ejemplos

Ejecute cqtsdbcrawler.pl en modalidad de proceso por lotes:
cqperl cqtsdbcrawler.pl -batch CQ_SAMPLE-TextSearch.xml -site "<local>"
Ejecute cqtsdbcrawler.pl en modalidad de reparación:
cqperl cqtsdbcrawler.pl -repair ~bert/Defect207294053937.xml ~bert/CQ_SAMPLE-TextSearch.xml
Cree la contraseña cifrada y el archivo de salida:
cqperl cqtsdbcrawler.pl -encrypt -s TextSearch -d SAMPL -u admin -p admin_password -kf key.txt -pf password.txt
Optimice el archivo de índice de búsqueda de texto completo:
cqperl cqtsdbcrawler.pl -optimize CQ-SAMPL-TextSearch.xml
Ejecute cqtsdbcrawler.pl en modalidad de proceso por lotes con la opción de la JVM:
cqperl cqtsdbcrawler.pl -jvmpar "-Xms512m -Xmx1024m" -batch CQ_SAMPLE-TextSearch.xml -site "<local>"

Consulte también

cqtssetup.pl, setmasterpropertyfromfile


Comentarios