Description du fichier de mappage utilisé dans le cadre du renommage de serveur

Cette rubrique décrit la structure du fichier de mappage généré par la commande generateURLMappings et fournit les instructions qui permettent de modifier ce fichier pour votre déploiement.

Lorsque vous êtes prêt à générer un fichier de mappage, suivez les instructions figurant dans la rubrique Préparation du fichier de mappage. Pour plus d'informations, voir les rubriques Topologies et fichiers de mappage pour la configuration d'un environnement de transfert de test et Topologies et fichiers de mappage pour le scénario pilote-à-production.

Le fichier de mappage contient des paires d'URL source-cible pour Jazz Team Server, ses applications CLM enregistrées et d'autres URL fournies par les applications. Les URL se déclinent en deux types :

Les paires d'URL faisant partie du renommage incluent tous les éléments situés sous le domaine de Jazz Team Server. Elles intègrent l'adresse URL publique de Jazz Team Server, les URL publiques des applications et d'autres URL fournies par des applications.

Les URL concernées incluent tous les autres systèmes qui interagissent avec cette topologie mais qui ne se trouvent pas sous le domaine de ce Jazz Team Server. Une application CLM qui est enregistrée sur un autre Jazz Team Server mais qui a des amis avec ce Jazz Team Server représente une adresse URL concernée. Une intégration externe, telle Rational ClearQuest, représente également une adresse URL concernée.

Description d'un exemple de fichier de mappage

# JTS
source=https://clmhost.exemple.org:9443/jts
target=https://clmhost2.exemple.org:9443/jts
#Adresses URL supplémentaires incluses dans le renommage par clmhost.exemple.org:9443/jts
# ADMIN
source=https://clmhost.exemple.org:9443/admin
target=https://clmhost2.exemple.org:9443/admin
#(URL de l'aide CLM)
source=https://clmhost.exemple.org:9443/clmhelp
target=https://clmhost2.exemple.org:9443/clmhelp
# CCM
source=https://clmhost.exemple.org:9443/ccm
target=https://clmhost2.exemple.org:9443/ccm
# RM
source=https://clmhost.exemple.org:9443/rm
target=https://clmhost2.exemple.org:9443/rm
# Adresses URL supplémentaires incluses dans le renommage par Gestion des exigences (RM)
source=https://clmhost.exemple.org:9443/converter/htmlgen
target=https://clmhost2.exemple.org:9443/converter/htmlgen
# QM
source=https://clmhost.exemple.org:9443/qm
target=https://clmhost2.exemple.org:9443/qm

#La liste suivante d'URL représente les serveurs externes qui sont intégrés à ce serveur Jazz Team Server ou à des applications enregistrées auprès de lui.
# https://friend1.exemple.org:9443/jts/rootservices (entrée Amis)
# https://cqconnector.exemple.org:9084/cqconnector/gateway

Le fichier de mappage généré est un canevas qui doit être édité avant l'exécution de la commande importURLMappings. Il est important de comprendre tous les éléments du fichier de mappage afin d'avoir la certitude que l'ensemble des systèmes de votre topologie soient renommés correctement. La section supérieure du fichier contient les paires d'URL faisant partie du renommage. Dans cet exemple, vous voyez les paires d'URL pour l'URL publique de Jazz Team Server et de l'ensemble de ses applications enregistrées. Vous voyez également les paires d'URL fournies par les applications, telles que la paire d'URL de l'aide CLM fournie par Jazz Team Server ainsi que la paire d'URL du convertisseur fournie par l'application Gestion des exigences (RM).

Examinez chacune de ces URL et déterminez celles qui sont modifiées. Mettez à jour les cibles pour toutes les URL source qui seront renommées avec leurs nouvelles valeurs. Si une adresse URL source donnée n'est pas renommée, commentez la paire en insérant le signe dièse (#).

# JTS
#source=https://clmhost.exemple.org:9443/jts
#target=https://clmhost2.exemple.org:9443/jts

La section inférieure du fichier de mappage contient une liste des URL concernées qui sont commentées. Ces URL ne font pas partie de ce renommage mais elles sont concernées par les URL modifiées. Vous devez laisser ces URL mises en commentaire car elles sont là pour référence uniquement. Vous devrez également vérifier que ces URL font partie d'un scénario pris en charge. Pour cela, consultez la documentation relative au renommage de serveur pour votre topologie.

Si vous évoluez dans un environnement de transfert, vous devez toujours masquer les URL concernées pour qu'il n'y ait pas d'interférence entre les serveurs de transfert et les serveurs de production. (Voir ci-dessous pour plus de détails.)

Mappages factices pour vos environnements de transfert

Lorsque vous configurez un environnement de transfert, vous devez impérativement créer des mappages factices pour toutes les URL concernées dans le fichier de mappage. Les URL concernées peuvent inclure d'autres applications CLM qui sont des amies de ce déploiement ou de serveurs externes. Pour les entrées d'amis, crées un mappage factice pour l'URL publique de l'ami.

Par exemple, si l'adresse URL de l'entrée d'ami est https://friendhost.exemple.org:9443/jts/rootservices, l'URL publique est généralement : https://friendhost.exemple.org:9443/jts. Ajoutez une paire d'URL en bas de votre fichier de mappage pour masquer cette adresse URL en affectant à la cible un nom d'hôte factice. Vérifiez que le nom d'hôte cible factice n'est pas accessible en le sélectionnant.

# Ami
source=https://friendhost.exemple.org:9443/jts
target=https://dummyfriendhost.exemple.org:9443/jts

Il n'est pas permis d'utiliser la même cible plusieurs fois. Si vous disposez de plusieurs entrées d'amis, utilisez dummyhost2, dummyhost3, et ainsi de suite. Si vous disposez d'un déploiement à serveur unique dans lequel Jazz Team Server et les applications résident tous sur le même hôte et le même port, vous pouvez utiliser un mappage simplifié, tel que décrit ci-dessous.

Concernant les URL concernées qui ne sont pas des entrées d'amis, ajoutez la paire d'URL suivante en bas de votre fichier de mappage :

source=https://externalserver.exemple.org:9555/
target=https://dummyhost.exemple.org:9555/

Utilisation d'un fichier de mappage simplifié

Si vous disposez d'une topologie simple dans laquelle le protocole, l'hôte, le domaine et le port sont communs à l'ensemble des URL, le fichier de mappage peut être réduit afin de ne contenir qu'une seule entrée source-cible. Par exemple, si vous disposez d'un déploiement tout en un à l'adresse clmhost.exemple.org et que vous voulez tout renommer pour utiliser newhost.exemple.org, vous pouvez modifier le fichier de mappage généré pour n'inclure que les URL suivantes :

Remarque : Le mappage simplifié de clmhost.exemple.org sur newhost.exemple.org ne renomme que Jazz Team Server et les applications CLM. Il ne renomme pas les autres intégrations Rational ou tierce. Vous devez toujours exécuter generateURLMappings pour déterminer si votre scénario est pris en charge et pour vérifier que tous les éléments de votre topologie sont mappés correctement.
source=https://clmhost.exemple.org:9443
target=https://newhost.exemple.org:9443

Adresses URL utilisant des ports par défaut

Si l'une des URL source utilise le port par défaut et le numéro de ce port n'est pas indiqué de façon explicite, deux ensembles de mappages sont nécessaires : l'un avec le port par défaut et l'autre sans le port par défaut. La commande generateURLMappings génère automatiquement les mappages supplémentaires pour vous. Les ports par défaut sont 443 pour https et 80 pour http.

Par exemple, supposons que vous disposez d'un CCM existant qui s'exécute à l'adresse https://clmhost.exemple.org/ccm. Dans ce cas, CCM a été déployé sur un serveur avec le port par défaut (soit par le biais de la configuration du port du serveur d'applications, soit par le biais d'un serveur httip proxy inversé exécuté sur le port par défaut). Au sein de CLM, il est possible que des liens aient également été stockés pour des URL vers des ressources pour lesquelles le port est explicitement inclus dans l'URL. Par exemple :

https://clmhost.exemple.org:443/resource/...

Comme il existe une possibilité que les URL soient stockées sous les deux formes, un mappage est requis pour chacune d'elles. Supposons, par exemple, que clmhost.exemple.org soit renommé en newhost.exemple.org. Dans ce cas, les mappages suivants seraient nécessaires pour effectuer un renommage. Les paires sont générées automatiquement à l'aide de la commande generateURLMappings.

source=https://clmhost.exemple.org/ccm
target=https://newhost.exemple.org/ccm

source=https://clmhost.exemple.org:443/ccm
target=https://newhost.exemple.org:443/ccm

Respect de la casse

Les applications CLM différencient les majuscules des minuscules dans les URL. L'URL https://clmhost:443/jts est différente de https://CLMHOST:443/jts. Vérifiez que la casse est préservée dans les URL source, faute de quoi elles ne seront pas mappées.

Si vous le souhaitez, vous pouvez modifier la casse dans les URL cible. Par exemple, le mappage suivant est autorisé :

source=https://CLMHOST:443/jts
target=https://clmhost:443/jts

Si vous utilisez un fichier de mappage simplifié, vérifiez que l'ensemble de vos URL ont la même casse. Si vous disposez des URL source suivantes :

https://clmhost:443/jts
https://CLMHOST:443/ccm

et que vous utilisez le mappage simplifié :

source=https://clmhost:443
target=https://clmhost:9443

Seule la première URL sera mappée. La seconde URL ne le sera pas. Pour corriger cette anomalie, ajoutez un autre mappage pour :

source=https://CLMHOST:443
target=https://CLMHOST:9443

Erreurs lors de la génération du fichier de mappage

Compte tenu du volume de traitement important impliqué par cette génération, des erreurs risquent de se produire. Certaines d'entre elles sont clairement identifiées. Par exemple, si vous tentez de générer le fichier de mappage avant de démarrer le serveur ou si vous utilisez des données d'identification de connexion erronées. D'autres erreurs sont moins évidentes. Pour plus d'informations sur les erreurs de renommage de serveur, voir Traitement des incidents liés au renommage de serveur.

Renommage de serveur sous z/OS

Le renommage de votre serveur est pris en charge sous z/OS et le processus est le même z/OS que sur d'autres systèmes d'exploitation, sauf que vous n'utilisez pas la commande repotools -generateURLMappings. A la place, personnalisez le membre JCL exemple BLZGENMP dans hlq.SBLZSAMP, où hlq est le qualificatif de haut niveau indiqué au cours de l'installation SMP/E. Voir l'en-tête de commentaire dans BLZGENMP pour des instructions de personnalisation détaillées.

Vous pouvez préparer le fichier de mappage pour z/OS en utilisant la même procédure que pour d'autres systèmes d'exploitation, mais le fichier de mappage est codé en UTF-8. Vous pouvez utiliser l'une des techniques suivantes pour éditer les fichiers UTF-8 sous z/OS UNIX :
  • Si vous utilisez z/OS 1.10 (ou version ultérieure) ou z/OS 1.9 avec la modification provisoire du logiciel (PTF) pour le correctif APAR OA22250, utilisez l'option ISPF 3.17 pour éditer les fichiers UTF-8 sous USS (z/OS UNIX System Services).
  • Si vous utilisez Rational Developer for System z, utilisez l'explorateur de systèmes distants pour vous connecter et modifier les fichiers.
  • Téléchargez les fichiers sur un poste Windows (ou utilisez FTP), modifiez-les, puis retransférez-les vers le système z/OS.
  • Si vous disposez d'autres outils pour éditer les fichiers UTF-8 sous z/OS UNIX System Services, utilisez-les.

Commentaires