Préparation du fichier de mappage

Cette rubrique explique comment préparer le fichier de mappage que vous utiliserez ultérieurement dans le renommage effectif de votre serveur (ou vos serveurs) CLM. Vous pouvez préparer et examiner le fichier de mappage avant le renommage effectif, tandis que vos serveurs sont toujours en ligne.

Avant de commencer

Important : La possibilité de renommer un serveur est une fonction de CLM version 4. Par conséquent, avant de pouvoir effectuer un renommage de serveur, vous devez effectuer la mise à niveau de votre serveur Jazz Team Server et de toutes les applications CLM vers la version 4.

Pourquoi et quand exécuter cette tâche

Vous devez exécuter plusieurs étapes avant de pouvoir effectivement renommer le serveur. Elles consistent essentiellement en la préparation et l'examen du fichier de mappage que vous utiliserez pour exécuter l'opération de renommage. Le fichier de mappage répertorie les URL sources existantes et les URL cibles renommées de votre déploiement. Il s'agit notamment des URL pour le serveur Jazz Team Server, les applications CLM, le fichier WAR d'aide CLM et toutes les autres applications concernées. Pour obtenir des exemples de diagramme de topologie et de fichier de mappage, voir Topologies et fichiers de mappage pour la configuration d'un environnement de transfert de test.

Vous pouvez effectuer ces étapes dans un déploiement CLM tout-en-un, où Jazz Team Server et les applications CLM sont tous installés sur le même ordinateur, ou dans un déploiement distribué, où les applications CLM sont installées sur des ordinateurs différents. Ces étapes préparatoires peuvent être utilisées avec différents scénarios, par exemple, lorsqu'un ordinateur est déplacé vers un nouvel emplacement physique, lors de la configuration d'un bac à sable test sur un nouvel ordinateur, ou dans le cas de la consolidation d'un centre de données impliquant un environnement renommé sur de nouveaux ordinateurs.

For z/OS operating system Remarque : Le renommage d'un serveur est pris en charge sous z/OS, mais le processus de création d'un fichier de mappage présente plusieurs différences. Pour plus de détails, voir Renommage d'un serveur sous z/OS.

Procédure

  1. Après avoir mis à niveau tous les serveur impliqués dans le renommage vers la version 4, démarrez le serveur Jazz Team Server (JTS) et vérifiez que les applications ont été enregistrées correctement auprès du serveur.
    1. Connectez-vous à la page Administration de Jazz Team Server. Faites pointer votre navigateur Web vers https://hostname: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. Vérifiez que toutes vos applications sont enregistrées.

    Pour plus de détails, voir Enregistrement d'applications avec Jazz Team Server.

  2. Ouvrez une invite de commande sur l'ordinateur où le serveur Jazz Team Server est installé et accédez au répertoire RépInstallJazz\server.
    Remarque : Veillez à effectuer cette étape et les suivantes sur le serveur Jazz Team Server d'origine, même si vous allez effectuer un déplacement vers un nouveau matériel.
  3. Utilisez la commande repotools-jts -generateURLMappings pour générer un fichier de mappage initial à utiliser comme canevas qui pourra être édité, comme illustré ci-dessous. Si vous avez déjà exécuté la commande, ou si le fichier existe déjà, ajoutez le paramètre overwrite=true.
    Remarque : Tous les exemples fournis pour UNIX sont également valides pour Linux.
    • For Windows operating system repotools-jts.bat -generateURLMappings toFile=mappings.txt adminUserId=<adminId> adminPassword=<adminPassword>
    • For Unix operating systems ./repotools-jts.sh -generateURLMappings toFile=mappings.txt adminUserId=<adminId> adminPassword=<adminPassword>

    La sortie de cette commande est un fichier de mappage qui répertorie l'adresse URL publique source existante et une adresse URL cible par défaut pour le serveur Jazz Team Server et chaque application CLM (CCM, QM et RM) qui est enregistrée auprès du serveur Jazz Team Server. Elle identifie également les adresses URL sources et cibles pour le fichier WAR d'aide CLM et tous les systèmes externes concernés connus.

    Vérifiez que le fichier journal ne contient pas d'erreurs : RépInstallJazz/server/repotools-jts_generateURLMappings.log.

  4. Vérifiez et éditez soigneusement le fichier de mappage généré. Vérifiez les erreurs d'orthographe dans le nom d'hôte, le port ou les contextes racine. Certaines de ces erreurs d'orthographe ne peuvent pas être détectées par les outils de renommage de serveur et peuvent entraîner le non fonctionnement du produit.

    Familiarisez-vous avec la structure du fichier de mappage en consultant la rubrique Description du fichier de mappage utilisé dans le cadre du renommage de serveur. Vérifiez et éditez soigneusement le fichier de mappage généré.

    1. Vérifiez qu'une paire source-cible existe pour chaque application renommée et pour le fichier WAR d'aide CLM.
    2. Editez les éléments target= URL pour que les entrées que vous souhaitez renommer correspondent à des cibles correctes.
      Remarque : Si vous renommez un numéro de port du serveur JTS ou de toute application, vous devrez mettre à jour les informations du port dans le serveur d'applications après le renommage, mais avant que les serveurs ne soient redémarrés. Pour plus de détails, voir Modification des numéros de port pour le serveur d'applications. Si vous renommez une racine de contexte du serveur JTS ou de toute application, voir Modification de la racine de contexte.
    3. A l'aide d'un caractère '#', mettez en commentaire la paire source-> cible de toute adresse URL que vous ne souhaitez pas renommer.
    4. Examinez la liste des URL concernées. Bien que la commande recherche toutes les URL connues dans le déploiement, il est possible que certaines URL ne soit pas trouvées. Si vous avez des doutes quant à l'environnement, adressez-vous à un administrateur avant de procéder au renommage.
    Remarque : Si des modifications de configuration sont apportées au déploiement CLM avant que vous ne procédiez au renommage effectif, vous devrez régénérer le fichier de mappage.
  5. Si votre scénario implique un nouveau matériel, installez la version 4 de CLM sur les nouveaux ordinateurs. N'exécutez pas l'assistant de configuration Jazz ou ne démarrez pas le serveur Jazz Team Server. Voir Installation de Jazz Team Server et des applications de la solution Rational pour Collaborative Lifecycle Management.

Que faire ensuite

Procédez au renommage du serveur. Pour plus de détails, voir Déplacement d'un déploiement pilote vers un serveur de production à l'aide d'un changement de nom de serveur ou Configuration d'un environnement de transfert de test avec des données de production

Commentaires