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