Cette rubrique décrit la procédure à suivre pour modifier les
adresses URL d'un serveur lors du déploiement d'un déploiement CLM
pilote réduit vers un serveur de production.
Avant de commencer
Avant de procéder au changement de nom, vérifiez que votre
environnement répond aux critères requis pour le scénario de passage du pilote
au mode production. Pour plus de détails, voir Scénarios pris en charge.
Important : Pour
changer un nom de serveur
Jazz Team
Server
et toutes les applications CLM doivent être au niveau de version 4 ou ultérieur.
Le
diagramme suivant montre le flux global du changement de nom.

Pourquoi et quand exécuter cette tâche
Dans le cadre de cette procédure vous copiez les
fichiers de données et de configuration des serveurs pilote vers les serveurs
de production.
Les bases de données sont déplacées et non copiées et vous devez par
conséquent maintenir l'environnement pilote hors service pour éviter toute
contamination de l'environnement de production.
La fonction de
changement de nom du serveur utilise un fichier de mappage en vue d'identifier
les adresses URL à renommer. Une commande repotools est fournie afin de générer pour
vous un fichier de mappage initial. Le fichier de mappage contient des paires
source-cible pour le JTS et toutes les applications, ainsi que toutes les
autres adresses URL relatives aux applications. Pour plus d'informations sur le fichier
de mappage, voir Description du fichier de mappage utilisé dans le cadre du renommage de serveur. Vous
trouverez des exemples de diagrammes de topologie et de fichiers de mappage
dans la section Topologies et fichiers de mappage pour le scénario pilote-à-production.
Procédure
- Préparez et passez en revue le fichier de mappage avant le changement de
nom réel tandis que vos serveurs sont en ligne, en suivant la procédure décrite
dans la rubrique Préparation du fichier de mappage.
Après avoir déplacé votre déploiement sur un nouvel ordinateur, effectuez
l'installation sur ce dernier. Si vous modifiez l'adresse URL sur le même
ordinateur, effectuez l'installation dans un répertoire distinct de celui de
l'installation existante. Si vous modifiez également la racine de contexte,
voir Modification de la racine de contexte.
La phase préparatoire débouche sur la génération d'un fichier de mappage sur
le serveur
Jazz Team
Server
pilote.
Le fichier de mappage contient des paires source-cible pour
Jazz Team
Server
et toutes les applications, ainsi que toutes les autres adresses URL relatives
aux applications.
- Sauvegardez l'environnement du pilote version 4 et copiez les index de
texte et les fichiers de configuration d'application dans la nouvelle installation.
- Arrêtez Jazz Team
Server
et toute application CLM répartie enregistrée avec ce dernier.
Arrêtez également toute autre application affectée par le changement de nom
du serveur, par exemple, Jazz Build
Engine, ou toute intégration prise en charge affectée, par exemple, Rational
Reporting for Development Intelligence (RRDI),
Rational
ClearCase ou
Rational
ClearQuest.
Remarque : Lorsque le ou les serveurs sont arrêtés, les utilisateurs ne peuvent
pas créer ni suivre les liens provenant de tout système externe intégré au
déploiement CLM dont le nom va être modifié.
- Sauvegardez les bases de données dans l'environnement pilote CLM 4., à
savoir la base de données
Jazz Team
Server,
les bases de données associée aux applications CCM et QM, la base de données
d'entrepôt de données et la base de donnée Content Store RRDI, si vous utilisez
RRDI.
Si vous modifiez le serveur ou le fournisseur de base de données, voir
Déplacement d'une base de
données CLM pour connaître les étapes supplémentaires à effectuer.
- Copiez les index JFS/text du serveur pilote source vers le serveur de
production cible. (Pour les systèmes répartis, accédez au serveur approprié pour copier les fichiers.)
L'exemple suivant portant sur un serveur
Linux part du principe que les unités
des ordinateurs de production sont montées en réseau.
Si ce n'est pas possible dans votre environnement, utilisez d'autres méthodes
de transfert de fichier pour vous assurer que les fichiers sont copiés.
cp -R RépInstallJazzSource/server/conf/jts/indices
RépInstallJazzCible/server/conf/jts
cp -R RépInstallJazzSource/server/conf/ccm/indices RépInstallJazzCible/server/conf/ccm
cp -R RépInstallJazzSource/server/conf/qm/indices RépInstallJazzCible/server/conf/qm
- Copiez les fichiers de configuration du serveur pilote source vers le
serveur de production cible. (Pour les systèmes répartis, accédez au serveur approprié pour copier les fichiers.) Comme pour l'étape précédente, les exemples ci-dessous s'appliquent à un
serveur Linux et partent du principe que
les unités des ordinateurs de production sont montées en réseau.
cp RépInstallJazzSource/server/conf/jts/teamserver*.properties RépInstallJazzCible/server/conf/jts
cp RépInstallJazzSource/server/conf/ccm/teamserver*.properties RépInstallJazzCible/server/conf/ccm
cp RépInstallJazzSource/server/conf/qm/teamserver*.properties RépInstallJazzCible/server/conf/qm
cp RépInstallJazzSource/server/conf/admin/admin.properties* RépInstallJazzCible/server/conf/admin
cp RépInstallJazzSource/server/conf/admin/friends.rdf* RépInstallJazzCible/server/conf/admin
cp RépInstallJazzSource/server/conf/rm/fronting.properties RépInstallJazzCible/server/conf/rm
cp RépInstallJazzSource/server/conf/rm/friendsconfig.rdf RépInstallJazzCible/server/conf/rm
- Copiez le fichier de mappage dans le répertoire
RépInstallJazzCible\server sur le serveur de
production. Pour plus d'informations sur le fichier de mappage, voir
Préparation du fichier de mappage.
- Effectuez la partie hors ligne du changement de nom du serveur en
important le fichier de mappages sur le serveur
Jazz Team
Server
de production cible à l'aide de la commande repotools-jts -importURLMappings.
- Si vous effectuez un déploiement tout en un, importez le fichier des
mappages à l'aide de la commande repotools-jts
-importURLMappings comme suit :
repotools-jts.bat -importURLMappings
fromFile=".\mappings.txt"
./repotools-jts.sh -importURLMappings
fromFile="./mappings.txt"
Le changement de nom commencera en ligne sur
Jazz Team
Server
avant qu'il soit redémarré.
- Si vous avez un déploiement est réparti et êtes autorisé à mapper des
unités réseau, mappez une unité réseau depuis l'hôte
Jazz Team
Server
vers chacun des hôtes d'applications. Créez ensuite un fichier (par exemple, serverConfFile.txt)
contenant une liste des répertoires server/conf
distants dans votre déploiement, au format suivant :
# Remote CCM server
x:/JazzTeamServer/server/conf
# Remote QM server
y:/JazzTeamServer/server/conf
# Remote RM server
z:/JazzTeamServer/server/conf
Enfin, poursuivez avec la commande repotools-jts
-importURLMappings et ajoutez le paramètre
serverConfFile= comme indiqué ci-dessous.
repotools-jts.bat -importURLMappings
fromFile=".\mappings.txt" serverConfFile=".\serverConf.txt"
./repotools-jts.sh -importURLMappings
fromFile="./mappings.txt" serverConfFile="./serverConf.txt"
- Si vous avez un environnement CLM réparti et n'êtes pas autorisé à
remapper des unités réseau, poursuivez avec la commande repotools-jts
-importURLMappings (sans le paramètre serverConfFile=).
Copiez ensuite le fichier server/conf/jts/.mappingEvent
dans les répertoires de configuration des applications distantes
server/conf/nom_application), à savoir,
ccm, qm et rm.
Le fichier d'événements est généré lorsque vous importez les mappages. Vous
devez copier le fichier .mappingEvent après avoir
importé le fichier de mappage mais avant de démarrer le serveur.
Le fichier .mappingEvent contient les informations dont
les applications ont besoin pour contacter
Jazz Team
Server
à son nouvel emplacement. Le contenu du fichier
.mappingEvent file contents est identique pour un serveur
Jazz Team
Server
particulier et ses applications enregistrées.
Remarque : Les serveurs exécutés sous z/OS
doivent être renommés à l'aide d'un exemple de membre JCL
HLQ.SBLZSAMP(BLZRENAM). Pour obtenir des instructions de personnalisation
détaillées, voir l'en-tête de commentaire dans BLZRENAM.
Vérifiez que le changement de nom a réussi en vérifiant la sortie de la
console et le fichier RépInstallJazz/server/repotools-jts_importURLMappings.log.
Si des erreurs s'affichent ou si vous vous apercevez que vous avez fait une
erreur dans votre fichier de mappage, reportez-vous à la rubrique
Traitement des incidents liés au renommage de serveur pour identifier et corriger
le problème.
- Démarrez
Jazz Team
Server
et toute application CLM répartie installée.
A ce stade, les applications seront synchronisées avec
Jazz Team
Server
pour appliquer les mappages d'URL et mettre à jour leurs données d'entrepôt. Cette
opération peut prendre de 5 minutes pour un jeu de données réduit à 30 minutes
ou plus pour un jeu de données très volumineux.
- Connectez-vous à
Jazz Team
Server
à l'adresse
https://nom_hôte:port/jts/serverRenameStatus
(par exemple,
https://clmhost.production.exemple.org:9443/jts/serverRenameStatus)
pour suivre la progression du changement de nom. Cette page est actualisée
automatiquement jusqu'à ce que le changement de nom soit terminé.
Si des erreurs s'affichent, reportez-vous à la rubrique
Traitement des incidents liés au renommage de serveur pour identifier et corriger
le problème.
Remarque : Toute tentative de connexion à l'interface utilisateur pour les
applications CLM avant que le changement de nom soit terminé vous
redirige vers cette page d'état.
- Appliquez la procédure de vérification du changement de nom du
serveur décrite dans Vérification du renommage de serveur.
- Facultatif : Effectuez les étapes suivantes pour configurer Rational Reporting for Development
Intelligence (RRDI) dans l'environnement de production :
- Sauvegardez les bases de données suivantes à partir de l'environnement
pilote et restaurez-les sur un nouveau serveur de base de données pour la
nouvelle installation de RRDI dans l'environnement de production :
- La base de données Content Store (par exemple, RICM, si elle n'a pas déjà
été sauvegardée et restaurée)
- L'entrepôt de données (par exemple, RIDW, s'il n'a pas déjà été sauvegardé
et restauré).
- Installez Rational Reporting
for Development Intelligence version 2.0 dans l'environnement de production.
Pour plus d'informations, voir la rubrique traitant de
l'installation
de Rational Reporting
for Development Intelligence à l'aide d'Installation Manager.
- Configurez le serveur de rapports en exécutant l'application de
configuration de RRDI. Pour plus d'informations, voir
Tâches
de post-installation. N'oubliez pas d'effectuer les actions
suivantes :
- In the Configure Content Store Database page,
specify the connection properties for the content store database (for
example, RICM) that you restored in Step 7.a.
- Dans la page Configuration de Data Warehouse,
indiquez les propriétés de connexion pour la base de données d'entrepôt (par
exemple, RIDW) que vous avez restaurée à l'étape 7.a.
- Connectez-vous à
Jazz Team
Server
et vérifiez que les URL du serveur de rapports enregistrées dans les Propriétés
avancées de
Jazz Team
Server
et les pages d'administration de CCM et QM pointent sur le serveur de rapports
RRDI de production. Si elles ne pointent pas sur le système de production,
mettez-les à jour selon les besoins.
Remarque : Si vos fichiers de mappage contenaient des mappages pour l'URL de serveur
de rapports, la mise à jour a dû être faite automatiquement.
- Vérifiez que tous les rapports précédemment importés à partir du serveur
de rapports RRDI pilote fonctionnent toujours.
- Tous les rapports Cognos ou les vues de rapport ayant une action
définie sur View most recent report doivent être
réexécutés après le changement de nom d'un serveur CLM pour que le rapport HTML
en cache soit mis à jour.
- Connectez-vous au serveur de rapports RRDI.
- Recherchez les rapports ou les vues de rapport ayant des versions de sortie
en cache.
Remarque : Si une version de sortie en cache existe pour un rapport ou une
vue de rapport, vous pouvez cliquer sur View the output
versions pour ce rapport afin d'afficher les rapports mis en cache. Si
les rapports ou les vues de rapport ont été générés avant le changement de nom
du serveur CLM vous devez réexécuter les rapports ou les vues de rapport
pour les mettre à jour. Sinon, les utilisateurs qui exécutent les rapports ou
les vues de rapport voient les liens périmés pointant sur l'ancien serveur CLM.
- Cliquez sur Exécuter avec des options pour
réexécuter les rapports ou les vues de rapport.
- Dans l'afficheur de rapport, cliquez sur l'option de
pour mettre à jour les versions de sortie
mises en cache associées aux rapports ou aux vues de rapport.
- Importez un nouveau rapport à partir du serveur de rapports RRDI de
production. Vérifiez que l'importation a réussi et que le rapport importé
s'exécute sans problèmes.
- Si vous avez configuré des rapports instantanés
Rational Quality
Manager
dans RRDI, effectuez la procédure de génération du fichier
xdc pour le nouveau serveur et pour le configurer dans le
gestionnaire ODBC 32 bits. Pour plus d'informations, voir la rubrique relative
à la configuration
de la génération de rapports instantanés.
- Effectuez toutes les étapes de changement de nom de serveur requises pour
l'intégration à d'autres composants et produits tels que
Jazz Build Engines,
Rational Reporting,
Rational Team
Concert
clients, Rational
ClearQuest ou Rational
ClearCase.
Pour plus d'informations, reportez-vous à la rubrique Restrictions et informations supplémentaires.