cqtsdbcrawler

La commande cqtsdbcrawler exécute l'extracteur d'enregistrements de recherche en texte intégral.

Syntaxe

cqperl cqtsdbcrawler.pl { -batch | -update | -optimize | -repair fichier_réparation } CQ-nom_bd-nom_ensemble_bd.xml [ -site nom_site ]
cqperl cqtsdbcrawler.pl -encrypt -s ensemblebd -d nombd -u utilisateur -p motdepasse -kf nom_fichier_clés_de_sortie -pf nom_fichier_motdepasse_chiffré_de_sortie -jvmpar "options_jvm"

Description

Bien que l'index soit mis à jour régulièrement une fois la recherche en texte intégral configurée, il reste un certain nombre de cas dans lesquels vous devez utiliser la commande cqtsdbcrawler.pl :
  • Pour indexer des enregistrements pour la première fois.
  • Pour mettre à jour l'index de façon explicite.
  • Pour réindexer des enregistrements qui n'ont pas été traités correctement.
  • Pour générer un mot de passe chiffré et un fichier de clés.
  • Pour optimiser le fichier d'index pour les recherches en texte intégral afin d'améliorer les performances.

Les enregistrements qui n'ont pas été traités correctement sont consignés dans un fichier de réparation appelé horodatage_type_enregistrement.xml, écrit dans le même répertoire que celui où est écrit le fichier des propriétés de recherche ClearQuest, CQ-nombd-nom_ensemblebd.xml. Ce fichier sert d'entrée pour la commande cqtsdbcrawler.pl –repair.

Lorsqu'elle est exécutée en mode lot ou mise à jour, la commande cqtsdbcrawler.pl enregistre le dernier enregistrement traité avec succès dans le fichier .batch_recovery.properties ou .update_recovery.properties, respectivement. Ces fichiers servent de point de départ pour le traitement, lorsque l'exécution de la commande est interrompue et relancée. Ils sont stockés dans le répertoire personnel de l'utilisateur.

La commande cqtsdbcrawler.pl est installée dans le répertoire d'installation du produit par défaut.

Options et arguments

–batch
Exécute l'extracteur en mode de traitement par lots. Cette option lit tous les enregistrements qui ont été configurés pour la recherche en texte intégral et les transmet à Solr pour indexation par Lucene. Ce traitement utilise des ressources d'UC et d'E/S. Pour éviter une dégradation des performances, il est donc préférable d'exécuter le mode de traitement par lots lorsque l'utilisation du système est minimale.
–update
Exécute l'extracteur en mode mise à jour. Cette option recherche les enregistrements ajoutés, supprimés ou modifiés dans la base de données. Toute modification de ce type dans la base de données est lue puis transmise à Solr pour indexation. (Cette option est le mode d'exécution par défaut pour l'instance WebSphere Application Server Express de l'extracteur ; elle est fournie dans le but de pouvoir bénéficier de la même fonctionnalité à partir de la ligne de commande.)
–optimize
Optimise le fichier d'index pour les recherches afin d'améliorer les performances.
–repair fichier_réparation
Exécute l'extracteur en mode réparation. Les enregistrements répertoriés dans fichier_réparation sont ceux qui n'ont pas été traités correctement en mode de traitement par lots ou de mise à jour.
fichier_propriétés_de_recherche_cq
Fichier de propriétés de recherche ClearQuest, généré par la commande cqtssetup.pl ... –o CQ.
–site site
Le site par défaut est <local>, ce qui signifie que la base de données n'est pas répliquée. Cette option est obligatoire si la base de données est répliquée : indiquez le site (MultiSite) à partir duquel les paramètres de configuration doivent être réunis pour l'extraction des enregistrements.
–s ensemble_bases_de_données
Nom de l'ensemble de bases de données.
–d nom_base_de_données
Nom de la base de données.
-u utilisateur
Nom d'utilisateur.
-p motdepasse
Mot de passe.
-encrypt motdepasse
Chiffre le mot de passe.
-kf fichier_clés
Fichier dans lequel la clé de chiffrement du mot de passe doit être écrite.
-pf fichier_motdepasse
Fichier dans lequel le mot de passe chiffré doit être écrit.
-jvmpar "options_jvm"
Permet de définir les options Java Virtual Machine (JVM) options.

Exemples

Exécutez cqtsdbcrawler.pl en mode de traitement par lots :
cqperl cqtsdbcrawler.pl -batch CQ_SAMPLE-TextSearch.xml -site "<local>"
Exécutez cqtsdbcrawler.pl en mode réparation :
cqperl cqtsdbcrawler.pl -repair ~bert/Defect207294053937.xml ~bert/CQ_SAMPLE-TextSearch.xml
Créez le mot de passe chiffré et le fichier de clés :
cqperl cqtsdbcrawler.pl -s TextSearch -d SAMPL -u admin -p motdepasse_admin -kf key.txt -pf password.txt
Optimisez le fichier d'index pour les recherches en texte intégral :
cqperl cqtsdbcrawler.pl -optimize CQ-SAMPL-TextSearch.xml
QExécutez cqtsdbcrawler.pl en mode de traitement par lots avec l'option JVM :
cqperl cqtsdbcrawler.pl -jvmpar "-Xms512m -Xmx1024m" -batch CQ_SAMPLE-TextSearch.xml -site "<local>"

Voir aussi

cqtssetup.pl, setmasterpropertyfromfile


Retour d'informations