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 de traitement par lots
ou de mise à jour, la commande cqtsdbcrawler.pl enregistre le dernier
enregistrement traité avec succès dans le fichier batch_recovery.properties
et 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
- 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 -encrypt -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>"