Modification de la racine de contexte

Cette rubrique fournit les instructions relatives à la modification de la racine de contexte lorsque le nom d'un serveur est modifié.

Pourquoi et quand exécuter cette tâche

Bien qu'il soit plus courant de changer le nom d'hôte lors de la modification d'un nom de serveur, il est également possible de modifier la racine de contexte. Ceci requiert l'installation d'un nouveau serveur miroir de l'installation ancienne mais avec les nouvelles racines de contexte. Veillez à générer un fichier de mappage pour le serveur d'origine, suivant la procédure détaillée dans la section Préparation du fichier de mappage. Modifiez les racines de contexte appropriées dans ce fichier de mappage.

Procédure

  1. Utilisez Installation Manager pour installer un serveur Jazz Team Server version 4 séparé. Lorsque le panneau Options de racine de contexte s'ouvre, cliquez sur Sélectionnez les valeurs de racine de contexte et entrez vos valeurs de racine de contexte personnalisées. Même si vous modifiez le nom de la racine de contexte pour une application unique vous devez installer toutes les applications que vous projetez d'exécuter. Pour obtenir des instructions d'installation plus détaillées, voir Installation à l'aide d'IBM Installation Manager.
  2. Copiez les fichiers de configuration de l'installation antérieure server/conf/oldContextRoot vers la nouvelle installation server/conf/newContextRoot. Copiez tous ces fichiers d'application, même si vous modifiez la racine de contexte d'une application particulière.
    Remarque : Si vous avez modifié les racines de contexte dans l'installation antérieure, remplacez les exemples par défaut ci-dessous par vos propres versions personnalisées.
    • A partir de server/conf/admin, copiez admin.properties et friends.rdf.
    • A partir de server/conf/jts, copiez : teamserver.properties et le répertoire indices.
    • A partir de server/conf/ccm, copiez teamserver.properties et le répertoire indices.
    • A partir de server/conf/qm, copiez : teamserver.properties et le répertoire indices.
    • A partir de server/conf/rm, copiez fronting.properties et friendsconfig.rdf.
  3. Vérifiez que les propriétés de base de données ci-dessous figurant dans les fichiers teamserver.properties relatives à CCM, QM et JTS pointent sur les emplacements de base de données corrects.
    • com.ibm.team.repository.db.jdbc.location
    • com.ibm.team.datawarehouse.db.jdbc.location

    Enfin, corrigez l'emplacement des index de texte relatifs pour utiliser le nouvel emplacement, comme illustré ci-dessous. La nouvelle racine de contexte doit apparaître dans le chemin.
    com.ibm.team.fulltext.indexLocation=conf/nouvelle_racine_contexte/indices/workitemindex
  4. Si vous utilisez WebSphere Application Server vous devez supprimer les applications de l'installation antérieure et les installer dans la nouvelle installation. Vous devez également mettre à jour la valeur JAZZ_HOME pour qu'elle pointe sur la nouvelle installation. Pour obtenir des informations détaillées sur le déploiement d'applications vers WebSphere Application Server, voir Déploiement d'applications de solution Rational pour Collaborative Lifecycle Management sur un serveur WebSphere Application Server.
  5. Si vous utilisez le registre d'utilisateurs Tomcat, copiez le fichier AncienRépInstallJazz/server/tomcat/conf/tomcat-users.xml dans le répertoire NouvelEmplacementInstallJazz/server/tomcat/conf afin de synchroniser les utilisateurs existants.
  6. Suivez les instructions de changement de nom standard à partir de l'étape importURLMappings. Vous devez exécuter la commande importURLMappings sur la nouvelle installation à l'aide du fichier de mappage généré à partir de l'installation antérieure. Vous n'avez aucune autre étape supplémentaire à effectuer sur l'installation antérieure car elle fait uniquement office d'installation de secours le temps de vous assurer que la nouvelle installation fonctionne correctement.
    Remarque : Il est possible que la racine de contexte de l'installation antérieure apparaisse dans l'interface utilisateur pour l'état de changement de nom du serveur. L'interface utilisateur affiche le nom d'application enregistré. Par défaut, le nom est la racine de contexte. Par conséquent, si vous avez conservé le nom par défaut, c'est la racine de contexte antérieure qui est affichée.
  7. Facultatif : Mettez à jour le nom de toutes les applications dont le nom a été modifié.
    1. Connectez-vous à l'interface utilisateur d'administration de Jazz Team Server et sélectionnez Configuration > Applications enregistrées.
    2. Cliquez sur Editer et donnez à chaque application le nom correspondant à sa nouvelle racine de contexte ou tout autre nom de votre choix.

Commentaires