Déplacement d'un déploiement pilote ou en production intégrale en utilisant le changement de nom du serveur

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.

  1. Connectez-vous à la page Administration de Jazz Team Server. Faites pointer votre navigateur Web vers https://nomhôte:port/jts/admin.
  2. Cliquez sur l'onglet Serveur.
  3. Dans le panneau de gauche, dans la section Configuration, cliquez sur Applications enregistrées.
  4. Supprimez Lifecycle Query Engine en tant qu'application enregistrée.
  5. Arrêtez le serveur Lifecycle Query Engine.
  6. 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

  1. 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.

  2. 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.
    1. 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é.
    2. 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.
    3. 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 
    4. 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 
    5. 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.
  3. 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.
    1. 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é.

    2. 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"
    3. 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.

  4. 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.

  5. 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.
  6. 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.

  7. 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é.
    1. 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.

    2. Examinez le fichier de mappage et, si nécessaire, supprimez les paires source-cible que vous ne souhaitez pas appliquer au second serveur.
    3. 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.

Commentaires