cqtsadmin.pl automatise les étapes d'installation, de configuration et d'administration
de la recherche en texte intégral d'IBM® Rational
ClearQuest.
Syntaxe
- cqperl cqtsadmin.pl --username nom_super_utilisateur --password mot_de_passe --dbset ensemble_bases_de_données --userdb nom_connexion --ftshome rép_base_cqfts [options]
Description
cqtsadmin.pl est l'un des deux composants de l'outil d'administration de recherche en texte intégral. L'autre
composant est cqtsadmin-dbset-userdb.xml,
qui est généré par le script cqtsadmin.pl. Le fichier cqtsadmin-ensemble_bases_de_données-base_de_données_utilisateur.xml fournit et conserve les données relatives au déploiement de la recherche en texte intégral. Editez cqtsadmin-ensemble_bases_de_données-base_de_données_utilisateur.xml pour terminer votre déploiement. Toutes les options de ligne de commande fonctionnent de la même manière
sous Windows, UNIX ou Linux à l'exception de scrub_oplog qui n'est pas disponible sous UNIX ou Linux.
Important : Pour exécuter la commande
cqtsadmin.pl, la variable d'environnement
CQFTS_AppServer_HOME doit être définie sur le répertoire où WebSphere Application Server est installé.
Dans certains cas, comme lorsque vous installez ClearQuest dans un profil WebSphere Application existant ou lorsque vous installez la fonction de recherche en texte intégral sur un système séparé qui accède à distance aux serveurs Web ClearQuest, la variable d'environnement
CQFTS_AppServer_HOME
n'est pas définie et une erreur identique à celle-ci est affichée :
Impossible de déterminer le répertoire de base du serveur d'applications WebSphere. Voir le manuel ClearQuest Full-Text Search Administrator Guide pour savoir comment le définir via la variable d'environnement CQFTS_AppServer_HOME.
Pour résoudre le problème,
définissez la variable CQFTS_AppServer_HOME sur le répertoire où WebSphere Application Server est installé.
Par exemple, définissez la variable comme suit :
- Sur les systèmes d'exploitation Windows :
- set CQFTS_AppServer_HOME=C:\Program Files\IBM\WebSphere\AppServer
- Sur les systèmes d'exploitation UNIX et Linux :
- setenv CQFTS_AppServer_HOME /opt/IBM/WebSphere/AppServer
Important : Les arguments dbset, userdb et ftshome sont sensibles à la casse. Vous devez maintenir la même casse tout au long de l'utilisation du script cqtsadmin.pl. Sinon, le déploiement de la recherche en texte intégral pourrait être reconfiguré.
L'option ftshome
Lorsque vous déployez la recherche en texte intégral ou que vous faites référence à un déploiement, les arguments des options de ligne de commande nécessaires ftshome, dbset
et userdb définissent l'emplacement des données de votre déploiement. L'exemple suivant indique comment créer un nouveau déploiement de la recherche en texte intégral
ClearQuest sur l'unité D dans le répertoire CQ.Search.
S'il n'existe pas déjà, le répertoire est créé. Le sous-répertoire TextSearch_SAMPL est créé
dans le répertoire précédent. Le nom du sous-répertoire est généré à partir du nom de votre ensemble de bases de données ClearQuest et du nom de votre base de données utilisateur logique ClearQuest. Le sous-répertoire contient les données relatives à la recherche en texte intégral pour ce déploiement.
- cqperl cqtsadmin.pl --username admin --password “” --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --init_cq_fts --create_fts_was_profile manual --fts_was_profile_home D:\FTS.WASprofiles
Après que le répertoire D:\CQ.Search\TextSearch_SAMPL est créé,
il devient l'emplacement du déploiement de la recherche en texte intégral
pour l'ensemble de bases de données TextSearch et la base de données utilisateur SAMPL. Toutes les données
et les paramètres qui sont liés à ce déploiement sont créés dans ce répertoire. Les commandes suivantes que vous exécutez et qui utilisent la même valeur pour les arguments ftshome, dbset et userdb
s'appliquent à ce répertoire.
Pour déployer la recherche en texte intégral pour une deuxième base de données utilisateur ClearQuest, indiquez les options de ligne de commande obligatoires qui se rapportent à cette seconde base de données utilisateur ClearQuest. Les bases de données utilisateur supplémentaires ClearQuest déploieront les configurations de la recherche en texte intégral qui sont basées sur les arguments
ftshome indiqués et la structure de sous-répertoire générée.
- cqperl cqtsadmin.pl --username admin --password “” --dbset
TextSearch --userdb PROD --ftshome D:\CQ.Search --init_cq_fts --create_fts_was_profile
manual --fts_was_profile_home D:\FTS.WASprofiles
Tableau 1. Structure du répertoire de déploiement de la recherche en texte intégralRépertoire ou fichier |
Description |
rép_base_fts\base_de_données_utilisateur_ensemble_bases_de_données\logs\ |
Ce répertoire contient les journaux de chaque commande que vous exécutez sur ce déploiement. Référencez ce répertoire pour obtenir
l'historique des commandes que vous avez utilisées, la date de leur utilisation et leurs statuts. Le service de support logiciel IBM pourrait examiner ces journaux lorsqu'il vous aide à résoudre un problème. Les mots de passe s'affichent sous la forme d'astérisques (*) dans les journaux et la sortie d'écran, et non en texte normal. |
rép_base_fts\base_de_données_utilisateur_ensemble_bases_de_données\Solr\solr\conf\schema.xml |
Ce fichier est un des fichiers de configuration
que le moteur de recherche utilise pour déterminer les zones à indexer et à rechercher. Lorsque la commande cust_solr_files est exécutée, les zones dans ce fichier sont personnalisées pour établir une correspondance des zones dans vos types d'enregistrement comme indiqué par votre fichier d'entité. Vous pouvez être amené à éditer ce fichier pour le personnaliser davantage si votre base de données ClearQuest n'est pas en anglais.
Voir Activation de la recherche en texte intégral sur une base de données non-anglaise pour plus d'informations.
|
rép_base_fts\base_de_données_utilisateur_ensemble_bases_de_données\Solr\solr\data\index\ |
Ce répertoire contient l'index réel de votre déploiement. Avertissement : Ne modifiez pas le contenu de ce répertoire. La modification du répertoire pourrait compromettre l'intégrité de votre déploiement et pourrait nécessiter une réindexation ou un redéploiement.
|
rép_base_fts\base_de_données_utilisateur_ensemble_bases_de_données\AboutThisFTS.txt |
Ce fichier est généré une seule fois pendant le déploiement initial de la recherche en texte intégral. Il contient des informations sur le déploiement que vous devez peut-être consulter. Le service de support logiciel IBM pourrait examiner ce fichier lorsqu'il vous aide à résoudre un problème. |
rép_base_fts\base_de_données_utilisateur_ensemble_bases_de_données\CQ-ensemble_bases_de_données-base_de_données_utilisateur.xml |
Ce fichier représente le fichier XML de propriétés de la recherche en texte intégral de ClearQuest. Le fichier contient les données relatives aux lots et à l'indexation de mise à jour, au serveur de recherche, à votre profil de connexion, et des types d'enregistrement ainsi que les zones à indexer et à rechercher. Le service de support logiciel IBM examine ce fichier lorsqu'il vous aide à résoudre un problème. |
rép_base_fts\base_de_données_utilisateur_ensemble_bases_de_données\cqtsadmin-ensemble_bases_de_données-base_de_données_utilisateur.xml |
Ce fichier contient la configuration d'administration de la recherche en texte intégral. Le fichier contient les données relatives à votre déploiement. La majorité des données
sont définies au cours du déploiement, mais vous pourriez avoir à éditer ce fichier afin de personnaliser certains paramètres. Le service de support logiciel IBM examine ce fichier lorsqu'il vous aide à résoudre un problème. |
rép_base_fts\base_de_données_utilisateur_ensemble_bases_de_données\Entity-ensemble_bases_de_données-base_de_données_utilisateur.txt |
Le fichier d'entité contient une liste des types d'entité et de leurs zones, pour lesquels la recherche est activée. Lors du déploiement, vous pouvez être amené à éditer ce fichier pour supprimer les types d'enregistrement ou les zones que vous ne voulez pas rechercher. Après avoir terminé le déploiement, ne modifiez pas ce fichier. Le service de support logiciel IBM examine ce fichier lorsqu'il vous aide à résoudre un problème. |
Support de langue nationale
Pour
utiliser le script cqtsadmin.pl sur un système d'exploitation non-anglais,
définissez la variable d'environnement système LANGUAGE sur l'une des valeurs prises en charge suivantes :
- en Anglais (Etats-Unis ; par défaut)
- de Allemand (Allemagne)
- fr Français (France)
- it Italien (Italie)
- br Portugais (Brésil)
- es Espagnol (Espagne)
- cn Chinois simplifié (Chine)
- hk Chinois traditionnel (Hong Kong, Région administrative
spéciale de Chine)
- tw Chinois traditionnel (Taïwan ; comme hk)
- ja Japonais (Japon)
- ko Coréen (Corée du Sud)
Si LANGUAGE indique une valeur non prise en charge, cqtsadmin.pl échoue
et génère un message d'erreur.
Options et arguments
Le script cqtsadmin.pl dispose des options de ligne de commande obligatoires et des options de ligne de commande facultatives.
Vous devez fournir les options de ligne de commande obligatoires à chaque fois que vous exécutez le script. Si l'un des paramètres des options obligatoires est incorrect, l'outil échoue avec un message d'erreur. L'outil authentifie l'utilisateur par rapport à la base de données ClearQuest avant d'effectuer une action.
Vous devez fournir au moins une option de ligne de commande facultative lors de l'exécution du script cqtsadmin.pl.
- Options de ligne de commande obligatoires
- username nom_super_utilisateur
- Nom d'utilisateur ClearQuest
avec des privilèges de superutilisateur.
- password mot_de_passe
- Mot de passe de l'utilisateur ClearQuest
- dbset ensemble_bases_de_données
- Nom d'ensemble de bases de données ClearQuest. La valeur est sensible à la casse.
- userdb nom_connexion
- Nom de la base de données utilisateur ClearQuest. La valeur est sensible à la casse.
- ftshome rép_base_cqfts
- Répertoire de base de la recherche en texte intégral ClearQuest. Cette option contient tous les fichiers de configuration qui sont liés à ce déploiement, ainsi que les fichiers Solr, les paramètres et l'index Lucene. La valeur est sensible à la casse.
Options de ligne de commande facultatives
Les options de ligne de commande facultatives effectuent des actions caractéristiques sur le déploiement de la recherche en texte intégral ClearQuest.
Toutes les commandes génèrent une sortie d'information, de progression, d'avertissement,
d'erreur et d'instruction. La sortie d'instruction vous permet de récupérer suite à une erreur. La sortie affichée est également consignée dans le répertoire de journaux.
Ces données de journal sont utiles lorsque vous essayez de déboguer ou de suivre votre action sur un déploiement, parce que vous n'avez pas besoin de rediriger la sortie d'écran vers un fichier. En général, les commandes n'échouent pas. Si un échec se produit, la plupart des commandes rétablissent tous les changements. Lorsqu'un changement ne peut pas être rétabli, un message d'erreur s'affiche avec des instructions sur la démarche à suivre. Vous pouvez exécuter une option de ligne de commande facultative plusieurs fois. Lorsque plusieurs options de ligne de commande facultatives sont fournies, elles s'exécutent dans l'ordre dans lequel elles apparaissent sur la ligne de commande. Si une option échoue, l'évaluation et l'exécution de la commande suivante s'interrompent et l'outil quitte le programme avec un message d'erreur. Les options de ligne de commande facultatives peuvent être regroupées en deux catégories : les options les plus fréquemment utilisées et les options les moins utilisées.
- add_record_type
- Récapitulatif
- Ajoute un ou plusieurs nouveaux types d'enregistrement à l'index. Cette option désactive temporairement la fonction de la recherche en texte intégral pour les utilisateurs Web ClearQuest lors de l'exécution de la commande. La liste des nouveaux types d'enregistrement et leurs champs associés
sont fournis par la balise <addRecordType> qui est dans le fichier de configuration d'administration de la recherche en texte intégral.
- Utilisation
- Utilisez l'option de ligne de commande pour ajouter un type d'enregistrement si vous avez omis un type d'enregistrement
au cours de votre déploiement de la recherche en texte intégral initial ou bien si vous avez ajouté un nouveau type d'enregistrement à votre schéma ClearQuest après votre déploiement initial et que vous souhaitez effectuer une recherche sur le nouveau type d'enregistrement. Utilisez cette commande si vous avez renommé, ajouté ou supprimé une zone dans un type d'enregistrement déjà indexé. Afin de répercuter la modification dans votre index, exécutez la commande remove_record_type pour supprimer le type d'enregistrement, puis exécutez cette commande pour l'ajouter à nouveau.
Afin d'ajouter deux types d'enregistrements ou plus, utilisez le point-virgule comme séparateur. Par exemple, le code suivant ajoute les types d'enregistrement Customer et Product.
<newValue
required="no">Customer=CustomerNum,address,phone,product;Product=name,version</newValue>
Si vous énumérez un type d'enregistrement sans liste de zone, toutes les zones de ce type d'enregistrement sont ajoutées. Dans l'exemple suivant, toutes les zones pour les types d'enregistrement Customer et Product sont ajoutées.
<newValue required="no">Customer;Product</newValue>
- Effet
- Cette commande affecte l'index de la recherche en texte intégral ClearQuest, le fichier XML de propriétés de la recherche en texte intégral ClearQuest, le fichier d'entité et le fichier Solr schema.xml.
Avant d'exécuter cette commande, sauvegardez votre déploiement. Exécutez cette option pendant les heures creuses. L'opération prend beaucoup de temps et entraîne une brève immobilisation de la recherche en texte intégral.
- Statut avec état
- La commande est avec état. Si la commande échoue lors de l'un de ses points d'exécution, vous devez pouvoir corriger le problème et réexécuter la commande. L'opération se poursuit à partir de là où elle s'est arrêtée.
Si un échec se produit, un message d'erreur vous indique ce que vous devez faire.
- Exemple
- Vous devez ajouter un nouveau type d'enregistrement appelé Customer.
- Editez le fichier cqtsadmin-TextSearch-SAMPL.xml,
puis modifiez la balise <addRecordType>.
<newValue required="no">Customer=CustomerNum,address,phone,product</newValue>
- Créez une sauvegarde.
cqperl cqtsadmin.pl --username admin
--password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search
--backup_fts E:\FTSBackup
- Ajoutez le nouveau type d'enregistrement.
cqperl cqtsadmin.pl --username
admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search
--add_record_type
- Editez le fichier cqtsadmin-TextSearch-SAMPL.xml
et supprimez ce que vous avez ajouté à la balise <addRecordType>. Il s'agit principalement d'une tâche de nettoyage.
- archive_fts
- Récapitulatif
- Archive le déploiement de la recherche en texte intégral ClearQuest. Cette option désactive le déploiement de la recherche en texte intégral, puis supprime le profil WebSphere Application Server déployé. Elle conserve toutes les données de configuration et l'index.
Cette option peut être utilisée pour recommencer avec une nouvelle configuration et pour faire référence à votre ancienne configuration.
- Utilisation
- Utilisez cette option de ligne de commande pour commencer un nouveau déploiement, ou bien utilisez cette option si vous n'avez plus besoin
de la fonction de la recherche en texte intégral d'un déploiement. Cette option de ligne de commande arrête les services de la recherche en texte intégral et archive toutes les ressources pertinentes, telles que les services et les fichiers. Vous pouvez faire référence au déploiement après l'avoir archivé.
Remarque : N'utilisez pas cette option de ligne de commande si vous planifiez une future restauration. Utilisez l'option de ligne de commande prep_upgd_was_profiles à la place.
- Effet
- Cette option de ligne de commande désactive la recherche en texte intégral. Elle retire et supprime également tous les fichiers, ressources et paramètres qui ont été utilisés et définis sous
WebSphere Application Server pour ce déploiement. Les données de déploiement sous ftshome demeurent intactes, mais elles sont renommées en base_de_données_utilisateur_ensemble_bases_de_données.Archived-horodatage.
- Statut avec état
- Cette option est sans état. Si la commande échoue lors de l'un de ses points d'exécution, vous devez pouvoir effectuer l'archivage manuellement.
Un rapport de progression et un message d'erreur vous informent de la manière de récupérer suite à cette erreur.
- Exemple
- L'exemple suivant indique comment archiver un déploiement.
cqperl
cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb
SAMPL --ftshome D:\CQ.Search --archive_fts
Après avoir exécuté le script, le déploiement de la recherche en texte intégral s'appelle D:\CQ.Search\TextSearch_SAMPL.Archived-time-stamp.
- backup_fts destination
- Récapitulatif
- Crée une copie de sauvegarde de votre déploiement de la recherche en texte intégral ClearQuest. Après la création d'une sauvegarde, vous pouvez récupérer les données de la sauvegarde ou de l'ensemble du déploiement. Pour de meilleurs résultats, commencez par créer une sauvegarde avant l'exécution des commandes qui modifient considérablement le déploiement existant. Avant de sauvegarder votre déploiement, assurez-vous que vous avez la même quantité d'espace disque sur votre emplacement de sauvegarde que celle utilisée par votre déploiement sur ftshome.
- Utilisation
- Utilisez cette commande pour créer une sauvegarde lorsque vous ajoutez ou mettez à jour un type d'enregistrement ou que
votre politique d'organisation exige que vous conserviez des sauvegardes périodiques.
Remarque : N'utilisez pas cette commande au lieu de l'option de ligne de commande prep_upgd_was_profiles, qui gère également les profils WebSphere Application Server de la sauvegarde pour chaque base de données utilisateur.
- Effet
- Cette commande désactive temporairement l'indexeur en mode de mise à jour pendant la sauvegarde. Les recherches en texte intégral pourraient ne pas être mises à jour pendant toute la durée de la sauvegarde. La durée dépend de la taille de votre index, de la vitesse de votre disque dur et de votre réseau, si vous effectuez une sauvegarde via un réseau LAN ou WAN.
- Statut avec état
- Cette option est sans état. Si la commande échoue lors de l'un de ses points d'exécution, vous devez pouvoir effectuer la sauvegarde manuellement ou recommencer,
selon le type de défaillance et le message d'erreur que vous recevez. La défaillance la plus probable est d'avoir un espace disque insuffisant sur l'unité de destination. Aucune donnée de déploiement n'est changée lors de la sauvegarde.
- Exemple
- Vous voulez créer une sauvegarde de votre déploiement avant d'ajouter de nouveaux types d'enregistrement.
cqperl cqtsadmin.pl --username admin --password
"" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --backup_fts
E:\FTSBackup
Après avoir exécuté le script, le déploiement de la recherche en texte intégral archivé s'appelle E:\FTSBackup\TextSearch_SAMPL.Backup-horodatage.
- clear_state
- Récapitulatif
- Réinitialise l'état dans la procédure de l'outil cqtsadmin.pl de sorte qu'il n'y ait pas d'état. En effet, quel que soit l'état de l'outil, qui peut être incomplet, cet état doit être supprimé.
- Utilisation
- Utilisez cette option de ligne de commande pour supprimer l'état d'une commande avec état afin que vous puissiez exécuter d'autres commandes ou réexécuter la commande avec état. Le temps nécessaire pour supprimer l'état dépend de la commande avec état que vous prévoyez de supprimer, l'état dans lequel la commande avec état se trouvait la dernière fois, ainsi que le message d'erreur et les instructions de correction fournies.
- Effet
- L'effet de l'exécution de cette option de ligne de commande dépend de la commande avec état qui a été arrêtée
et la progression de la commande avant l'arrêt. Le journal et le message d'erreur indiquent si vous pouvez réinitialiser l'état.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer ; sauf en cas d'erreur E-S.
- Exemple
- Vous devez supprimer l'état d'une action avec état de sorte que vous
puissiez récupérer d'une erreur irrémédiable, selon les instructions du message d'erreur.
cqperl cqtsadmin.pl --username admin --password
"" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --clear_state
- copy_fts_template
- Récapitulatif
- Copie et définit le modèle par défaut de la recherche en texte intégral ClearQuest. Lorsque vous déployez une recherche en texte intégral sur une base de données qui n'est pas encore activée pour la recherche en texte intégral, vous devez démarrer à partir d'un modèle par défaut vide et le copier dans votre répertoire ftshome.
Si vous tentez d'utiliser cette commande sur un déploiement existant, elle échoue avec une erreur.
- Utilisation
- En général, vous n'avez pas besoin d'utiliser cette option de ligne de commande directement car elle est appelée lorsque vous exécutez l'option de ligne de commande init_cq_fts. Cette option de ligne de commande est fournie au cas où vous avez besoin d'affiner ou de déboguer votre déploiement.
- Effet
- Cette option de ligne de commande copie les données par défaut nécessaires pour la fonction de la recherche en texte intégral
dans le répertoire ftshome spécifié.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer ; sauf en cas d'erreur E-S.
- Exemple
- Le support client IBM Rational vous a demandé d'exécuter cette commande afin de déboguer un problème de déploiement ou pour personnaliser un déploiement.
cqperl cqtsadmin.pl --username admin --password
"" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --copy_fts_template
- create_fts_was_profile startup-type {
manual | automatic | disabled }
- Récapitulatif
- Crée un profil WebSphere Application Server de la recherche en texte intégral ClearQuest. Obligatoire pour tous les nouveaux déploiements
- Utilisation
Chaque déploiement de la recherche en texte intégral ClearQuest doit disposer de son propre profil WebSphere Application Server, un seul profil WebSphere Application Server
pour chaque base de données utilisateur activée de la recherche en texte intégral ClearQuest.
La valeur de paramètre configure l'état du service Windows pour les déploiements du système d'exploitation Windows uniquement. Cette valeur est ignorée sur les systèmes d'exploitation UNIX et Linux pour lesquels vous devez configurer le profil WebSphere Application
Server pour qu'il démarre au moment de l'initialisation en tant que démon.
Le nom du profil WebSphere Application Server
est déterminé à partir de votre ensemble de bases de données et du nom de base de données utilisateur. Cependant, vous pouvez le remplacer avec la balise <ftsWASProfileName>.
Spécifiez l'emplacement pour la création du profil WebSphere Application Server avec l'option de ligne de commande fts_was_profile_home. Si vous ne spécifiez pas l'emplacement, l'emplacement par défaut %CLEARQUEST_HOME%/cqweb/ est utilisé. Pour obtenir de meilleurs résultats, spécifiez votre propre emplacement.
Remarque : Il faut toujours utiliser cette option de ligne de commande avec l'option de ligne de commande init_cq_fts de sorte que le profil WebSphere Application Server soit créé et personnalisé sur la base de votre déploiement de la recherche en texte intégral ClearQuest.
Sinon, le déploiement échouera à moins que le profil WebSphere Application Server n'ait été créé avec cet outil et qu'il soit réutilisé.
- Effet
- Cette option de ligne de commande crée un nouveau profil WebSphere Application Server sous WebSphere Application
Server en utilisant le port disponible suivant. Lorsque l'opération est terminée, l'utilisation de l'espace disque est d'environ 200 Mo. Si le profil est défini sous Automatic sur Windows,
le service commence automatiquement lorsque Windows redémarre.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer ; sauf en cas d'erreur E-S.
- Exemple
- Vous planifiez de déployer une recherche en texte intégral pour une deuxième base de données utilisateur.
Le nom de votre ensemble de bases de données est MASTR et le nom de base de données utilisateur est SAMPL.
- Exécutez la commande suivante pour configurer un déploiement initial.
cqperl
cqtsadmin.pl --username admin --password "" --dbset MASTR --userdb
SAMPL --ftshome D:\CQ.Search --init_cq_fts --create_fts_was_profile
automatic --fts_was_profile_home D:\FTS.WASprofiles
- Modifiez votre fichier d'entité pour qu'il ne contienne que les types d'enregistrement et les zones qui vous intéressent.
- Exécutez cette commande pour effectuer votre déploiement.
cqperl
cqtsadmin.pl --username admin --password "" --dbset MASTR --userdb
SAMPL --ftshome D:\CQ.Search --setup_cq_fts
- cust_fts_files
- Récapitulatif
- Personnalise le fichier XML de propriétés de la recherche en texte intégral ClearQuest en fonction de votre base de données utilisateur, de votre fichier d'entité et de votre fichier de configuration d'administration de la recherche en texte intégral. Lorsque vous déployez la recherche en texte intégral ClearQuest pour la première fois,
vous devez personnaliser le fichier des propriétés de la recherche en texte intégral CQ-base_de_données_utilisateur-ensemble_bases_de_données.xml.
- Utilisation
- Le modèle de la recherche en texte intégral contient des paramètres génériques que vous personnalisez en fonction de votre base de données utilisateur. Un fichier que vous devez personnaliser est le fichier XML de propriétés de la recherche en texte intégral. Ce fichier contient une liste de tous les types d'enregistrement et leurs zones en fonction de ce qui est spécifié dans
votre fichier d'entité. Ce fichier contient également des paramètres
tels que les zones à utiliser comme zone d'affichage, la fréquence de vérification des modifications apportées à votre base de données utilisateur ClearQuest et la façon de communiquer avec votre base de données et votre serveur ClearQuest. En général, vous n'avez pas besoin d'utiliser cette option de ligne de commande directement car elle est appelée lorsque vous exécutez l'option de ligne de commande setup_cq_fts. Cette option de ligne de commande est fournie au cas où vous avez besoin d'affiner ou de déboguer votre déploiement.
- Effet
- Si vous utilisez cette option de ligne de commande sur un déploiement, elle écrase le fichier CQ-base_de_données_utilisateur-ensemble_bases_de_données.xml.
Toutes les modifications qui ont été apportées au fichier, soit manuellement, soit en exécutant des commandes, sont perdues.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer ; sauf en cas d'erreur E-S.
- Exemple
- Le service de support logiciel IBM vous demande de déboguer un problème de déploiement de la recherche en texte intégral ou de personnaliser un déploiement.
cqperl
cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb
SAMPL --ftshome D:\CQ.Search --cust_fts_files
- cust_solr_files
- Récapitulatif
- Lorsque vous déployez la recherche en texte intégral ClearQuest pour la première fois, vous devez personnaliser le fichier schéma Solr
qui est basé sur votre fichier d'entité ClearQuest actuel.
- Utilisation
- Le modèle de la recherche en texte intégral est générique et contient des paramètres par défaut que vous devez personnaliser en fonction
de votre base de données utilisateur.
Un fichier que vous devez personnaliser est le fichier Solr schema.xml.
Ce fichier contient toutes les zones de tous les types d'enregistrement que vous avez définis comme pouvant être recherchés en utilisant le fichier de l'entité. En général, vous n'avez pas besoin d'utiliser cette option de ligne de commande directement car elle est appelée lorsque vous exécutez l'option de ligne de commande setup_cq_fts. Cette option de ligne de commande est fournie au cas où vous avez besoin d'affiner ou de déboguer votre déploiement.
- Effet
- Cette option de ligne de commande lit les données à partir de votre fichier d'entité et personnalise ensuite le fichier Solr schema.xml. Si vous utilisez l'option sur un déploiement déjà existant, il refactorise le fichier schema.xml.
Si vous avez modifié les fichiers d'entité après votre déploiement initial, les valeurs précédentes sont perdues.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer ; sauf en cas d'erreur E-S.
- Exemple
- Le service de support logicielIBM vous demande de déboguer un problème de déploiement de la recherche en texte intégral ou de personnaliser un déploiement.
cqperl cqtsadmin.pl --username admin --password
"" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --cust_solr_files
- delete_fts_was_profile
- Récapitulatif
- Pour supprimer un profil WebSphere Application Server ou si vous voulez recommencer de nouveau, exécutez cette option de ligne de commande. Elle permet de supprimer le profil WebSphere Application Server ClearQuest de la recherche en texte intégral qui est associé avec ce déploiement de la recherche en texte intégral ClearQuest.
Cette option est différente de archive_fts, car seul le profil WebSphere Application
Server est supprimé. Cependant, le répertoire de base de la recherche en texte intégral et les métadonnées associées ne sont pas supprimés. Pour supprimer complètement le déploiement de la recherche en texte intégral ClearQuest,
utilisez l'option archive_fts à la place.
- Utilisation
- En général, n'utilisez pas cette commande directement car elle est appelée lorsque vous exécutez l'option de ligne de commande
archive_fts.
Cette commande est fournie si vous avez besoin d'affiner ou de déboguer votre déploiement.
- Effet
- Les ressources qui sont utilisées par WebSphere pour ce profil WebSphere Application
Server sont libérées. Si la recherche en texte intégral ClearQuest Web n'a pas été désactivée avec l'option de ligne de commande disable_cqweb_fts, les recherches en texte intégral aboutissent à des erreurs.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer ; sauf en cas d'erreur E-S.
- Exemple
- Vous devez renommer ou modifier l'emplacement de votre profil WebSphere Application Server, mais
vous n'avez pas besoin de redéployer complètement votre solution de la recherche en texte intégral.
- Supprimez le profil WebSphere Application Server.
cqperl cqtsadmin.pl --username admin --password
"" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --delete_fts_was_profile
- Editez le fichier cqtsadmin-dbset-userdb.xml et modifiez la balise <ftsWASProfileName> du nom par défaut généré automatiquement en un nouveau nom du profil
WebSphere Application Server. Le nom doit être unique. Sinon, la commande échoue.
- Recréez le profil WebSphere Application Server.
cqperl cqtsadmin.pl --username admin --password
"" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --create_fts_was_profile
automatic --fts_was_profile_home D:\FTS.WASprofiles
- Si vous avez également l'intention de modifier le numéro de port pour ce profil WebSphere Application Server,
éditez le fichier cqtsadmin-dbset-userdb.xml,
puis mettez à jour le numéro de port dans la balise <ftsWASProfilePort> avant l'étape 3 ci-dessus. Ou bien, exécutez cette commande pour redéfinir les ports à la place :
cqperl
cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb
SAMPL --ftshome D:\CQ.Search --create_fts_was_profile automatic --fts_was_profile_home
D:\FTS.WASprofiles --was_profile_ports_file D:\CQ.Search\TextSearch_SAMPL\cqftsportdef.props
- disable_cqweb_fts
- Récapitulatif
- Cette option de ligne de commande désactive le bouton d'option Full Text ClearQuest Web,
et arrête l'enregistrement des journaux des opérations enregistré (oplogs) dans une base de données utilisateur ClearQuest non répliquée.
Cette option de ligne de commande n'a aucun impact sur la création de journaux des opérations dans des environnements répliqués.
Avertissement : Utilisez cette option de ligne de commande avec précaution. Elle permet de désactiver les enregistrements oplog si votre base de données ClearQuest n'est pas répliquée.
Si les enregistrements ClearQuest sont modifiés lorsque les oplogs ne sont pas générés, les enregistrements modifiés ne sont pas réindexés. Vous devez effectuer une réindexation de la base de données complète. Empêchez les utilisateurs d'accéder à ClearQuest ou autorisez seulement les opérations en lecture seule
jusqu'à ce que la fonction de la recherche en texte intégral soit réactivée.
- Utilisation
- Vous n'avez pas besoin d'utiliser cette commande à moins que vous ne soyez dans un environnement de test ou que le service de support logiciel IBM ne vous demande de le faire.
- Effet
- La génération de journal oplog s'arrête, si votre base de données n'est pas répliquée, puis le bouton d'option Full Text est désactivé.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer ; sauf en cas d'erreur E-S.
- Exemple
- Le support client IBM Rational vous demande de désactiver la recherche en texte intégral pour vous aider à résoudre les problèmes.
cqperl
cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb
SAMPL --ftshome D:\CQ.Search --disable_cqweb_fts
- enable_cqweb_fts
- Récapitulatif
- Active le bouton d'option Full Text dans ClearQuest Web. La génération de journal oplog est également activée si votre base de données ClearQuest n'est pas répliquée et est à un niveau de fonctionnalité 7. Si votre base de données utilisateur ClearQuest est répliquée, aucune modification n'est apportée à la génération du journal d'opérations. Si votre déploiement n'est pas configuré correctement, les utilisateurs qui tentent d'utiliser la recherche en texte intégral reçoivent un message d'erreur.
- Utilisation
- Vous n'avez pas besoin d'utiliser cette commande à moins que vous ne soyez dans un environnement de test ou que le service de support logiciel IBM ne vous demande de le faire.
- Effet
- La génération de journal commence, si votre base de données n'est pas répliquée et qu'est à un niveau de fonctionnalité 7. Le bouton d'option Full Text dans ClearQuest Web est activé.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer ; sauf en cas d'erreur E-S.
- Exemple
- Le service de support logiciel IBM vous demande d'activer la recherche en texte intégral pour vous aider à résoudre les problèmes que vous avez.
cqperl
cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb
SAMPL --ftshome D:\CQ.Search --enable_cqweb_fts
- fresh_batch_idx
- Récapitulatif
- Cette option de ligne de commande vous permet de forcer une réindexation complète en mode de traitement par lots après l'indexation initiale. L'indexation en mode de traitement par lots représente le processus de lecture de tous les enregistrements
ClearQuest
qui sont configurés pour effectuer une recherche et envoyer les données de ces enregistrements vers le moteur de recherche
(Solr) afin d'effectuer l'indexation. L'indexation en mode de traitement par lots est effectuée dans le cadre de l'exécution de l'option de ligne de commande setup_cq_fts. Avant d'exécuter cette commande, exécutez l'option de ligne de commande stop_update_idx pour arrêter l'indexeur
en mode de mise à jour. Si vous ne le faites pas, l'indexeur en mode de traitement par lots peut remplacer les données d'un enregistrement plus récent par celles de l'indexeur en mode de mise à jour. Lorsque la réindexation est terminée, votre index est fragmenté. Généralement, cette fragmentation n'a pas d'impact sur la performance sur vos recherches. Cependant, la taille de l'index peut augmenter et atteindre jusqu'au double de la taille actuelle. Afin d'optimiser l'index et de réduire sa taille, exécutez l'option de ligne de commande optimize_idx.
- Utilisation
- Vous n'avez pas besoin d'utiliser cette commande à moins que vous ne soyez dans un environnement de test ou que le service de support logiciel IBM ne vous demande de le faire.
- Effet
- L'index de recherche est mis à jour. Sa taille peut augmenter et atteindre jusqu'au double de la taille actuelle. C'est pourquoi vous devez confirmer que vous disposez de suffisamment d'espace disque avant d'utiliser cette commande. Lors de la réindexation, les résultats de la recherche pourraient ne pas être complets car l'indexeur en mode de mise à jour est désactivé.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer ; sauf en cas d'erreur E-S.
- Exemple
- Le service de support logiciel IBM vous demande de réindexer complètement vos enregistrements consultables.
- Arrêtez l'indexeur en mode de mise à jour.
cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --stop_update_idx
- Forcez la réindexation en mode de traitement par lots.
cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --fresh_batch_idx
- Exécutez l'optimisation d'index.
cqperl cqtsadmin.pl --username
admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search
--optimize_idx
- Activer l'indexeur en mode de mise à jour.
cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --start_update_idx
Remarque : Vous pouvez combiner ces étapes en une seule commande. Vous pourriez vouloir le faire parce que cette opération prend beaucoup de temps si vous réindexez de nombreux enregistrements.
cqperl cqtsadmin.pl
--username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome
D:\CQ.Search -- stop_update_idx --fresh_batch_idx --optimize_idx --start_update_id
- fresh_update_idx
- Récapitulatif
- Permet de forcer une réindexation complète de tous les enregistrements de journaux oplog modifiés par l'indexeur en mode de mise à jour. Utilisez cette option avec prudence. L'indexeur en mode de mise à jour comporte une seule unité d'exécution. Cette opération prend beaucoup de temps, surtout si votre base de données ClearQuest contient de nombreux journaux oplog.
L'indexeur en mode de mise à jour représente le processus de surveillance de la base de données ClearQuest
à la recherche des modifications sur les types d'enregistrement qui sont configurés pour la recherche. La surveillance est effectuée en vérifiant les journaux oplog dans la base de données ClearQuest. L'indexation en mode de mise à jour est activée dans le cadre de l'option de ligne de commande setup_cq_fts. Contrairement à l'option de ligne de commande fresh_batch_idx,
cette commande ne nécessite pas que vous arrêtiez l'indexeur en mode de mise à jour. Lorsque cette commande s'exécute sur un index rempli, votre index est fragmenté. Généralement, cette fragmentation n'a pas d'impact sur la performance sur vos recherches. Cependant, la taille de l'index peut augmenter et atteindre jusqu'au double de la taille actuelle. Afin d'optimiser l'index et de réduire sa taille, exécutez l'option de ligne de commande optimize_idx.
Réfléchissez soigneusement si l'indexeur en mode de mise à jour doit démarrer à partir du premier journal oplog enregistré. Au fil du temps, vous avez amassé un journal oplog pour chaque action prise dans un enregistrement ClearQuest
et vous ne souhaitez peut-être pas indexer à partir du premier journal oplog enregistré,en particulier, si vous n'avez pas régulièrement purgé les journaux oplog. Cette commande est conçue pour être utilisée dans des environnements de test et pour déboguer les problèmes de déploiement de la recherche en texte intégral en travaillant avec le support client IBM Rational.
- Utilisation
- Vous n'avez pas besoin d'utiliser cette commande à moins que vous ne soyez dans un environnement de test ou que le service de support logiciel IBM ne vous demande de le faire.
- Effet
- L'index de recherche est mis à jour. Sa taille peut augmenter et atteindre jusqu'au double de la taille actuelle. Assurez-vous que vous disposez de suffisamment d'espace disque avant d'utiliser cette commande.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer ; sauf en cas d'erreur E-S.
- Exemple
- Le service de support logiciel IBM vous demande de forcer une réindexation de l'indexeur en mode de mise à jour.
cqperl
cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb
SAMPL --ftshome D:\CQ.Search --fresh_update_idx
- fts_was_profile_home destination
- Récapitulatif
- Utilisez cette option de ligne de commande avec l'option de ligne de commande create_fts_was_profile pour spécifier l'emplacement où le profil WebSphere Application
Server pour que ce déploiement de la recherche en texte intégral ClearQuest sera créé. Si vous exécutez cette option, l'emplacement par défaut de ${CLEARQUEST_HOME}/cqweb/ est utilisé. L'emplacement par défaut n'est pas toujours approprié car les fichiers supplémentaires créés dans le répertoire d'installation de ClearQuest peuvent interférer avec l'installation ClearQuest, sa désinstallation ou sa mise à niveau. Cette option de ligne de commande peut également être utilisée avec l'option de ligne de commande restore_was_profile. Vous pouvez spécifier un emplacement différent de celui d'origine
où le profil de la recherche en texte intégral WebSphere Application
Server sera créé.
- Utilisation
- Vous souhaitez déployer la recherche en texte intégral ClearQuest pour une base de données ClearQuest
et vous ne voulez pas que l'emplacement par défaut soit utilisé pour créer et stocker les fichiers WebSphere liés à votre déploiement. Utilisez cette option de ligne de commande avec l'option de ligne de commande create_fts_was_profile pour spécifier l'emplacement de votre profil de la recherche en texte intégral WebSphere Application Server. Si
vous avez plus d'un déploiement de la recherche en texte intégral sur cette machine, utilisez le même emplacement pour chacun d'eux
afin que tous vos profils WebSphere Application Server
soient dans le même emplacement.
- Effet
- Un répertoire est créé, s'il n'existe pas, dans l'emplacement fts_was_profile_home.
Il contient les données relatives au profil WebSphere Application Server. Un sous-répertoire de ce répertoire est créé. Il représente le nom du profil WebSphere Application Server, qui est cqsearchprofile_dbset_userdb ou cqfts_dbset_userdb.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer sauf en cas d'erreur E-S ou si le chemin n'est pas valide comme avec un identificateur d'unité qui n'existe pas
ou bien un chemin de montage Unix ou Linux inexistant.
- Exemple
- Vous devez déployer la recherche en texte intégral ClearQuest. Vous ne voulez pas utiliser l'emplacement par défaut pour les profils WebSphere Application Server.
cqperl
cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb
SAMPL --ftshome D:\CQ.Search --init_cq_fts --create_fts_was_profile
manual --fts_was_profile_home D:\FTS.WASprofiles
- gather_diagnostic_data
- Récapitulatif
- Permet de collecter les données qui aident le service de support logiciel IBM à détecter les problèmes de la recherche en texte intégral ClearQuest. Si vous avez besoin d'assistance, exécutez cette option de ligne de commande de diagnostic et envoyez les données que vous avez collectées avec cette option de ligne de commande pour aider le service de support. Cette option de ligne de commande regroupe les données pertinentes
concernant votre déploiement de la recherche en texte intégral ClearQuest. Les données sont copiées dans un répertoire que le service de support logiciel IBM peut vous demander d'envoyer. Avant d'envoyer les données, assurez-vous qu'elles ne contiennent aucune information confidentielle. En général, les données les plus sensibles sont les noms des types d'enregistrement que vous avez activés pour la recherche et l'historique des termes de recherche que votre organisation a soumis. L'historique représente le journal que WebSphere maintient pour votre profil WebSphere Application Server. Les mots de passe sont convertis en astérisques lors de l'envoi de la sortie vers l'écran ou les fichiers journaux. Ils ne sont jamais stockés en texte normal.
- Utilisation
- Utilisez cette commande pour regrouper et envoyer les données de diagnostic au service de support logiciel IBM pour vous aider à diagnostiquer les problèmes avec la recherche en texte intégral.
- Effet
- Aucune donnée ni paramètre de configuration n'est modifié. Un nouveau répertoire est créé avec le nom de votre déploiement et un horodatage.
La taille cumulée des données de diagnostic varie en fonction des tailles totales des journaux dans votre déploiement, qui est généralement de quelques mégaoctets.
L'index réel ne fait pas partie des données de diagnostic.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer ; sauf en cas d'erreur E-S.
- Exemple
- Le service de support logiciel IBM vous demande d'envoyer les données de diagnostic pour vous aider à résoudre les problèmes avec la recherche en texte intégral. La commande suivante crée les données de diagnostic et les placent dans un fichier D:\CQ.Search\TextSearch_SAMPL.Diag-time-stamp.
cqperl
cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb
SAMPL --ftshome D:\CQ.Search --gather_diagnostic_data
- gen_entity_file
- Récapitulatif
- Cette option de ligne de commande génère le fichier d'entité qui contient tous les types d'enregistrement qui peuvent être soumis à la base de données ClearQuest. Par défaut, le fichier d'entité contient tous les types d'enregistrement ainsi que toutes les zones de votre schéma ClearQuest. Ce sont également des candidats pour la recherche en texte intégral. Vous pouvez personnaliser le fichier pour sélectionner uniquement
les types d'enregistrement et les zones associées que vous prévoyez à indexer. Lorsque vous déployez la recherche en texte intégral sur une base de données ClearQuest pour la première fois, vous devez disposer d'un fichier d'entité qui contient tous les types d'enregistrement et leurs zones auxquels le schéma de base de données utilisateur ClearQuest fait référence. Ce fichier d'entité est utilisé comme une entrée pour générer le fichier XML de propriétés de la recherche en texte intégral, le fichier XML intermédiaire Solr et le fichier Solr schema.xml.
- Utilisation
- En général, vous n'avez pas besoin d'utiliser cette commande directement. Elle est appelée lorsque vous exécutez l'option de ligne de commande init_cq_fts. Cette commande
est fournie si vous devez affiner ou déboguer votre déploiement.
- Effet
- Si vous utilisez cette commande sur un déploiement existant, il écrase le fichier Entity-dbset-userdb.txt et vous perdez les modifications que vous avez apportées.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer ; sauf en cas d'erreur E-S.
- Exemple
- Le service de support logiciel IBM Rational vous a demandé de déboguer un problème de déploiement de la recherche en texte intégral ou de personnaliser un déploiement.
cqperl cqtsadmin.pl --username admin --password
"" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --gen_entity_file
- gen_fts_files
- Récapitulatif
- Cette option de ligne de commande génère les fichiers d'installation de la recherche en texte intégral ClearQuest
sur la base de votre base de données utilisateur, votre fichier d'entité et votre fichier de configuration d'administration de la recherche en texte intégral. Lorsque vous déployez la recherche en texte intégral sur une base de données utilisateur pour la première fois,
vous devez générer le fichier XML des propriétés de la recherche en texte intégral. Ce fichier contient des informations sur vos paramètres de déploiement telles que la fréquence d'index, la taille de lot pour indexation et les informations du serveur de recherche.
- Utilisation
- En général, vous n'avez pas besoin d'utiliser cette option de ligne de commande directement.
Elle est appelée lorsque vous exécutez l'option de ligne de commande setup_cq_fts. Cette option de ligne de commande est fournie au cas où vous avez besoin d'affiner ou de déboguer votre déploiement.
- Effet
- Si vous utilisez cette commande sur un déploiement déjà existant, il écrase les fichiers Entity-dbset-userdb.txt, Solr-dbset-userdb.txt
et CQ-dbset-userdb.xml et vous perdez les modifications que vous avez apportées.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer ; sauf en cas d'erreur E-S.
- Exemple
- Le service de support logiciel IBM Rational vous a demandé de déboguer un problème de déploiement de la recherche en texte intégral ou de personnaliser un déploiement.
cqperl cqtsadmin.pl --username admin --password
"" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --gen_fts_file
- help
- Récapitulatif
- Affiche un texte d'aide puis le ferme.
- Utilisation
- Vous connaissez le script cqtsadmin.pl,
mais vous voulez un petit rappel concernant les commandes disponibles.
- Effet
- Aucun. Cette commande ne change aucune donnée et n'exige l'exécution d'aucune authentification.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer ; sauf en cas d'erreur E-S.
- Exemple
- Vous voulez une liste des commandes disponibles.
cqperl cqtsadmin.pl --help
- init_cq_fts
- Récapitulatif
Copie le modèle par défaut de la recherche en texte intégral ClearQuest, puis génère le fichier d'entité par défaut.
En réalité, elle exécute les deux commandes
copy_fts_template et
gen_entity_file.
Cette commande est l'une des premières commandes que vous exécutez lorsque vous déployez la recherche en texte intégral. Elle permet de créer un répertoire
base_de_données_utilisateur_ensemble_bases_de_données
dans votre répertoire
ftshome. Toutes les données et tous les paramètres qui sont liés à ce déploiement sont placés dans ce répertoire.
Un des principaux fichiers que cette option crée est le fichier d'entité
Entity-dbset-userdb.txt. Il est placé dans votre répertoire
ftshome.
Lorsque vous personnalisez votre déploiement, vous décidez de le laisser tel qu'il est ou de supprimer les types d'enregistrement
et les zones sur lesquels vous ne voulez pas effectuer une recherche. Un autre fichier qui est créé est le fichier de configuration d'administration de la recherche en texte intégral
cqftsadmin-dbset-userdb.xml. Ce fichier contient des paramètres par défaut supplémentaires qui sont spécifiques pour votre déploiement et environnement
tels que le nom du serveur, votre nom de profil WebSphere Application Server, votre taille de lot d'index et la fréquence d'index.
Remarque : Cette option de ligne de commande est généralement exécutée en combinaison avec les options de ligne de commandecreate_fts_was_profile et fts_was_profile_home
de sorte qu'un nouveau profil WebSphere Application
Server soit créé pour ce déploiement. Sinon, le déploiement de la recherche en texte intégral ClearQuest échoue,
à moins que vous réutilisiez un profil WebSphere Application Server qui a déjà été déployé pour la recherche en texte intégral.
- Utilisation
- Utilisez cette commande pour préconfigurer votre déploiement de la recherche en texte intégral.
Il crée votre répertoire ftshome, copie à l'intérieur les fichiers par défaut et définit les valeurs par défaut. Avant de finaliser votre déploiement, vous personnalisez généralement le fichier d'entité.
- Effet
- Cette commande crée un nouveau répertoire ftshome
s'il n'existe pas déjà et copie les données par défaut et les paramètres pour votre déploiement à l'intérieur.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer ; sauf en cas d'erreur E-S.
- Exemple
- Vous voulez commencer un nouveau déploiement de la recherche en texte intégral pour l'une de vos bases de données utilisateur.
- Exécutez cette commande pour reconfigurer votre déploiement.
cqperl
cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb
SAMPL --ftshome D:\CQ.Search --init_cq_fts --create_fts_was_profile
Automatic --fts_was_profile_home D:\CQFTS.WASprofiles
- Modifiez ce fichier d'entité de déploiement pour supprimer les types d'enregistrement ou les zones sur lesquels utilisateurs ne devraient pas pouvoir effectuer une recherche. En outre, ajoutez une perluète (&)
devant une zone pour chaque type d'enregistrement. Ce sera la zone d'affichage de l'ensemble de résultats de la recherche en texte intégral.
D:\CQ.Search\TextSerch_SAMPL\Entity-TextSearch-SAMPL.txt
- Effectuez votre déploiement en exécutant cette commande :
cqperl
cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb
SAMPL --ftshome D:\CQ.Search --setup_cq_fts
- lock_cq_fts
- Récapitulatif
Cette option de ligne de commande verrouille ce déploiement de la recherche en texte
intégral ClearQuest de sorte que seules les commandes cqtsadmin.pl non destructives
puissent être exécutées. Toutes les commandes, à l'exception de gather_diagnostic_data et help, sont désactivées. Utilisez l'option unlock_cq_fts pour réactiver
les commandes.
- Utilisation
- Après avoir déployé la recherche en texte intégral, exécutez cette commande pour verrouiller
le déploiement afin d'empêcher des modifications non volontaires. Ce verrou est faible. N'importe quelle personne disposant d'un accès correct au système de fichiers ou des privilèges ClearQuest peut déverrouiller un déploiement.
Le but de cette commande est de permettre aux administrateurs de signaler que
le déploiement est terminé. Toute modification supplémentaire doit être communiquée et exécutée avec
prudence.
- Effet
- Aucun. Vos données et paramètres de déploiement de recherche en texte intégral ne sont pas affectés.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer ; sauf en cas d'erreur E-S.
- Exemple
- Vous avez terminé un déploiement et vous souhaitez vous assurer que le déploiement n'est pas
modifié.
cqperl cqtsadmin.pl --username admin --password
"" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --lock_cq_fts
- optimize_idx
- Récapitulatif
Cette option de ligne de commande permet de défragmenter l'index. L'optimisation
requiert un espace disque libre correspondant à au moins 1,5 fois la taille de votre index actuel
pour réussir. Par exemple, si votre index utilise 2 Go
d'espace disque, vous devez disposer de 3 Go d'espace disque libre pour exécuter
la commande.
- Utilisation
Au fur et à mesure que vous ajoutez ou modifiez des enregistrements dans l'index de recherche,
ce dernier peut se fragmenter. La taille des index fragmentés augmente généralement plus que la taille de ceux qui ne le sont pas. Une légère dégradation des performances peut également se produire. Pour réduire la taille de l'index et restaurer la performance, optimisez votre index au moins une fois par an. Optimisez-le plus souvent si votre base de données ClearQuest fait
l'objet d'une activité importante avec des modifications, des ajouts et des suppressions d'enregistrements.
Avant d'exécuter
cette commande, assurez-vous que vous disposez de suffisamment d'espace disque libre.
Dans le cas contraire, l'optimisation va échouer, mais votre index d'origine
restera intact. De l'espace disque disponible est requis car l'index d'origine est réécrit lors de l'optimisation. L'ancien index est conservé tant que le nouvel index n'est pas régénéré.
Le temps nécessaire pour optimiser un index dépend de la taille de votre index et de la vitesse de votre disque dur et de vos E-S. Une optimisation peut prendre quelques heures sur un index de 2 Go.
Pendant le processus d'optimisation, tous les services de la recherche en texte intégral
sont disponibles, y compris l'indexeur en mode de mise à jour. Toutefois, certains peuvent
souffrir d'une légère dégradation des performances. Planifiez l'optimisation des index pendant les heures
creuses.
- Effet
- Votre index de recherche est réécrit. Si une erreur E-S se produit au cours de l'optimisation,
il est plus que probable que cela est dû à un espace disque insuffisant.
L'index d'origine reste intact. L'index d'origine peut être plus volumineux, mais il retrouve sa taille d'origine une fois que son optimisation est terminée.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer ; sauf en cas d'erreur E-S.
- Exemple
- Vous devez optimiser votre index de recherche.
cqperl cqtsadmin.pl
--username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome
D:\CQ.Search --optimize_idx
- prep_upgd_was_profiles destination
- Récapitulatif
- Lorsqu'une durée d'immobilisation est prévue, cette option de ligne de commande
permet de préparer une modification ou une réinstallation de ClearQuest. Utilisez la sauvegarde que cette commande crée pour restaurer
les déploiements de la recherche en texte intégral, notamment
le retour du profil WebSphere Application Server
dans son état d'origine.
- Utilisation
Toutes les bases de données utilisateur qui sont déployées avec la recherche en
texte intégral nécessitent un profil WebSphere Application
Server correspondant. Ces profils risquent de ne pas être conservés lorsque vous mettez à niveau,
modifiez ou réinstallez ClearQuest.
Les mises à jour qui sont rendues disponibles dans les groupes de correctifs ClearQuest
peuvent uniquement être incorporées dans les déploiements de la recherche en texte
intégral ClearQuest via cette procédure de préparation et de restauration. Lorsque
vous utilisez cette option de ligne de commande avec l'option de ligne de commande restore_was_profiles,
elle crée des données de sauvegarde, supprime éventuellement les profils WebSphere Application Server,
puis restaure les profils WebSphere Application Server à partir du chemin des données de sauvegarde indiqué lorsqu'elle est appelée après que votre mise à niveau ou réinstallation de ClearQuest est
terminée.
Pour supprimer les profils ClearQuest WebSphere Application Server, vous
devez modifier la valeur de balise <deleteFtsWASProfiles>
de FALSE en TRUE pour un fichier de configuration d'administration de la recherche en texte intégral cqtsadmin-dbset-userdb.xml. Assurez-vous de vous référer à
ce déploiement modifié lorsque vous exécutez la commande. Dans le cas contraire, les profils WebSphere Application Server
ne seront pas correctement supprimés en préparation de leur restauration et mise à niveau.
Cette option de ligne de commande peut être exécutée sur tous les éléments dbset,
userdb ou ftshome. L'option n'est pas associée à un déploiement de la recherche en texte
intégral spécifique. Elle évalue et affecte tous les déploiements de la recherche en texte intégral ClearQuest
sur l'hôte dans n'importe quel répertoire
ftshome.
Remarque : Si vous
disposez de plus d'un déploiement de la recherche en texte intégral sur la machine actuelle, cette
option de ligne de commande et l'option de ligne de commande restore_was_profiles
doivent être exécutées une seule fois. Ces deux commandes agissent au niveau global sur tous les
déploiements de la recherche en texte intégral
sur votre machine actuelle.
Avertissement : Lors de la mise à niveau de ClearQuest,
vous devez exécuter cette option de ligne de commande avec la balise <deleteFtsWASProfiles>
définie sur TRUE. Dans le cas contraire, le résultat pourrait être une mise à niveau incomplète de vos
déploiements de la recherche en texte intégral. Une fois que
la mise à niveau est terminée et que vous avez exécuté l'option de ligne de commande restore_was_profiles,
modifiez la valeur de cette option en FALSE.
- Effet
- Si la balise <deleteFtsWASProfiles> est définie sur TRUE pour un
fichier de configuration d'administration de la recherche en texte intégral cqtsadmin-dbset-userdb.xml,
les données de sauvegarde de vos profils WebSphere Application Server de la recherche en texte intégral
ClearQuest sont créées et ces profils WebSphere Application
Server sont supprimés. Toute demande de recherche en texte intégral échouera
tant que ces profils ne seront pas restaurés. Toutefois, le bouton d'option reste activé et la
création d'oplogs se poursuit pour les bases de données utilisateur de niveau de fonctionnalité 7 non répliquées. Ce type de défaillance est acceptable parce que le seul moment où vous utilisez cette
option de ligne de commande est lorsque vous mettez à niveau, modifiez
ou réinstallez ClearQuest.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer ; sauf en cas d'erreur E-S.
- Exemple
- Vous êtes sur le point de mettre à niveau, de modifier ou de réinstaller
ClearQuest. Avant de démarrer l'installation,
vous devez effectuer une sauvegarde de l'ensemble de vos profils WebSphere Application
Server sur cet hôte.
- Editez le fichier cqtsadmin-dbset-userdb.xml
d'un seul déploiement de la recherche en texte intégral et modifiez la balise XML <deleteFtsWASProfiles>
de la manière suivante afin de permettre la sauvegarde et la suppression des profils WebSphere Application
Server.
<newValue
required="no">true</newValue>
Enregistrez la modification. Le fichier cqtsadmin-TextSearch-SAMPL.xml est utilisé dans
cet exemple.
- Exécutez l'option de ligne de commande afin de créer des données de sauvegarde et
de supprimer les profils WebSphere Application
Server :
cqperl cqtsadmin.pl --username admin --password
"" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --prep_upgd_was_profiles
E:\FTSBackupWASProfiles
- Modifiez la valeur de la balise XML <deleteFtsWASProfiles> en FALSE ou supprimez la valeur
TRUE.
- Effectuez la mise à niveau ClearQuest,
la modification de la fonction de recherche en texte intégral ou la réinstallation.
- Exécutez l'option de ligne de commande afin de restaurer tous les déploiements de la
recherche en texte intégral et les profils WebSphere Application
Server supprimés à partir des données de sauvegarde. Vous trouverez deux scénarios possibles ci-dessous :
- Si vous rencontrez un problème, exécutez l'option de ligne de commande gather_diagnostic_data
sur le même élément dbset, userdb ou ftshome afin de fournir des données au service de support IBM Rational.
Avertissement : Si vous avez personnalisé le fichier Solr schema.xml
afin de prendre en charge une langue autre que l'anglais ou que vous avez apporté des modifications à l'analyseur ou au marqueur sémantique
Solr, les modifications seront perdues. Afin de conserver
les modifications, enregistrez-les et introduisez-les à nouveau après avoir
terminé la mise à niveau. Une fois que vous avez apporté les modifications au fichier schema.xml,
arrêtez et redémarrez le profil WebSphere Application Server de la recherche en texte intégral pour que les modifications
s'appliquent.
- remove_lucene_idx_lock
- Récapitulatif
- Utilisez cette commande pour supprimer un verrou Lucene sur l'index de recherche.
Le moteur de recherche Lucene utilise des verrous pour synchroniser les mises à jour. Dans de rares cas,
si Lucene ou le serveur rencontre une erreur lorsqu'un verrou est
obtenu et que Lucene ne peut pas récupérer, le verrou reste actif. L'index de recherche ne peut pas être mis à jour lorsqu'un verrou est actif. C'est pourquoi aucun enregistrement ClearQuest ne peut être ajouté ou mis à jour. Les recherches en texte intégral sur l'index se poursuivent tant qu'il n'existe pas de problème d'intégrité avec l'index. Pour récupérer à partir de ce type de verrou, redémarrez le profil
WebSphere Application
Server en exécutant les options de ligne de commande stop_fts_was_profile et start_fts_was_profile. Les recherches en texte intégral sont interrompues lorsque le service redémarre.
- Utilisation
- Vous remarquez que les enregistrements ClearQuest récemment ajoutés
ne sont pas inclus dans les résultats de la recherche. Vous examinez les journaux de profil WebSphere Application Server
et découvrez que Lucene rapporte des erreurs indiquant que l'index est verrouillé.
Utilisez cette commande pour libérer le verrou.
- Effet
- Aucun. Les données et les paramètres du déploiement de la recherche en texte intégral ne sont pas
affectés.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer ; sauf en cas d'erreur E-S.
- Exemple
- Vous souhaitez supprimer un verrou d'index Lucene. Arrêtez, démarrez et déverrouillez
l'index en une étape :
cqperl cqtsadmin.pl --username admin
--password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search
--stop_fts_was_profile --remove_lucene_idx_lock --start_fts_was_profile
- remove_record_type
- Récapitulatif
- Cette commande supprime un ou plusieurs types d'enregistrement ClearQuest de l'index de
recherche. Les recherches suivantes ne trouveront pas de correspondances avec les types d'enregistrement supprimés. Cette commande est utilisée avec des données que vous devez fournir via
le fichier de configuration d'administration de la recherche en texte intégral cqtsadmin-dbset-userdb.xml. Dans le fichier de configuration,
répertoriez les noms des types d'enregistrement à supprimer dans la balise XML <removeRecordType>. Pour supprimer plusieurs types d'enregistrement, séparez les noms avec
un point-virgule.
Cette commande s'exécute dans des états. Si une erreur se produit au cours de l'un des états, un message d'erreur explique comment corriger l'erreur.
Lorsque vous redémarrez la commande, elle continue à partir du point où
l'erreur s'est produite.
Créez une sauvegarde de votre déploiement avant d'émettre cette commande. La suppression d'un type d'enregistrement supprime uniquement de l'index de recherche les données qui sont liées à ce type d'enregistrement. ClearQuest lui-même n'est pas affecté par cette
commande.
- Utilisation
- Après le déploiement de la recherche en texte intégral, il vous est demandé de ne plus permettre des recherches
sur certains types d'enregistrement. Cette commande supprime ces types
d'enregistrement à partir de l'index, ce qui empêche la recherche de ces types d'enregistrement.
Une autre utilisation de cette commande est lorsque ces types d'enregistrement qui sont indexés ont été modifiés dans votre schéma ClearQuest.
Peut-être avez-vous ajouté de nouvelles zones ou renommé des zones. Pour appliquer cette modification dans votre index de recherche, utilisez les options de ligne de commande
remove_record_type et add_record_type.
- Effet
- Votre index de recherche est modifié de sorte que les références aux types d'enregistrement qui ont été supprimés
n'existent plus. C'est pourquoi les types d'enregistrement qui ont été supprimés ne peuvent pas être recherchés. Les références à ces types d'enregistrement sont supprimées
du fichier XML des propriétés de la recherche en texte intégral et du fichier
d'entité. Pendant l'exécution de cette commande, les services de recherche sont brièvement
interrompus lorsque le profil WebSphere Application
Server est redémarré. Les utilisateurs peuvent recevoir une erreur indiquant que le serveur est interrompu. De plus, les utilisateurs qui disposent d'une
session ClearQuest ouverte après la fin de la commande peuvent
toujours voir les types d'enregistrement supprimés dans la portée
de leur recherche dans ClearQuest Web.
S'ils tentent de rechercher ces types d'enregistrement, aucune correspondance ne sera trouvée.
Pour que la portée de leur recherche reflète l'index de recherche, ces utilisateurs doivent se reconnecter. Cette commande déclenche la fragmentation de l'index.
Optimisez l'index après l'exécution de cette commande afin que la taille de l'index et les performances soient optimales.
- Statut avec état
- La commande est avec état. Si la commande échoue lors de l'un de ses points d'exécution,
vous pouvez généralement corriger le problème et exécuter à nouveau la
commande. Elle reprendra à partir de là où elle s'est arrêtée. Si une défaillance se produit,
un message d'erreur explique ce qu'il faut faire.
- Exemple
- Vous devez supprimer deux types d'enregistrement à partir de votre index de
recherche.
- Dans le fichier cqtsadmin-TextSearch-SAMPL.xml,
indiquez les types d'enregistrement à supprimer dans la balise XML <removeRecordType>. Séparez les types d'enregistrement à l'aide d'un point-virgule.
<newValue
required="no">Email_Rule;Customer</newValue>
- Exécutez la commande pour supprimer les deux types d'enregistrement.
cqperl
cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb
SAMPL --ftshome D:\CQ.Search --remove_record_type
- Dans le fichier cqtsadmin-TextSearch-SAMPL.xml,
supprimez les deux types d'enregistrement que vous avez ajoutés dans la balise XML <removeRecordType>. Cette tâche de nettoyage empêche une suppression accidentelle si vous ajoutez ultérieurement ces types
d'enregistrement supprimés.
- repair_records
- Récapitulatif
- Si un processus d'indexation en mode de mise à jour ou en mode de traitement par lots contient des erreurs qui empêchent la lecture des enregistrements ou leur envoi au serveur en vue de leur indexation,
un fichier de réparation est créé. Le fichier de réparation répertorie les ID d'enregistrement ClearQuest des enregistrements ayant échoué.
Cette commande lit le fichier de réparation et réindexe un enregistrement à la fois pour réduire le risque d'un autre échec.
- Utilisation
- Dans le cadre de votre déploiement de la recherche en texte intégral, exécutez cette commande lorsque l'indexation par lots est terminée afin d'indexer les enregistrements qui ne l'ont pas encore été. Vous devez régulièrement vérifier le répertoire ftshome à la recherche d'enregistrements qui n'ont pas été indexés
au cours de l'indexation en mode de mise à jour. Si des enregistrements
ne sont pas indexés, vous pouvez voir des fichiers avec cette convention de dénomination nom-type-enregistrementhorodatage.xml.
L'exemple suivant représente un fichier non indexé :Defect1222923990646.xml.
Si vous voyez des fichiers de ce type, exécutez cette commande pour indexer les enregistrements.
- Effet
- Votre index de recherche inclut des données provenant des enregistrements nouvellement indexés.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer ; sauf en cas d'erreur E-S.
- Exemple
- Vous devez indexer les enregistrements qui n'ont pas été indexés au cours de l'indexation
de mise à jour ou de l'indexation par lots.
cqperl cqtsadmin.pl --username admin
--password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search
--repair_records
- restore_was_profiles chemin_de_sauvegarde
- Récapitulatif
- Utilisez cette option de ligne de commande pour restaurer vos profils WebSphere Application Server
de la recherche en texte intégral ClearQuest à partir des
données de sauvegarde qui ont été créées avec l'option de ligne de commande prep_upgd_was_profiles.
- Utilisation
- Les profils WebSphere Application
Server risquent de ne pas être conservés lorsque vous mettez à niveau, modifiez ou
désinstallez ClearQuest.
Les correctifs de la recherche en texte intégral doivent être incorporés dans les
profils WebSphere Application Server actuels après que vous avez appliqué les groupes
de correctifs ClearQuest, qui sont tous gérés par la procédure de préparation-restauration.
Après avoir mis à niveau, modifié ou réinstallé ClearQuest, cette option de ligne de commande restaure tous les profils
WebSphere Application
Server de la recherche en texte intégral ClearQuest qui ont été créés avec l'option
de ligne de commande prep_upgd_was_profiles.
Cette option de ligne de commande échoue si vous tentez de restaurer un profil
WebSphere Application
Server de la recherche en texte intégral ClearQuest qui existe déjà ou qui n'a pas tout d'abord été sauvegardé puis supprimé à l'aide de l'option de ligne de commande prep_upgd_was_profiles.
Vous pouvez exécuter cette option de ligne de commande sur les éléments dbset, userdb
ou ftshome. Elle affectera tous les déploiements de la recherche en texte intégral et tous les profils WebSphere Application Server
dans n'importe quel répertoire de base de profil WebSphere Application
Server sur cet hôte.
Remarque : Vous pouvez utiliser cette option de ligne de commande
avec l'option de ligne de commande fts_was_profile_home
afin d'indiquer une nouvelle destination consolidée pour les profils WebSphere Application Server par rapport à
leur destination d'origine. Utilisez ce commutateur lorsque vous effectuez une mise à niveau à partir de ClearQuest 7.0 (toutes les éditions)
afin de vous assurer qu'un nouveau répertoire de base de profil WebSphere Application
Server est utilisé.
- Effet
- Vos profils WebSphere Application
Server de la recherche en texte intégral sont recréés et restaurés selon
leurs paramètres et emplacements d'origine, ou bien, ils sont consolidés dans le chemin de répertoire
fts_was_profile_home indiqué.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer ; sauf en cas d'erreur E-S.
- Exemple
- Lors de la préparation de votre mise à niveau de ClearQuest, vous avez exécuté l'option de ligne de commande prep_upgd_was_profiles
avec la balise <deleteFtsWASProfiles> définie sur TRUE.
Après avoir mis à niveau ClearQuest,
vous devez restaurer tous les profils WebSphere Application
Server de la recherche en texte intégral ClearQuest à partir des données de sauvegarde. Vous souhaitez également consolider les profils WebSphere Application Server
dans un nouveau répertoire à l'aide de l'option de ligne de commande fts_was_profile_home.
cqperl cqtsadmin.pl --username admin --password
"" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --restore_was_profiles
E:\FTSBackupWASProfiles [ --fts_was_profile_home D:\FTS.WASprofiles
]
Avertissement : Si vous avez personnalisé le fichier Solr schema.xml
afin de prendre en charge une langue autre que l'anglais ou que vous avez apporté des modifications à l'analyseur ou au marqueur sémantique
Solr, les modifications seront perdues. Afin de conserver
les modifications, enregistrez-les et introduisez-les à nouveau après avoir
terminé la mise à niveau. Une fois que vous avez apporté les modifications au fichier schema.xml,
arrêtez et redémarrez le profil WebSphere Application Server de la recherche en texte intégral pour que les modifications
s'appliquent.
- run_batch_idx
- Récapitulatif
- Cette commande démarre l'indexeur en mode de traitement par lots. Elle indexe tous les enregistrements ClearQuest que vous avez configurés pour la
recherche.
Cette commande risque d'échouer si la taille de lot ou le nombre d'unités d'exécution
est défini sur une valeur trop élevée ou que vos enregistrements ClearQuest contiennent une quantité importante
de données. La défaillance la plus courante est une erreur liée à une insuffisance de mémoire. Dans ce cas, réduisez la taille des lots ou le nombre des unités d'exécution en cours d'utilisation.
Le résultat est une augmentation de la durée d'indexation. Vous pouvez également
augmenter la mémoire de la machine virtuelle Java™
(JVM) pour l'indexeur en mode de traitement par lots à l'aide de la balise XML <batchIndexJVMParm>
et pour la mémoire du serveur de recherche à l'aide de la balise XML <ftsWASProfileMaxHeapSize>. Si vous devez augmenter la mémoire, cette exigence est temporaire et ne dure que tant que l'indexeur par lots s'exécute. Le support client IBM Rational
peut vous aider à déterminer la meilleure action à prendre dans de telles circonstances. Si la
commande s'arrête avant d'être terminée, vous pouvez la redémarrer. Elle reprendra son exécution
là où elle s'est arrêtée.
- Utilisation
- Vous n'avez pas besoin d'utiliser cette commande directement. Elle est appelée lorsque
vous exécutez l'option de ligne de commande setup_cq_fts. Cette commande
est fournie si vous devez affiner ou déboguer votre déploiement.
- Effet
- Cette commande exécute des requêtes SQL ClearQuest sur votre base de données ClearQuest.
Elle envoie ensuite les enregistrements qui ont été trouvés au serveur de recherche Solr
en vue de leur indexation. En effet, alors que cette commande est exécutée, votre serveur de base de données ClearQuest est occupé à envoyer des données à la recherche en texte intégral ClearQuest et votre index de recherche est mis à jour. Si vous avez besoin d'exécuter cette
commande, exécutez-la pendant les heures creuses afin de réduire la charge ou les effets sur les performances
de votre serveur de base de données.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer, sauf en cas d'erreur E-S, d'erreur liée à une insuffisance de mémoire ou d'erreur de configuration inattendue.
- Exemple
- Vous devez indexer tous les enregistrements ClearQuest.
cqperl
cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb
SAMPL --ftshome D:\CQ.Search --run_batch_idx
- scrub_oplog avant-date
- Récapitulatif
- Cette commande permet d'épurer les journaux oplog d'une base de données utilisateur ClearQuest non répliquée. ClearQuest génère des journaux oplog
afin de conserver une trace des modifications que vous avez apportées aux enregistrements. La recherche en texte intégral ClearQuest
surveille les journaux oplog lors de l'indexation en mode de mise à jour afin de synchroniser l'index de recherche avec ces
modifications.
Les journaux oplog correspondent à des données temporaires. Vous n'avez pas besoin de les conserver indéfiniment. Pour éviter une croissance continue des journaux oplog sur les bases de données non répliquées,
épurez de temps en temps, mais le moins souvent possible, les anciens journaux oplog. Utilisez
le rythme de création des journaux oplog pour déterminer quand effectuer l'épuration.
Si votre
base de données utilisateur ClearQuest est répliquée,
utilisez votre outil de réplication ainsi que la politique pour l'épuration des journaux oplog. Si vous tentez
d'utiliser cette commande sur des bases de données répliquées, elle échoue avec
un message d'erreur vous demandant
d'utiliser des outils de réplication.
N'épurez jamais la totalité des
journaux oplog, en particulier si certains d'entre eux n'ont pas encore été traités par
l'indexeur en mode de mise à jour. Dans le cas contraire, votre index de recherche
ne sera pas synchronisé avec les enregistrements ClearQuest.
Les recherches risquent d'être imprécises ou incomplètes. Ce scénario nécessite la réindexation en mode de traitement par lots.
Une épuration agressive des
journaux oplog lorsque la capacité de traitement de l'indexeur en mode de mise à jour est insuffisante risque d'entraîner un manque de précision de l'index et des occurrences non trouvées. Assurez-vous que l'indexeur en mode de mise à jour est à jour, épurez uniquement
les journaux qui datent de plus d'un mois ou n'épurez pas les journaux
oplog.
- Utilisation
- Afin de préserver l'espace de base de données et de nettoyer les données non utilisées,
vous devrez peut-être
épurer les journaux oplog sur une base de données utilisateur ClearQuest non répliquée. Si votre base de données ClearQuest est répliquée, n'utilisez pas cette commande.
- Effet
- Les journaux oplog ClearQuest
de votre table de journaux oplog qui ont été créés avant la date indiquée sont supprimés.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer ; sauf en cas d'erreur E-S.
- Exemple
- En tant qu'administrateur ClearQuest,
vous planifiez d'épurer régulièrement les anciens journaux oplog. Pour obtenir des
informations sur les formats de date qui sont pris en charge,
consultez la référence de la commande scruboplog.
cqperl
cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb
SAMPL --ftshome D:\CQ.Search --scrub_oplog "31-Oct-2009"
- setup_cq_fts
- Récapitulatif
- Cette commande permet d'effectuer un déploiement de la recherche en texte intégral.
Premièrement, l'option personnalise et configure les fichiers suivants, en fonction
de votre fichier de configuration d'administration de la recherche en texte intégral, de votre base de données ClearQuest et de votre système d'exploitation :
- Fichier d'entités
- Fichier XML des propriétés de la recherche en texte intégral
- Fichier Solr schema.xml
- Deuxièmement, elle active la recherche en texte intégral ClearQuest dans ClearQuest Web
en activant le bouton d'option Full Text. La génération des journaux oplog
démarre si votre base de données ClearQuest
est de niveau de fonctionnalité 7 et qu'elle n'est pas répliquée. Troisièmement, elle démarre l'indexation en mode de traitement par lots en indexant tous les enregistrements ClearQuest pour les types d'enregistrement que vous avez définis pour la recherche dans le fichier d'entité.
Enfin, elle active l'indexation en mode de mise à jour, ce qui finalise votre déploiement.
Cette commande conserve son état. Si une erreur se produit avant qu'elle se termine,
l'état est défini et vous devez corriger l'erreur avant de pouvoir continuer.
Le message d'erreur et les journaux contiennent des instructions sur la manière de récupérer suite à cette erreur. Les étapes de récupération dépendent de l'erreur et de l'état dans lequel elle s'est produite.
- Utilisation
- Utilisez cette commande pour effectuer votre déploiement de la recherche en texte intégral.
En général, vous exécutez cette commande après avoir personnalisé le fichier d'entité.
Pendant l'exécution de cette commande, le bouton d'option Full Text est
activé dans ClearQuest Web.
Les utilisateurs qui se connectent à nouveau peuvent effectuer une recherche. Les résultats de
la recherche ne sont pas complets tant que le déploiement n'est pas terminé. Le bouton d'option doit être activé,
tout particulièrement lorsque la base de données ClearQuest n'est pas répliquée, parce que les journaux oplog doivent être générés
pour capturer toutes les modifications d'enregistrement qui se produisent pendant et après l'indexation en mode de traitement par lots.
L'ordinateur sur lequel vous déployez la recherche en texte intégral est très sollicité parce que l'indexation en mode de traitement par lots repose
fortement sur le processeur, l'E-S et la mémoire, si vous augmentez le paramètre de mémoire
JVM par défaut. En fonction du degré d'agressivité défini pour votre indexeur en mode de traitement par lots
par l'augmentation de la taille de lot et du nombre d'unités d'exécution, l'utilisation de votre
base de données ClearQuest peut être extrêmement élevée
lors de l'indexation en mode de traitement par lots.
- Effet
- Plusieurs fichiers sont créés dans votre répertoire ftshome. L'index
est créé. Les services de recherche sous WebSphere Application
Server sont activés. Et votre base de données ClearQuest
est mise à jour afin d'inclure le fichier XML des propriétés de la recherche en texte intégral. Si votre
base de données ClearQuest n'est pas
répliquée, la création d'oplogs est activée. Les bases de données utilisateur ClearQuest
répliquées poursuivent la création d'oplogs.
- Statut avec état
- La commande est avec état. Si la commande échoue lors de l'un de ses points d'exécution, vous devez pouvoir corriger le problème et réexécuter la commande. La commande continue là où elle s'était arrêtée. Si un échec se produit, un message d'erreur vous indique ce que vous devez faire. Si une erreur se produit avant qu'elle se termine,
l'état est défini et vous devez corriger l'erreur avant de pouvoir continuer. Le message d'erreur et les journaux contiennent des instructions sur la manière de récupérer suite à cette erreur. Les étapes de récupération dépendent de l'erreur et de l'état dans lequel elle s'est produite.
- Exemple
- Vous avez exécuté l'option de ligne de commande init_cq_fts
et modifié votre fichier d'entité. Vous devez maintenant terminer le déploiement.
cqperl
cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb
SAMPL --ftshome D:\CQ.Search --setup_cq_fts
- set_was_max_mem
- Récapitulatif
- Cette commande permet de définir la mémoire JVM maximale que le profil WebSphere Application Server
peut utiliser. La valeur par défaut est de 300 Mo, ce qui peut être trop faible pour
l'indexation en mode de traitement par lots dans ces situations :
- La taille de lot a été augmentée
- Le nombre d'unités d'exécution a été augmenté
- Les types d'enregistrement ClearQuest
sont complexes
Cette commande lit le paramètre de mémoire à partir de la balise XML <ftsWASProfileMaxHeapSize>
dans votre fichier de configuration. Il définit ensuite la mémoire JVM sur
cette valeur.
- Utilisation
- Si l'indexation en mode de traitement par lots échoue parce que le serveur de profil WebSphere Application
Server rapporte une erreur liée à une insuffisance de mémoire, le paramètre de mémoire est probablement trop faible.
Effectuez l'une des actions suivantes pour récupérer suite à une erreur liée à une insuffisance de mémoire :
- Réduisez la taille de lot et le nombre d'unités d'exécution pour augmenter le temps nécessaire
pour effectuer l'indexation.
- Augmentez temporairement la mémoire JVM. La mémoire JVM maximale doit en général être définie sur une valeur plus élevée jusqu'à la fin de l'indexation en mode de traitement par lots.
- Effet
- Le paramètre de mémoire JVM maximum pour le profil WebSphere Application Server passe à la nouvelle valeur. En effet, une quantité supérieure de mémoire système est allouée au profil WebSphere Application Server
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer ; sauf en cas d'erreur E-S.
- Exemple
- Vous recevez des erreurs liées à une insuffisance de mémoire provenant du profil WebSphere Application Server pendant
l'indexation. Vous devez régler ce problème avant de continuer.
- Définissez la mémoire JVM sur 1,5 Go dans la balise XML <ftsWASProfileMaxHeapSize>
dans le fichier cqtsadmin-TextSearch-SAMPL.xml.
<newValue
required="no">1536</newValue>
- Exécutez cette commande pour définir le nouveau paramètre de mémoire JVM :
cqperl
cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb
SAMPL --ftshome D:\CQ.Search --set_was_max_mem
- set_solr_home
- Récapitulatif
- Cette commande permet de définir le répertoire de base Solr sous WebSphere Application Server.
Chaque déploiement dispose de son propre fichier de configuration schema.xml
et de son propre index. Si le répertoire de base Solr n'est pas correctement défini
ou que le mauvais emplacement est indiqué, le profil de la recherche en texte intégral WebSphere Application Server risque de ne pas démarrer. Si le profil de la recherche en texte intégral WebSphere Application
Server ne démarre pas, des erreurs sont consignées dans le répertoire de journaux du profil WebSphere Application
Server de la recherche en texte intégral correspondant dans le chemin %your-WAS-profile-home%/<cqfts>_<dbset>_<userdb>/logs/server1/logs/.
- Utilisation
- Vous n'avez pas besoin d'utiliser cette commande directement. Elle est appelée lorsque
vous exécutez l'option de ligne de commande setup_cq_fts. Cette commande
est fournie si vous devez affiner ou déboguer votre déploiement.
- Effet
- La propriété JVM du profil WebSphere Application Server déployé est modifiée de sorte que la variable d'environnement du répertoire de base
Solr soit définie.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer ; sauf en cas d'erreur E-S.
- Exemple
- Le service de support logiciel IBM Rational vous a demandé d'utiliser cette commande pour
déboguer un problème de déploiement de la recherche en texte intégral ou pour personnaliser un déploiement.
cqperl cqtsadmin.pl --username
admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search
--set_solr_home
- show_scenarios [ID | all]
- Récapitulatif
- Cette commande permet d'afficher une liste de scénarios avec des exemples d'utilisation de l'outil
cqtsadmin.pl. Ces scénarios
correspondent à une forme réduite des scénarios qui sont répertoriés dans le centre d'informations. La liste peut ne pas être complète
ou la correspondance peut ne pas être exacte.
- Utilisation
- Utilisez cette option de ligne de commande pour afficher une liste des scénarios les plus fréquemment utilisés
pour l'outil cqtsadmin.pl. Exécutez la commande sans paramètre pour voir les ID et titres des scénarios.
Exécutez la commande avec un paramètre d'ID de scénario afin d'afficher le texte
complet d'un scénario. Exécutez la commande avec le paramètre all pour afficher
une liste complète de scénarios, chacun avec un ID, un titre et une description textuelle complète.
- Effet
- Les données et les paramètres du déploiement de la recherche en texte intégral ne sont pas
affectés.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer ; sauf en cas d'erreur E-S.
- Exemple
- Vous êtes sur le point d'utiliser l'outil cqtsadmn.pl pour effectuer une tâche,
mais vous ne savez plus comment l'utiliser. Utilisez cette option de ligne de commande pour répertorier les titres de scénario ainsi que leurs ID. Exécutez ensuite cette commande à nouveau et passez
l'ID du scénario qui vous intéresse afin d'en afficher le texte complet.
cqperl cqtsadmin.pl --username
admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search
--show_scenarios
- start_fts_was_profile
- Récapitulatif
- Cette commande permet de démarrer un service du profil WebSphere Application Server de la recherche en texte intégral.
Un profil WebSphere Application
Server de la recherche en texte intégral doit être démarré pour les demandes
de recherche qu'il faudra satisfaire.
Un profil doit également être démarré pour que l'indexeur en mode de mise à
jour démarre la recherche d'enregistrements qui sont nouveaux ou modifiés et les envoie
au moteur de recherche en vue de leur indexation.
- Utilisation
- Vous n'avez pas besoin d'utiliser cette commande directement. Elle est appelée lorsque
vous exécutez l'option de ligne de commande setup_cq_fts. Cette commande
est fournie si vous devez affiner ou déboguer votre déploiement.
- Effet
- Si le profil WebSphere Application
Server de la recherche en texte intégral a été arrêté, il va démarrer, entraînant une utilisation temporaire des ressources processeur et de la mémoire. Si les services de recherche et l'indexeur en mode de mise à jour sont activés, leur exécution démarre. Si le profil WebSphere Application Server est déjà démarré,
aucun changement n'est apporté.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer, sauf en cas d'erreur E-S,
d'une défaillance du serveur ou d'un échec de démarrage du profil WebSphere Application Server,
qui provient généralement de problèmes de configuration.
- Exemple
- Le service de support logiciel IBM vous a demandé de
démarrer le profil WebSphere Application
Server de la recherche.
cqperl cqtsadmin.pl --username admin --password
"" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --start_fts_was_profile
- start_update_idx
- Récapitulatif
- Cette commande permet d'activer et de démarrer l'indexeur en mode de mise à jour,
qui s'exécute sous le profil WebSphere Application
Server. L'indexeur en mode de mise à jour synchronise l'index de recherche
avec les modifications qui ont été apportées à la base de données ClearQuest.
L'indexeur surveille les journaux oplog à la recherche de nouvelles valeurs à indexer. Vous configurez la
fréquence selon laquelle l'index est synchronisé à l'aide de la balise XML <updateIndexDelay>
dans votre fichier de configuration d'administration de la recherche en texte intégral.
- Utilisation
- Vous n'avez pas besoin d'utiliser cette commande directement. Elle est appelée lorsque
vous exécutez l'option de ligne de commande setup_cq_fts. Cette commande
est fournie si vous devez affiner ou déboguer votre déploiement.
- Effet
- L'indexeur en mode de mise à jour est activé et démarré. Les modifications,
les ajouts et les suppressions d'enregistrements ClearQuest
sont désormais indexés et apparaissent dans les résultats de la recherche.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer, sauf en cas d'erreur E-S,
d'une défaillance du serveur ou d'un échec de démarrage du profil WebSphere Application Server,
qui provient généralement de problèmes de configuration.
- Exemple
- Le service de support logiciel IBM vous a demandé d'activer
l'indexeur de mise à jour.
cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --start_update_idx
- stop_fts_was_profile
- Récapitulatif
- Cette commande permet d'arrêter le service du profil WebSphere Application Server de la recherche en texte intégral.
Lorsqu'un profil WebSphere Application
Server s'arrête, les services de recherche ne sont plus disponibles et l'indexeur en mode de mise à jour arrête la synchronisation de l'index de recherche avec les modifications qui ont été apportées à vos enregistrements ClearQuest.
- Utilisation
- Vous n'avez pas besoin d'utiliser cette commande directement. Elle est appelée lorsque
vous exécutez l'option de ligne de commande setup_cq_fts. Cette commande
est fournie si vous devez affiner ou déboguer votre déploiement.
- Effet
- Le profil WebSphere Application
Server de la recherche en texte intégral s'arrête, ce qui arrête également les services de recherche et l'indexation de mise à jour. La mémoire et la puissance du processeur utilisées par le profil WebSphere Application Server
sont libérées. Une recherche entraîne une erreur.
Le journal oplog continue à recevoir
des messages tant que le bouton d'option Full Text
reste activé dans ClearQuest Web.
Cela permet à l'indexeur en mode de mise à jour d'intégrer les modifications après que le profil WebSphere Application Server
est à nouveau exécuté.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer ; sauf en cas d'erreur E-S.
- Exemple
- Le service de support logiciel IBM vous a demandé
d'arrêter le profil WebSphere Application
Server de la recherche.
cqperl cqtsadmin.pl --username admin --password
"" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --stop_fts_was_profile
- stop_update_idx
- Récapitulatif
- Cette commande permet de désactiver et d'arrêter l'indexeur en mode de mise à jour.
Lorsque l'indexeur en mode de mise à jour s'arrête, les services de recherche sont disponibles, mais les modifications qui sont apportées aux enregistrements ClearQuest ne sont pas répercutées dans
l'index tant que l'indexation en mode de mise à jour n'est pas réactivée ou reprise. C'est pourquoi les recherches peuvent donner des résultats imprécis ou qui ne sont pas à jour.
- Utilisation
- Vous n'avez pas besoin d'utiliser cette commande directement. Elle est appelée
lorsque vous exécutez les options de ligne de commande setup_cq_fts et backup_fts. Cette commande
est fournie si vous devez affiner ou déboguer votre déploiement.
- Effet
- L'indexeur en mode de mise à jour, qui s'exécute sous le profil WebSphere Application Server, est désactivé. Les enregistrements ClearQuest qui sont nouveaux ou modifiés ne sont pas répercutés dans les résultats de la recherche. Le journal oplog continue à recevoir des
messages. Les modifications des enregistrements ClearQuest
ne sont pas répercutées dans les recherches en texte intégral après que l'indexeur des enregistrements en mode de mise à jour est réactivé ou après qu'il intègre les modifications avec les journaux
oplog actuels.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer ; sauf en cas d'erreur E-S.
- Exemple
- Le service de support IBM vous a demandé
de désactiver l'indexeur en mode de mise à jour.
cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --stop_update_idx
- unlock_cq_fts
- Récapitulatif
- Cette commande permet de déverrouiller un déploiement verrouillé d'une recherche
en texte intégral. Une fois que la commande est terminée, vous pouvez exécuter toutes les commandes d'administration de la recherche en texte intégral
disponibles.
- Utilisation
- Utilisez cette commande pour déverrouiller un déploiement verrouillé d'une recherche en texte intégral afin que vous puissiez exécuter toutes les commandes disponibles. Cette commande inverse
le verrouillage défini par l'option de ligne de commande lock_cq_fts.
- Effet
- Aucun. Les données et les paramètres de votre déploiement de la recherche en texte intégral ne sont pas affectés et toutes les commandes peuvent
être exécutées.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer ; sauf en cas d'erreur E-S.
- Exemple
- Vous devez optimiser votre index, mais votre déploiement est verrouillé.
Vous devez le déverrouiller, optimiser l'index, puis à nouveau le verrouiller.
cqperl
cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb
SAMPL --ftshome D:\CQ.Search --unlock_cq_fts --optimize_idx --lock_cq_fts
- update_fts_prop_files
- Récapitulatif
- Permet de propager les modifications que vous avez apportées dans le fichier de configuration d'administration de la recherche en texte intégral cqtsadmin-dbset-userdb.xml. Après avoir modifié l'une des
balises XML suivantes dans le fichier de configuration, nous devez propager les modifications pour qu'elles s'appliquent :
- <batchIndexBatchSize>
- <batchIndexDelay>
- <batchIndexThreads>
- <ftsServerName>
- <ftsWASProfileName>
- <ftsWASProfilePort>
- <updateIndexBatchSize>
- <updateIndexDelay>
- <updateIndexLoginInterval>
Par exemple, si vous modifiez la taille de lot pour l'indexeur en mode de traitement par lots,
vous devez exécuter cette commande avant d'exécuter l'option en ligne de commande run_batch_idx pour la nouvelle valeur à utiliser.
Remarque : Lorsque vous changez
le mot de passe de l'administrateur, utilisez
update_fts_prop_files (spécification
du nouveau mot de passe) pour vous assurer que le fichier de mot de passe (
pwd.txt)
est à jour et que l'indexation par lots des nouveaux enregistrements peut reprendre ; par exemple :
cqperl cqtsadmin.pl --username admin --password nouveau_mot_de_passe --dbset 7.0.0 --userdb SAMPL --ftshome C:\CQ.Search --fresh_batch_idx
- Utilisation
- Lorsque vous déployez la recherche en texte intégral, vous devrez peut-être changer
un paramètre par défaut. Lorsqu'une modification est apportée au fichier de configuration, la modification doit être propagée aux composants de la recherche en texte intégral appropriés.
- Effet
- Le composant affecté dépend de la valeur de balise XML que vous avez modifiée.
Pour plus d'informations, voir
cqtsadmin-dbset-userdb.xml.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer ; sauf en cas d'erreur E-S.
- Exemple
- Vous devez accélérer l'indexation en mode de traitement par lots en augmentant la taille des lots et le nombre des unités d'exécution. Après avoir modifié le fichier de configuration,
exécutez cette commande.
cqperl cqtsadmin.pl --username admin
--password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search
--update_fts_prop_files --run_batch_idx
- upgrade_solr_app
- Récapitulatif
- Cette option de ligne de commande vérifie si la version d'Apache Solr de votre déploiement de la recherche en texte intégral actuel est la version la plus récente distribuée avec votre version de
ClearQuest.
Si ce n'est pas le cas, l'option met à niveau Apache Solr.
- Utilisation
- Une version plus récente de ClearQuest peut
prendre en charge des versions d'Apache Solr plus récentes que la version utilisée par votre déploiement actuel de la recherche en texte intégral. Lorsque vous mettez à niveau ClearQuest et vos déploiements de la recherche en texte intégral qui utilisent les options de ligne de commande
prep_upgd_was_profiles et restore_was_profiles, votre application Apache Solr n'est pas automatiquement mise à niveau.
Cette approche de mise à niveau est intentionnelle, parce que le format de l'index peut
avoir changé, ce qui nécessiterait une réindexation complète. Utilisez cette commande
pour mettre à niveau Apache Solr vers la version prise en charge la plus récente.
Avant d'utiliser
cette option de ligne de commande, vous devez effectuer une sauvegarde de votre déploiement de la recherche en texte intégral en utilisant l'option de ligne de commande backup_fts.
De plus, consultez les notes sur l'édition IBM Rational ClearQuest pour savoir si vous devez réindexer votre base de données ClearQuest après la mise à niveau d'Apache Solr. Il est possible que vous deviez exécuter à nouveau l'indexation si
le format de l'index d'Apache Solr a changé.
Après avoir exécuté cette option de ligne de commande, vous devez exécuter l'option de ligne de commande
stop_fts_was_profile, puis exécuter l'option de ligne de commande
start_fts_was_profile
pour que la mise à niveau s'applique.
Important : Vous devez exécuter cette option
de ligne de commande après avoir mis à niveau ClearQuest et vos déploiements
de la recherche en texte intégral en utilisant les options de ligne de commande
prep_upgd_was_profiles et restore_was_profiles. Si ce n'est pas le cas, des problèmes inconnus peuvent survenir.
- Effet
- Votre application Apache Solr existante est mise à niveau vers la version la plus récente
prise en charge. La recherche en texte intégral ClearQuest
n'est disponible que lorsque la mise à niveau a été effectuée.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer, sauf en cas d'erreur E-S ou d'erreurs WebSphere Application
Server.
- Exemple
- Vous souhaitez mettre à niveau Apache Solr pour l'un de vos déploiements de la recherche en texte intégral. Effectuez
une sauvegarde de votre déploiement de la recherche en texte intégral en exécutant la commande
cqtsadmin.pl avec l'option backup_fts.
cqperl
cqtsadmin.pl --username admin --password secret --dbset TextSearch
--userdb SAMPL --ftshome D:\CQ.Search --backup_fts E:\FTS.Backup
Mettez
à niveau l'application Solr en exécutant à nouveau la commande cqtsadmin.pl avec l'option de ligne de commande
upgrade_solr_app :
cqperl
cqtsadmin.pl --username admin --password secret --dbset TextSearch
--userdb SAMPL --ftshome D:\CQ.Search --upgrade_solr_app
Si un message s'affiche
vous demandant d'effectuer une nouvelle indexation de votre base de données utilisateur, exécutez quatre fois la commande cqtsadmin.pl avec les options de ligne de commande stop_update_idx, run_batch_idx, optimize_idx
et start_update_idx :
cqperl
cqtsadmin.pl --username admin --password secret --dbset TextSearch
--userdb SAMPL --ftshome D:\CQ.Search --stop_update_idx
cqperl cqtsadmin.pl --username admin --password
secret --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --run_batch_idx
cqperl cqtsadmin.pl --username admin --password
secret --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --optimize_idx
cqperl cqtsadmin.pl --username admin --password
secret --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --start_update_idx
Si vous disposez de déploiements de la recherche en texte intégral supplémentaires pour d'autres bases de données
ClearQuest,
exécutez les commandes précédentes sur chaque base de données.
- was_profile_ports_file
- Récapitulatif
- Cette option de ligne de commande vous permet d'éventuellement fournir votre propre fichier
des ports du profil WebSphere Application
Server, qui est utilisé avec l'option de ligne de commande create_fts_was_profile
lorsqu'un profil de recherche en texte intégral est créé.
- Utilisation
- Lorsque vous créez un nouveau déploiement de la recherche en texte intégral, vous créez un nouveau profil WebSphere Application
Server par défaut. L'outil d'administration de la recherche en texte intégral
permet de déterminer le port disponible suivant à utiliser sur votre système. Si vous avez besoin d'ajuster
votre déploiement et d'indiquer vos propres ports à utiliser, vous devez créer votre propre fichier des ports. Utilisez ensuite l'option was_profile_ports_file
pour indiquer à l'outil d'administration de la recherche en texte intégral d'utiliser votre fichier des
ports. Vous pouvez utiliser le modèle qui se trouve dans le fichier portdef.props de votre installation WebSphere.
Le fichier portdef.props se trouve généralement dans le répertoire
\IBM\WebSphere\AppServer\profileTemplates\default\actions\portsUpdate\.
Pour plus d'informations sur le fichier des ports du profil WebSphere Application Server, consultez la commande manageprofiles. Exemple : Section relative à l'utilisation des numéros de port prédéfinis dans le
centre d'informations WebSphere Application Server. http://pic.dhe.ibm.com/infocenter/wasinfo/v8r0/index.jsp?topic=%2Fcom.ibm.websphere.base.doc%2Finfo%2Faes%2Fae%2Frxml_manageprofiles.html
Cette option de ligne de commande est utilisée avec l'option
create_fts_was_profile.
Remarque : Si
vous utilisez vos propres ports, assurez-vous que vos ports ne sont pas utilisés par d'autres
applications. Si ce n'est pas le cas, vous risquez de rencontrer des problèmes avec la recherche en texte intégral et d'autres
applications.
- Effet
- Les ports que vous indiquez avec cette commande sont utilisés à la place
des ports indiqués par l'outil d'administration de la recherche en texte intégral.
- Statut avec état
- Cette option est sans état. Cette commande ne doit jamais échouer ; sauf en cas d'erreur E-S.
- Exemple
- Vous devez indiquer votre propre ensemble de ports à utiliser.
- Faites une copie du fichier portdef.props, puis
indiquez votre propre valeur de port.
- Exécutez cette commande pour créer un nouveau déploiement de la recherche en texte intégral qui utilise l'option was_profile_ports_file pour indiquer vos
propres ports.
cqperl cqtsadmin.pl --username admin --password
"" --dbset MASTR --userdb SAMPL --ftshome D:\CQ.Search --init_cq_fts
--create_fts_was_profile automatic --fts_was_profile_home D:\FTS.WASprofiles
--was_profile_ports_file D:\my-portdef.props
- Poursuivez l'utilisation de votre déploiement de la recherche en texte intégral.