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.
Le fichier de mappage contient des paires d'adresses URL source-cible pour Jazz Team Server, ses applications enregistrées et d'autres adresses 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 Rational Engineering Lifecycle Manager qui est enregistrée sur un autre serveur Jazz Team Server mais qui est amie avec ce serveur 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.
# JTS
source=https://relmhost.example.org:9443/jts
target=https://relmhost2.example.org:9443/jts
#URL supplémentaires incluses dans le changement de nom par relmhost.example.org:9443/jts
# ADMIN
source=https://relmhost.example.org:9443/admin
target=https://relmhost2.example.org:9443/admin
#(URL de l'aide relm)
source=https://relmhost.example.org:9443/relmhelp
target=https://relmhost2.example.org:9443/relmhelp
# RELM
source=https://relmhost.example.org:9443/relm
target=https://relmhost2.example.org:9443/relm
# Jazz Reporting Service
source=https://relmhost.example.org:9443/sparql
target=https://relmhost2.example.org:9443/sparql
#La liste d'URL suivante représente les serveurs externes qui sont intégrés
avec ce serveur Jazz Team Server ou des applications enregistrées auprès de lui.
#Ne supprimez pas la mise en commentaire de ces lignes car elles sont uniquement utilisées comme référence.
# Entrée amie
#source=https://friend1.example.org:9443/jts/rootservices
#target=https://friend1.example.org:9443/jts/rootservices
#source=https://cqconnector.example.org:9084/cqconnector/gateway
#target=https://cqconnector.example.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 changement de nom. Dans cet exemple, vous voyez les paires d'adresses URL pour l'adresse URL publique de Jazz Team Server et de l'ensemble de ses applications enregistrées. Vous voyez également les paires d'adresses URL fournies par des applications.
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://relmhost.example.org:9443/jts
#target=https://relmhost2.example.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 changement de nom mais elles sont concernées par les URL modifiées. A moins qu'il soit nécessaire de masquer les URL de production, vous devez laisser ces URL mises en commentaire car elles sont là pour référence uniquement.
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.)
Si vous devez masquer une adresse URL affectée, vous devez annuler la mise en commentaire de la paire source/cible et fournir une cible factice.
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 adresses URL concernées peuvent inclure d'autres applications relm 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.example.org:9443/jts/rootservices, l'URL publique est généralement : https://friendhost.example.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.example.org:9443/jts
target=https://dummyfriendhost.example.org:9443/jts
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/
Il n'est pas permis d'utiliser la même cible plusieurs fois. Si vous avez plusieurs entrées d'amis, utilisez dummyhost2, dummyhost3 et ainsi de suite. Si vous avez 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.
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 relmhost.example.org et que vous voulez tout renommer pour utiliser newhost.example.org, vous pouvez modifier le fichier de mappage généré pour n'inclure que les adresses URL suivantes :
source=https://relmhost.example.org:9443
target=https://newhost.example.org:9443
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, Rational Engineering Lifecycle Manager est exécuté sur https://relmhost.example.org/relm. Dans ce cas, Rational Engineering Lifecycle Manager 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 http proxy inversé exécuté sur le port par défaut). Dans Rational Engineering Lifecycle Manager, il est possible que des liens aient également été stockés pour des adresses URL vers des ressources pour lesquelles le port est explicitement inclus dans l'adresse URL. Exemple :
https://relmhost.example.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. Par exemple, supposons que relmhost.example.org est renommé en newhost.example.org. Dans ce cas, les mappages suivants seraient nécessaires pour effectuer un changement de nom. Les paires sont générées automatiquement à l'aide de la commande generateURLMappings.
source=https://relmhost.example.org/relm
target=https://newhost.example.org/relm
source=https://relmhost.example.org:443/relm
target=https://newhost.example.org:443/relm
Il est recommandé de spécifier les adresses URL en minuscules. Les adresses URL sont sensibles à la casse.
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 changement de nom de serveur, voir Traitement des incidents liés au changement de nom de serveur.
Après avoir généré et édité le fichier de mappage, veillez à exécuter la commande repotools-jts -verifyURLMappings pour rechercher les mappages manquants et effectuer plusieurs autres vérifications. Dans certains cas, vous pouvez ignorer les mappages manquants détectés s'il n'est pas nécessaire de mapper l'adresse URL. Pour plus de détails, voir Commande des outils de référentiel pour vérifier un fichier de mappage.