Modification de la racine de contexte

Au lieu de changer le nom d'hôte lorsque vous renommez un serveur, vous pouvez simplement changer la racine de contexte.

Avant de commencer

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. Pour plus d'informations sur la modification de la racine de contexte, voir Case study: server rename.

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 uniquement le nom de la racine de contexte pour une application unique vous devez installer toutes les applications que vous projetez d'exécuter. .
  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 de configuration, 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 ces exemples par défaut 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/relm, copiez teamserver.properties et le répertoire indices.
    • A partir de server/conf/lqe, copiez teamserver.properties et le répertoire indices.
    • A partir de server/conf/sparql, copiez fronting.properties et le répertoire indices.
  3. Vérifiez que les propriétés de base de données suivantes figurant dans les fichiers teamserver.properties désignent 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. Veillez à inclure la nouvelle racine de contexte dans le chemin.
    com.ibm.team.fulltext.indexLocation=conf/nouvelle_racine_contexte/indices/workitemindex
  4. Si vous utilisez WebSphere Application Server, désinstallez les applications de l'ancienne installation et installez-les dans la nouvelle installation. De plus, mettez à jour JAZZ_HOME de sorte qu'elle pointe vers la nouvelle installation.
  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