cqtsadmin.pl

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égral
Ré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 :

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.
  1. Editez le fichier cqtsadmin-TextSearch-SAMPL.xml, puis modifiez la balise <addRecordType>.

    <newValue required="no">Customer=CustomerNum,address,phone,product</newValue>

  2. Créez une sauvegarde.

    cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --backup_fts E:\FTSBackup

  3. Ajoutez le nouveau type d'enregistrement.

    cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --add_record_type

  4. 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.
  1. 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

  2. Modifiez votre fichier d'entité pour qu'il ne contienne que les types d'enregistrement et les zones qui vous intéressent.
  3. 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.
  1. Supprimez le profil WebSphere Application Server.

    cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --delete_fts_was_profile

  2. 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.
  3. 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

  4. 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.
  1. 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

  2. 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

  3. Exécutez l'optimisation d'index.

    cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --optimize_idx

  4. 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.
  1. 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

  2. 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

  3. 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.
  1. 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.

  2. 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

  3. Modifiez la valeur de la balise XML <deleteFtsWASProfiles> en FALSE ou supprimez la valeur TRUE.
  4. Effectuez la mise à niveau ClearQuest, la modification de la fonction de recherche en texte intégral ou la réinstallation.
  5. 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 :
    • Pour ClearQuest 8.0 (toutes les éditions), conservez les emplacements de base de profils WebSphere Application Server d'origine et restaurez-les dans leurs emplacements uniques d'origine :

      cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --restore_was_profiles E:\FTSBackupWASProfiles

    • Pour ClearQuest 8.0 (toutes les éditions) et 7.0 (toutes les éditions), consolidez tous les profils WebSphere Application Server dans un répertoire de base de profils WebSphere Application Server lors de la restauration.

      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

  6. 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.
  1. 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>

  2. 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

  3. 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.
  1. 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>

  2. 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.
  1. Faites une copie du fichier portdef.props, puis indiquez votre propre valeur de port.
  2. 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

  3. Poursuivez l'utilisation de votre déploiement de la recherche en texte intégral.

Feedback