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
- 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
- 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
- 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
- Chargez les scripts JACL, qui incluent les commandes exportToFile et
importFile, dans votre interpréteur de commandes wsadmin : wsadmin>
source teamAdminUtils.jacl
- 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."
- 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
- 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
- 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.
- 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.