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
- Pour permettre le changement de nom d'un serveur, vous devez vous procurer un fichier de clés de fonction appelé ImportURLMappings.activate du service de support logiciel IBM®. Ensuite, vous devez copier ce fichier dans le répertoire server.
Lorsque vous prenez contact avec le support IBM, précisez que vous demandez un fichier de clés de fonction de changement de nom de serveur.
- Pour une étude de cas sur la modification de la racine de contexte, voir https://jazz.net/library/article/1148.
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
- 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. .
- 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.
- 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
- 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.
- 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.
- 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.
- Facultatif : Mettez à jour le nom de toutes les applications dont le
nom a été modifié.
- Connectez-vous à l'interface utilisateur d'administration de
Jazz Team Server
et sélectionnez .
- Cliquez sur Editer et donnez à chaque application
le nom correspondant à sa nouvelle racine de contexte ou tout autre nom de
votre choix.