Mise à niveau ou réinstallation de ClearQuest dans un déploiement de recherche en texte intégral avec plusieurs profils WebSphere

IBM Installation Manager ne reconnaît pas les profils WebSphere Application Server associés à la fonction de recherche en texte intégral. Par conséquent, si vous prévoyez de mettre à niveau ou de réinstaller IBM Rational ClearQuest, utilisez la commande cqtsadmin.pl pour sauvegarder et supprimer ces profils. Après la mise à niveau ou la réinstallation du ClearQuest, utilisez à nouveau la commandecqtsadmin.pl pour restaurer les profils.

Avant de commencer

Ce scénario inclut les étapes à effectuer avant et après la mise à jour ou la réinstallation de ClearQuest.

Le scénario suppose que vous utilisez la base de données SAMPL. Dans un environnement de production, les étapes d'avant-mise à niveau ou d'avant-installation, ainsi que les étapes d'après-mise à niveau ou d'après-réinstallation, peuvent durer entre quelques minutes et quelques heures, selon le nombre de profil WebSphere Application Server de recherche en texte intégral dans votre déploiement. Pour chaque profil, les étapes doivent durer quelques minutes.

Notez que vous pouvez exécuter la commande cqtsadmin.pl sur n'importe quelle instance de recherche en texte intégral sur le serveur car cette commande est commune à tous les déploiements de recherche en texte intégral sur le serveur. Une fois la commande cqtsadmin.pl exécutée sur un déploiement de recherche en texte intégral, les autres déploiements sur le serveur sont mis à niveau.

Procédure

  1. Effectuez les tâches d'avant-mise à niveau ou d'avant-installation suivantes.
    1. Editez le fichier de configuration cqtsadmin-TextSearch-SAMPL.xml. Remplacez la valeur de la balise <deleteFtsWASProfiles> :

      <newValue required="no"><newValue>

      par :

      <newValue required="no">true<newValue>

    2. Exécutez la commande cqtsadmin.pl avec l'option prep_upgd_was_profiles dans une fenêtre d'invite de commande. Cette option de ligne de commande crée une sauvegarde de toutes vos données de profil WebSphere Application Server de recherche en texte intégral sur le serveur, puis supprime les profils. Les données sauvegardées sont enregistrées dans le répertoire FTSBackupWASProfiles.
    3. Editez le fichier cqtsadmin-TextSearch-SAMPL.xml une nouvelle fois. Remplacez la valeur de la balise <deleteFtsWASProfiles> :

      <newValue required="no">true<newValue>

      par :

      <newValue required="no"><newValue>

    L'édition vous empêche de réexécuter accidentellement cette option de ligne de commande destructive.

  2. Mettez à niveau ou réinstallez ClearQuest.
  3. Réxécutez la commande cqtsadmin.pl pour restaurer tous les profils WebSphere Application Server de recherche en texte intégral précédemment déployés et sauvegardés. Il existe deux scénarios de cas d'utilisation :
    • Scénario A : Restaurez tous les profils WebSphere Application Server de recherche en texte intégral précédemment déployés et sauvegardés à leur emplacement d'origine à l'aide de l'option de ligne de commande restore_was_profiles :

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

    • Scénario B : Restaurez tous les profils WebSphere Application Server de recherche en texte intégral précédemment déployés et sauvegardés, et consolidez ces profils dans un répertoire, à l'aide des options de ligne de commande restore_was_profiles et fts_was_profile_home, respectivement :

      cqperl cqtsadmin.pl --username admin --password secret --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --restore_was_profiles D:\FTSBackupWASProfiles --fts_was_profile_home D:\FTS.wasprofiles


Feedback