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.
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.
- 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.
- Connectez-vous à la page Administration de Jazz Team
Server.
Faites pointer votre navigateur Web vers https://hostname:port/jts/admin.
- Cliquez sur l'onglet Serveur.
- Dans le panneau de gauche, dans la section Configuration, cliquez sur Applications enregistrées.
- Vérifiez que toutes vos applications sont enregistrées.
Pour plus de détails, voir Enregistrement d'applications avec Jazz Team Server.
- 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.
- 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.
repotools-jts.bat -generateURLMappings
toFile=mappings.txt adminUserId=<adminId> adminPassword=<adminPassword>
./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.
- 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é.
- Vérifiez qu'une paire source-cible existe pour chaque application renommée et pour le fichier WAR d'aide CLM.
- Editez les éléments target= URL pour que les entrées que vous souhaitez renommer correspondent à des cibles correctes.
- A l'aide d'un caractère '#', mettez en commentaire la paire
source-> cible de toute adresse URL que vous ne souhaitez pas renommer.
- 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.
- 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.