Pour pouvoir utiliser la recherche contextuelle, vous devez installer
et démarrer le moteur de recherche sur votre système d'exploitation. Si un serveur est renommé, redémarrez le moteur de recherche contextuelle de sorte qu'il pointe vers la nouvelle URL du référentiel.
Procédure
- Ouvrez une invite de commande pour votre plateforme et
accédez au sous-répertoire rép_install_moteur/jazz/searchengine/eclipse,
où rép_install_moteur est l'emplacement d'extraction du moteur de recherche. Vous pouvez exécuter le composant à l'aide des fichiers de script ou du fichier exécutable (search_engine.exe ou search_engine).
Vous devrez peut-être éditer
le fichier script dans un éditeur de texte pour vous assurer que la variable d'environnement JAVA_HOME
est correctement définie dans l'emplacement d'IBM® JRE.
Par défaut, un répertoire catt est créé dans le répertoire de travail en cours, et des données
sont écrites dans ce dernier. Vous pouvez modifier le répertoire de travail
avec le paramètre -baseOutputDir de la commande search_engine. Si vous
exécutez la commande search_engine sans paramètre, un message s'affiche
pour indiquer les options du paramètre. Vous pouvez démarrer le moteur de recherche à l'aide de l'une des commandes suivantes :
- Sous Windows :
search_engine.bat -repository URLréférentiel -userId nom_util
-pass motdepasse -engineId moteur
ou search_engine.exe -vm cheminJre/bin/java -repository URLréférentiel
-userId nom_util -pass motdepasse -engineId moteur
- Sous Linux, Linux on
z/OS, Linux on Power PC,
AIXou Solaris :
./search_engine.sh -repository URLréférentiel -userId nom_util
-pass motdepasse -engineId moteur
ou ./search_engine -vm cheminJre/bin/java -repository URLréférentiel
-userId nom_util -pass motdepasse -engineId moteur
Où :
- CheminJre est le chemin vers IBM JRE. Il peut s'agir
du sous-répertoire jdk ou eclipse/jdk, selon la méthode d'installation
utilisée.
- URLréférentiel correspond à l'URL du référentiel : par exemple, https://nom_hôte.exemple.com:9443/ccm/.
- nom_util est le nom d'un utilisateur doté des droits d'accès en lecture
aux zones du projet à indexer.
- motdepasse correspond au mot de passe utilisateur.
- moteur représente l'identificateur du moteur de recherche.
- Facultatif. -passwordFile chemin fichier mots de passe est le chemin d'accès à un
fichier de mots de passe codés créé avec le paramètre -createPasswordFile. (Voir ci-dessous.)
- Facultatif. Vous pouvez utiliser -baseOutputDir rép comme paramètre
supplémentaire. Dans ce cas, rép sert de répertoire de base
pour l'écriture et la lecture des fichiers. Cela est nécessaire
si le répertoire de travail en cours est accessible en lecture seule. Par défaut un répertoire catt
est créé sous le répertoire de travail en cours et sert de répertoire de base.
Remarque : Si vous tentez d'exécuter
une instance supplémentaire du moteur de recherche avec le même répertoire de sortie que celui configuré
avec le paramètre
-baseOutputDir pour une instance en cours d'exécution,
la nouvelle instance se ferme avec message suivant :
Cette application va quitter - répertoire de sortie
utilisée par une instance de moteur de recherche en cours d'exécution.
- Facultatif. -verbose active la sortie en mode prolixe.
- Facultatif. -createPasswordFile pass.txt,
où pass.txt est le chemin d'accès à un
fichier de mots de passe codés créé avec le paramètre -createPasswordFile. pass.txt peut correspondre à tout nom de fichier.
Remarque : Entrez la commande avec le paramètre
-createPasswordFile comme suit :
- Windows :
search_engine.bat -createPasswordFile pass.txt
- Linux, Linux sous z/OS, Linux sous Power PC, AIX ou Solaris :
./search_engine.sh -createPasswordFile pass.txt
- IBM i :
./search_engine.sh -createPasswordFile pass.txt
- Pour arrêter un moteur de recherche, appuyez sur CTRL+C dans l'écran de commande du moteur de recherche. Sous IBM i,
si vous exécutez le moteur de recherche en mode interactif, appuyez sur F3 pour quitter le Qshell et l'arrêter.