Cette rubrique décrit les étapes permettant de renommer un déploiement pilote de petite taille ou en production intégrale.
Avant de commencer
Etant donné que LQE ne peut pas être migré automatiquement, il doit être supprimé de la liste des
applications enregistrées auprès de
Jazz Team Server
et ce dernier doit être redémarré avant le début du processus de changement de nom de serveur.
- Connectez-vous à la page Administration de Jazz Team Server.
Faites pointer votre navigateur Web vers https://nomhôte:port/jts/admin.
- Cliquez sur l'onglet Serveur.
- Dans le panneau de gauche, dans la section Configuration, cliquez sur Applications enregistrées.
- Supprimez
Lifecycle
Query Engine en tant
qu'application enregistrée.
- Arrêtez le serveur Lifecycle
Query Engine.
- Redémarrez Jazz Team Server.
Remarque : Après le changement de nom, le ou les serveurs source doivent être maintenus hors service pour éviter toute
contamination de l'environnement de production.
Pourquoi et quand exécuter cette tâche
La fonction de
changement de nom du serveur utilise un fichier de mappage en vue d'identifier
les adresses URL à renommer. Une commande repotools est fournie afin de générer pour
vous un fichier de mappage initial. Le fichier de mappage contient des paires source-cible pour
Jazz Team Server
et toutes les applications, ainsi que toutes les autres adresses URL relatives
aux applications.
Voir Fichier de mappage d'un changement de nom de serveur pour plus de détails sur le fichier de mappage.
Procédure
- Préparez et passez en revue le fichier de mappage avant le changement de
nom réel tandis que vos serveurs sont en ligne, en suivant la procédure décrite
dans la rubrique Préparation du fichier de mappage.
La phase préparatoire débouche sur la génération d'un fichier de mappage sur
le serveur Jazz Team Server cible.
Le fichier de mappage contient des paires source-cible pour
Jazz Team Server
et toutes les applications, ainsi que toutes les autres adresses URL relatives
aux applications.
- Sauvegardez l'environnement source existant et copiez les index de texte et les fichiers de configuration d'application dans la nouvelle installation cible. Pour les systèmes distribués, accédez au serveur approprié pour copier les fichiers.
Remarque : Si vous effectuez un changement de nom sur place, mais pas de déplacement vers un nouveau matériel, vous copiez l'environnement depuis une installation vers une deuxième installation sur le même système.
- Arrêtez Jazz Team Server
et toute application répartie enregistrée auprès de ce dernier.
De plus, arrêtez toute autre application concernée par le changement de nom du serveur, ou toute intégration prise en charge concernée.
Remarque : Lorsque le ou les serveurs sont arrêtés, les utilisateurs ne peuvent
pas créer ni suivre les liens provenant de tout système externe intégré au
déploiement Rational Engineering Lifecycle
Manager
sur le point d'être renommé.
- Effectuez une copie de sauvegarde des bases de données de l'environnement source, notamment la base de données
de Jazz Team Server, les bases de données des applications et la base de données d'entrepôt de données.
Si vous modifiez le serveur ou le fournisseur de base de données, voir
Déplacement d'une base de
données pour connaître les étapes supplémentaires à effectuer.
- Copiez les index JFS/texte de l'installation source vers l'installation cible.
Les exemples suivants portant sur un serveur
Linux partent du principe que les unités
des ordinateurs de production cible sont montées en réseau.
Si ce n'est pas possible dans votre environnement, utilisez d'autres méthodes
de transfert de fichier pour vous assurer que les fichiers sont copiés.
cp -R RépInstallJazzSource/server/conf/jts/indices
RépInstallJazzCible/server/conf/jts
cp -R RépInstallJazzSource/server/conf/relm/indices RépInstallJazzCible/server/conf/relm
- Copiez les fichiers de configuration d'application de l'installation source vers l'installation de production cible. Comme pour l'étape précédente, les exemples ci-dessous s'appliquent à un
serveur Linux et partent du principe que
les unités des ordinateurs de production cible sont montées en réseau.
cp RépInstallJazzSource/server/conf/jts/teamserver*.properties RépInstallJazzCible/server/conf/jts
cp RépInstallJazzSource/server/conf/relm/teamserver*.properties RépInstallJazzCible/server/conf/relm
cp RépInstallJazzSource/server/conf/admin/admin.properties* RépInstallJazzCible/server/conf/admin
cp RépInstallJazzSource/server/conf/admin/friends.rdf* RépInstallJazzCible/server/conf/admin
- Copiez le fichier de mappage dans le répertoire
RépInstallJazzCible\server sur le serveur de
production cible. Pour plus d'informations sur le fichier de mappage, voir
Préparation du fichier de mappage.
- Effectuez la partie hors ligne du changement de nom du serveur en
important le fichier de mappage sur le serveur
Jazz Team Server
de production cible à l'aide de la commande repotools-jts -importURLMappings.
- Si vous effectuez un déploiement tout en un, importez le fichier des
mappages à l'aide de la commande repotools-jts
-importURLMappings comme suit :
- repotools-jts.bat -importURLMappings
fromFile=".\mappings.txt"
- ./repotools-jts.sh -importURLMappings
fromFile="./mappings.txt"
Le changement de nom commencera en ligne sur
Jazz Team Server
avant qu'il soit redémarré.
- Si vous avez un déploiement est réparti et êtes autorisé à mapper des
unités réseau, mappez une unité réseau depuis l'hôte
Jazz Team Server
vers chacun des hôtes d'applications. Créez ensuite un fichier (par exemple, serverConfFile.txt)
contenant une liste des répertoires server/conf
distants dans votre déploiement, au format suivant :
# Remote CCM server
x:/JazzTeamServer/server/conf
# Remote QM server
y:/JazzTeamServer/server/conf
# Remote RM server
z:/JazzTeamServer/server/conf
Enfin, poursuivez avec la commande repotools-jts
-importURLMappings et ajoutez le paramètre
serverConfFile= comme indiqué ci-dessous.
- repotools-jts.bat -importURLMappings
fromFile=".\mappings.txt" serverConfFile=".\serverConf.txt"
- ./repotools-jts.sh -importURLMappings
fromFile="./mappings.txt" serverConfFile="./serverConf.txt"
- Si vous avez un déploiement réparti et n'êtes pas autorisé à
remapper des unités réseau, poursuivez avec la commande repotools-jts
-importURLMappings (sans le paramètre serverConfFile=).
Copiez ensuite le fichier server/conf/jts/.mappingEvent
dans les répertoires de configuration des applications distantes
server/conf/nom_application), à savoir,
ccm, qm et rm.
Le fichier d'événements est généré lorsque vous importez les mappages. Vous
devez copier le fichier .mappingEvent après avoir
importé le fichier de mappage mais avant de démarrer le serveur.
Le fichier .mappingEvent contient les informations dont
les applications ont besoin pour contacter
Jazz Team Server
à son nouvel emplacement. Le contenu du fichier
.mappingEvent file contents est identique pour un serveur
Jazz Team Server
particulier et ses applications enregistrées.
Vérifiez que le changement de nom a réussi en vérifiant la sortie de la
console et le fichier RépInstallJazz/server/repotools-jts_importURLMappings.log.
Si des erreurs s'affichent ou si vous vous apercevez que vous avez fait une
erreur dans votre fichier de mappage, reportez-vous à la rubrique
Traitement des incidents liés au changement de nom de serveur pour identifier et corriger
le problème.
- Démarrez Jazz Team Server
et toute application répartie installée.
A ce stade, les applications sont synchronisées avec le serveur Jazz Team Server pour appliquer les mappages d'URL et mettre à jour leurs données d'entrepôt. Cette
opération peut prendre de 5 minutes pour un jeu de données réduit à 30 minutes
ou plus pour un jeu de données très volumineux.
- Connectez-vous à Jazz Team Server à l'adresse https://nouvel hôte:port/jts/serverRenameStatus.
Cette opération lance le processus de changement de nom de serveur proprement dit. Une fois le changement de nom terminé, vous pouvez le vérifier et exécuter toute action corrective nécessaire. Au cours du processus de vérification, Jazz Team Server et toutes les applications sont placés en mode lecture seule, mais vous pouvez tout de même accéder aux données et rechercher les liaisons rompues et les adresses URL non mappées.
Pour plus de détails, voir Vérification des adresses URL et des liens après un changement de nom de serveur.
- Avant de terminer le processus de vérification, veillez à procéder aux vérifications spécifiques des produits supplémentaires décrites dans Achèvement du processus de vérification de changement de nom du serveur. Une fois persuadé que les données sont correctes, cliquez sur la case à cocher J'ai vérifié le changement de nom du serveur ..., puis sur Terminer.
A ce stade, le serveur Jazz Team Server et toutes les applications enregistrées ne sont plus en mode lecture seule et l'utilisation normale du produit peut reprendre.
- Production intégrale uniquement : si vous disposez d'un deuxième serveur Jazz Team Server ou d'applications supplémentaires qui sont liées au serveur Jazz Team Server renommé, vous devez exécuter repotools-jts -importURLMappings sur le deuxième serveur Jazz Team Server.
Cette étape est nécessaire pour mettre à jour les liens à partir du deuxième serveur vers le serveur renommé.
Important : Ne générez pas de nouveau fichier de mappage. Vous devez utiliser le même fichier de mappage que vous avez utilisé pour le premier serveur renommé.
- Copiez le fichier de mappage modifié du premier serveur vers le second serveur.
Veillez à inclure les mappages correctifs qui ont été appliqués à partir du processus de vérification.
- Examinez le fichier de mappage et, si nécessaire, supprimez les paires source-cible que vous ne souhaitez pas appliquer au second serveur.
- Effectuez le changement de nom sur le second serveur en répétant les étapes 3 à 6 sur le second serveur Jazz Team Server.
Que faire ensuite
Une fois les étapes de cette tâche effectuées, exécutez les étapes de la rubrique
Achèvement du changement de nom du serveur pour Lifecycle Query Engine afin d'ajouter à nouveau LQE et de régénérer l'index.