Préparation du fichier de mappage

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.

Procédure

  1. 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.
    1. Connectez-vous à la page Administration de Jazz Team Server. Faites pointer votre navigateur Web vers https://nomhôte: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. Dans la négative, enregistrez-les.
    5. Si vous avez enregistré une ou plusieurs applications à l'étape précédente, redémarrez 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.
    • 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.

  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 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.
    1. Vérifiez qu'une paire source-cible existe pour chaque application renommée et pour le fichier WAR d'aide.
    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 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.
    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 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.
    5. 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.
  5. 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.

  6. 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.

Que faire ensuite

Procédez au changement de nom du serveur. Pour plus de détails, voir Déplacement d'un déploiement pilote ou en production intégrale en utilisant le changement de nom du serveur.

Commentaires