Cette rubrique explique comment préparer le fichier de mappage que vous utiliserez ultérieurement dans le
changement de nom proprement dit de votre serveur
Jazz Team Server.
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 : Pour activer la fonction de changement de nom d'un serveur, vous devez obtenir un fichier de clés de fonction du service de support logiciel IBM®. Lorsque vous contactez le support IBM, précisez que vous demandez un "fichier de clés de fonction de changement de nom de serveur".
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 adresses URL pour le serveur Jazz Team Server,
les applications Jazz et toutes les autres applications concernées.
Vous pouvez effectuer ces étapes dans un déploiement tout-en-un, où Jazz Team Server et les applications Jazz sont tous installés sur le même ordinateur, ou dans un déploiement réparti, où les applications Jazz 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.
- Après avoir mis à niveau Jazz Team Server (JTS) et toutes les applications Jazz, démarrez Jazz Team Server
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://nomhôte: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.
Dans la négative, enregistrez-les.
- Si vous avez enregistré une ou plusieurs applications à l'étape précédente,
redémarrez 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.
- Windows : repotools-jts.bat
-generateURLMappings toFile=mappings.txt adminUserId=<adminId>
adminPassword=<adminPassword> additionalURLFile=additionalurl.txt
- Linux : ./repotools-jts.sh
-generateURLMappings toFile=mappings.txt adminUserId=<adminId>
adminPassword=<adminPassword> additionalURLFile=additionalurl.txt
La sortie de cette commande est un fichier de mappage listant l'URL publique source existante et l'URL cible par
défaut pour le serveur
Jazz Team Server et
chaque application Jazz
(Rational Engineering Lifecycle
Manager,
Lifecycle
Query Engine,
Jazz
Reporting Service)
enregistrée auprès du serveur
Jazz Team Server.
Elle identifie également les adresses URL source et cible pour le fichier WAR d'aide et tous les systèmes externes concernés connus.
Un second fichier
est également créé. Il contient la liste de toutes les URL susceptibles d'être mappées ou fait référence à des
intégrations tiers susceptibles d'être
prises en compte. Vous pouvez ajouter ces adresses URL au fichier de mappage. Pour les déploiements simples, il n'est pas rare que ce fichier ne contienne pas d'adresses URL supplémentaires. Si vous incluez le paramètre additionalURLFile=additionalurl.txt,
vous pouvez indiquer un autre nom pour ce fichier. Pour plus de détails sur ce paramètre, voir Commande des outils de référentiel pour générer le fichier de mappage de changement de nom de serveur.
Vérifiez que le fichier journal ne contient pas d'erreurs :
JazzInstallDir/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 changement de nom de serveur et peuvent entraîner le non fonctionnement du produit. Pour vous familiariser avec la structure du fichier de mappage, voir Fichier de mappage d'un changement de nom de serveur.
- Vérifiez qu'une paire source-cible existe pour chaque application renommée et pour le fichier WAR d'aide.
- 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 changement de nom, mais
avant que les serveurs ne soient redémarrés. Si vous renommez une racine de contexte du serveur JTS ou de toute application, voir
Modification de la racine de contexte.
- 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 l'une de ces URL concernées nécessite un mappage, supprimez la mise en commentaire de la paire
source/cible de l'URL concernée et indiquez la nouvelle URL
cible. Si vous avez des doutes quant à l'environnement, adressez-vous à un administrateur avant de procéder au changement de nom.
- Examinez le fichier additionalurls.
Pour plus de détails, voir Commande des outils de référentiel pour générer le fichier de mappage de changement de nom de serveur.
Remarque : Si des modifications de configuration sont apportées au déploiement avant que vous ne procédiez au changement de nom effectif, notamment l'enregistrement d'applications supplémentaires, vous devez régénérer le fichier de mappage.
- Utilisez la commande repotools-jts
-verifyURLMappings pour vérifier le fichier de mappage.
- repotools-jts.bat -verifyURLMappings
mappingFile=mappings.txt repositoryURL=<serverURL> adminUserId=<adminId>
adminPassword=<adminPassword>
- ./repotools-jts.sh -verifyURLMappings
mappingFile=mappings.txt repositoryURL=<serverURL> adminUserId=<adminId>
adminPassword=<adminPassword>
Pour plus d'informations sur les types de vérifications effectués par cette
commande, voir Commande des outils de référentiel pour vérifier un fichier de mappage.
- Si votre scénario implique un nouveau matériel, installez
Rational Engineering Lifecycle
Manager
sur les nouveaux ordinateurs. N'exécutez pas l'assistant de configuration Jazz ou ne démarrez pas le serveur Jazz Team Server.