Mantenimiento de la búsqueda de texto completo

El mantenimiento de la búsqueda de texto completo implica tareas ocasionales, como por ejemplo reparar registros problemáticos, depurar los archivos de registro de operaciones, optimizar el índice, ajustar el rendimiento de Solr y actualizar la configuración para acomodar cambios en el esquema.

Reparación de registros problemáticos

A veces, cuando el extractor de registros se ejecuta en modalidad de actualización o de proceso por lotes, es posible que no pueda procesar los registros. Cuando esto sucede, el extractor de registros crea archivos de reparación correspondientes a los registros anómalos. Los archivos de reparación se graban en el directorio donde reside el archivo de propiedades de búsqueda de ClearQuest, CQ-nombre_bd-nombre_conjuntobd.xml que es normalmente el directorio padre de Solr. Supervise este directorio para comprobar si hay casos de proceso anómalo y utilice el extractor de registros en modalidad de reparación para procesar los registros problemáticos. Consulte la ayuda de consulta de cqtsdbcrawler para ver información de uso.

Depuración de registros de operaciones

De manera predeterminada, no se produce ninguna depuración del registro de operaciones (oplog) en la base de datos actual. Cuando implementa una política de barrido del registro de operaciones para minimizar el espacio desaprovechado, sea prudente a fin de evitar la eliminación de registros de operaciones antes de tiempo. Los registros de operaciones deben existir durante un periodo de tiempo lo suficientemente amplio para que el extractor de registros en modalidad de actualización los procese. Si el extractor de registros en modalidad de actualización no se ejecuta durante un largo periodo de tiempo, cuando se reanuda, empieza procesando los registros de operaciones de actualización con mayor antigüedad que no se han procesado.

Si está ejecutando ClearQuest MultiSite, la política de barrido del registro de operaciones de búsqueda de texto completo no debe ser más agresiva que la política existente de barrido del registro de operaciones de ClearQuest MultiSite.

Consulte la ayuda de ClearQuest Multisite sobre el barrido del registro de operaciones para obtener detalles.

Volver al principio

Optimización del índice

Con el tiempo, conforme se añaden, modifican o suprimen nuevos registros de ClearQuest, el índice de Lucene pasa a estar fragmento, lo que puede reducir el rendimiento.

Para optimizar el índice, realice los pasos siguientes:
  1. Cambie el directorio al directorio padre de ClearQuest.
  2. En el indicador de mandatos, ejecute el extractor de registros en modalidad de optimización:
    cqperl cqtsdbcrawler.pl -optimize CQ-nombre_bd-nombre_conjuntobd.xml -site nombre_sitio

Si no está ejecutando ClearQuest MultiSite, puede omitir la opción -site. Consulte la ayuda de consulta de cqtsdbcrawler para ver información de uso.

Volver al principio

Ajuste del rendimiento de Solr

El motor de búsqueda de Solr no debe afectar negativamente al rendimiento de ClearQuest. Sin embargo, si sospecha que es así, en primer lugar intente optimizar el índice de Lucene, tal como se ha descrito en la sección anterior. Además, considere las medidas siguientes para optimizar el rendimiento de Solr:

  • Aumentar la asignación de memoria de la JVM (Java Virtual Machine). En lugar de iniciar Solr con la asignación de memoria predeterminada, asigne Xms512M y Xmx1024M.

    Tenga en cuenta que es posible que necesite aumentar temporalmente la asignación de memoria de la JVM cuando ejecute el extractor de registros en modalidad de proceso por lotes y a continuación restablecerla.

  • Mueva el directorio padre de Solr a una unidad de disco duro secundaria rápida. Los motores de búsqueda utilizan muchos recursos de disco duro, procesador y memoria, especialmente si tiene un índice grande. Moviendo el directorio padre de Solr a una unidad de disco duro secundaria rápida con 10.000 RPM y un tiempo rápido de búsqueda, el rendimiento de Solr mejorará considerablemente en comparación con una unidad de disco duro de 54.000 RPM. Incluso utilizando una partición que no sea la partición del sistema operativo puede mejorar el rendimiento.
  • Aumente la memoria física del servidor, el número de procesadores y la velocidad del reloj.
  • Ajuste los valores de rendimiento en el archivo de configuración de Solr solrconfig.xml. Consulte el sitio web de Solr para obtener detalles.
  • Reduzca el número de tipos de registro y campos asociados que está indexando.
  • Instale Solr en un servidor dedicado.
  • Habilite la configuración maestra y esclava de Solr. Esta configuración consume el doble de espacio de disco de la configuración predeterminada de índice de Lucene, pero proporciona rendimiento fiable incluso si se realiza una fuerte demanda sobre el índice.
  • Consulte el sitio web de Solr para obtener consejos de ajustes de rendimiento adicionales.

Volver al principio

Cómo acomodar cambios de esquema

Los cambios en el esquema de base de datos a menudo requieren cambios correspondientes en el esquema de búsqueda. A continuación se muestran algunos ejemplos:
  • Adición de una entidad nueva. Si la nueva entidad es un tipo de registro que se puede enviar que desea que se pueda buscar utilizando la búsqueda de texto completo de ClearQuest, debe actualizar el archivo de propiedades de búsqueda de ClearQuest, CQ-nombre_bd-nombreconjunto_bd.xml, y el archivo de esquema de Solr, schema.xml, para dar cuenta del nuevo tipo de registro. Para ello, repita los pasos siguientes, que ha realizado anteriormente:
    1. Cree y edite el archivo de entidades.
    2. Cree y edite el archivo de propiedades de búsqueda de ClearQuest.
    3. Cree el archivo de búsqueda de Solr.
    4. Configure los registros que desea indexar actualizando el archivo de esquema de Solr schema.xml y reiniciando Solr.
    5. Ejecute el submandato installutil setmasterpropertyfromfile para subir el archivo de propiedades de búsqueda de ClearQuest, CQ-nombre_bd-nombre_conjuntobd.xml, a la base de datos de usuario.

    El extractor de registros en modalidad de actualización utilizará el archivo de propiedades de búsqueda de ClearQuest actualizado la próxima vez que se indexe.

  • Adición de un campo a una entidad. Si añade un nuevo campo a una entidad que es un tipo de registro que se puede enviar y desea que se indexe el campo, siga el mismo procedimiento que se acaba de describir para añadir una nueva entidad.
  • Cómo renombrar una entidad. Si renombra una entidad en el esquema de ClearQuest, siga el mismo procedimiento que se acaba de describir para añadir una nueva entidad. Además, necesita realizar estos pasos:
    1. Indexe de nuevo el tipo de registro renombrado:
      1. Cree un nuevo archivo de propiedades de búsqueda de ClearQuest que contenga sólo el tipo de registro renombrado.
      2. Ejecute el extractor de registros en modalidad de proceso por lotes (cqperl cqtsdbcrawler.pl -batch).
    2. Suprima todos los tipos de registro que pertenezcan al nombre de entidad anterior emitiendo el siguiente mandato de Solr:
      En Windows:
      1. cd %SOLR_HOME%\suNombreEsquema\Solr\exampledocs\
      2. java -Ddata=args -jar post.jar "<delete><query>record_type:nombreTipoRegistro</query></delete>"
      En el sistema UNIX y Linux:
      1. cd $SOLR_HOME/suNombreEsquema/Solr/exampledocs/
      2. java -Ddata=args -jar post.jar "<delete><query>record_type:tipo_registro</query></delete>"
  • Cómo renombrar un campo de una entidad. Si renombra un campo de una entidad en el esquema de ClearQuest, siga el mismo procedimiento que se acaba de describir para renombrar una entidad.

Volver al principio


Feedback