Préservation de la configuration de CM Server

Il est nécessaire de préserver la configuration MBean du serveur de gestion des changements (CM Server) avant d'effectuer la personnalisation des attributs MBean, la mise à niveau ou la réinstallation de ClearQuest 7.1.x.y, ou 8.0.x.y. Si vous ne préservez pas la configuration, votre personnalisation sera perdue.

Pourquoi et quand exécuter cette tâche

Si votre système ClearCase et ClearQuest 7.1.0.x, ou 8.0.x.y, comprend les modules de prise en charge de réseau étendu, les composants CM Server sont également installés. Pour déterminer si les modules de prise en charge de réseau étendu sont installés, vérifiez si le sous-répertoire CM se trouve dans le répertoire commun Rational :
  • Sous Windows : %RATIONAL_INSTALL%\%RATIONAL_COMMON%\
  • Sur les systèmes UNIX et Linux : $RATIONAL_INSTALL/$RATIONAL_COMMON/
où les variables possèdent la signification suivante :
  • RATIONAL_INSTALL : Répertoire d'installation du logiciel Rational
  • RATIONAL_COMMON : Répertoire commun Rational
Remarque : Avant d'effectuer la mise à niveau ou la réinstallation de ClearQuest 7.1.x.y, vous devez préserver la configuration MBean de CM Server, car le programme d'installation ne le fait pas. Si cette tâche n'est pas exécutée avant une mise à niveau ou une réinstallation, toute personnalisation est perdue.

Il est également judicieux d'exporter la configuration MBean avant de modifier les attributs MBean de CM Server, à l'aide des scripts wsadmin associés aux composants installés de CM Server. Cela vous permet de restaurer les valeurs MBean selon une configuration opérationnelle, si les nouveaux paramètres produisent des résultats non souhaités.

Vous devez lancer les scripts wsadmin pendant l'exécution des composants CM Server, notamment WebSphere Application Server. Notez que vous pouvez automatiser la procédure de sauvegarde périodique de la configuration MBean de CM Server en créant un travail AT sous Windows ou un travail cron sur les systèmes UNIX ou Linux.

L'emplacement par défaut des scripts utilitaires wsadmin de CM Server est le suivant :
  • Sous Windows : C:\Program Files\IBM\RationalSDLC\common\CM\scripts
  • Sur les systèmes UNIX et Linux : /opt/rational/common/CM/scripts
Remarque : Si seulement ClearCase ou seulement ClearQuest est installé, vous devez suivre les instructions de la section suivante, "Procédure de préservation manuelle des paramètres de configuration MBean", plutôt que les instructions de cette section.

Procédure

Procédure d'exportation et d'importation des paramètres de configuration MBean

  1. Dans une fenêtre d'invite de commande, définissez le répertoire par défaut sur l'emplacement des scripts utilitaires wsadmin de CM Server. Par exemple :
    • Sous Windows : # cd "C:\Program Files\IBM\RationalSDLC\common\CM\scripts"
    • Sur les systèmes UNIX et Linux : # cd /opt/rational/common/CM/scripts
  2. Définissez le chemin d'accès à l'utilitaire wsadmin en utilisant la syntaxe appropriée à votre interpréteur de commandes. Par exemple :
    • Sous Windows : # set WAS_BIN="C:\Program Files\IBM\RationalSDLC\common\eWAS\bin"
    • Sur les systèmes UNIX et Linux : # WAS_BIN=/opt/rational/common/eWAS/bin
  3. Démarrez l'utilitaire wsadmin en spécifiant le nom de profil de CM Server. La valeur par défaut est cmprofile. Par exemple :
    • Sous Windows : # %WAS_BIN%\wsadmin -profileName cmprofile
    • Sur les systèmes UNIX et Linux : # $WAS_BIN/wsadmin.sh -profileName cmprofile
  4. Chargez les scripts JACL, qui incluent les commandes exportToFile et importFile, dans votre interpréteur de commandes wsadmin : wsadmin> source teamAdminUtils.jacl
  5. Exportez la configuration MBean vers un fichier extérieur à la structure du répertoire d'installation de CM Server.
    Remarque : Lorsque vous exécutez un script JACL à partir de l'interpréteur de commandes wsadmin sous Windows, vous pouvez utiliser des barres obliques '/' dans une spécification de chemin d'accès que vous transmettez au script. Si vous optez plutôt pour des barres obliques inversées '\', vous devez faire suivre chaque barre oblique par une autre barre oblique. Par exemple :
    • Sous Windows : wsadmin> exportToFile C:/temp/CmServer_backups/MBean.bck
    • Sur les systèmes UNIX et Linux : wsadmin> exportToFile /tmp/CmServer_backups/MBean.bck
    Vous pouvez utiliser la commande importFile pour restaurer une configuration MBean sauvegardée. Vous pouvez utiliser cette commande après une mise à niveau ou une réinstallation des composants CM Server, ou après avoir apporté des modifications à la configuration MBean, et si vous souhaitez récupérer une configuration précédente.

Procédure de préservation manuelle des paramètres de configuration MBean

Si seulement ClearCase ou seulement ClearQuest est installé, vous devez suivre les instructions de cette section. Sinon, si ClearCase et ClearQuest sont installés tous les deux, utilisez les instructions de la section précédente, "Procédure d'exportation et d'importation des paramètres de configuration MBean."

  1. Dans une fenêtre d'invite de commande, définissez le répertoire par défaut sur l'emplacement suivant, en remplaçant les variables suivantes selon vos besoins :
    • Remplacez cmprofile si le nom de profil par défaut n'est pas utilisé
    • Remplacez <computer-name>CMProfileNode01Cell, dfltCell,<computer-name>CMProfileNode01, ou dfltNode par le nom de la cible et le nom de poste
    Par exemple :
    • Sous Windows : # cd "C:\Program Files\IBM\RationalSDLC\common\CM\profiles\cmprofile\config\cells\ <computer-name>CMProfileNode01Cell\nodes\<computer-name>CMProfileNode01\servers\server1\stp"
    • Sur les systèmes UNIX et Linux : # cd /opt/rational/common/CM/profiles/cmprofile/config/ cells/dfltCell/nodes/dfltNode/servers/server1/stp
  2. Copiez tous les fichiers .dat du répertoire par défaut dans un répertoire temporaire extérieur à la structure du répertoire d'installation de CM Server. Par exemple :
    • Sous Windows : # copy *.dat C:\temp\CmServer_mbean_config_files
    • Sur les systèmes UNIX et Linux : # cp *.dat /tmp/CmServer_mbean_config_files
  3. Après la mise à niveau de ClearCase et ClearQuest, assurez-vous que les composants CM Server ne sont pas en cours d'exécution. Suivez les instructions de la rubrique Démarrage, arrêt et redémarrage de CM Server pour arrêter les composants de CM Server.
  4. Ouvrez une fenêtre d'invite de commande. En vous connectant en tant que superutilisateur, définissez le répertoire par défaut sur l'emplacement décrit à l'étape 6. Ensuite, copiez les fichiers sauvegardés .dat du répertoire temporaire utilisé à l'étape 7, vers le répertoire par défaut. Par exemple :
    • Sous Windows : # copy C:\temp\CmServer_mbean_config_files\*.dat
    • Sur les systèmes UNIX et Linux : # cp /tmp/CmServer_mbean_config_files/*.dat
    Après le démarrage des composants CM Server, les données des fichiers restaurés .dat sont utilisées pour initialiser les attributs MBean.


Feedback