Cette rubrique explique comment utiliser la fonction de changement de nom du serveur pour préparer un environnement de transfert avec des données de production réelles. Un environnement de transfert est un bac à sable de test qui est isolé de l'environnement de production. Il permet de tester de nouveaux dispositifs ou de nouvelles fonctionnalités avec des données réelles sans affecter la base de données de production.
Pourquoi et quand exécuter cette tâche
Important : Cette procédure ne doit pas être utilisée pour mettre à niveau une version précédente de votre environnement. Le changement de nom du serveur peut être effectué uniquement dans les éditions de la version 4 et suivante. La mise à niveau vers la version 4 est donc un prérequis pour configurer un environnement de transfert en changeant le nom du serveur.
La fonction de changement de nom du serveur utilise un fichier de mappage pour identifier les adresses URL à renommer. La commande repotools est disponible pour générer un fichier de mappage initial. Le fichier de mappage contient des paires source-cible pour Jazz Team
Server et l'ensemble des applications, ainsi que pour d'autres adresses URL fournies par des applications.
Pour plus d'informations sur le fichier de mappage, reportez-vous à la rubrique Description du fichier de mappage utilisé dans le cadre du renommage de serveur. Pour obtenir des exemples de diagramme de la topologie et de fichier de mappage, reportez-vous à la rubrique Topologies et fichiers de mappage pour la configuration d'un environnement de transfert de test.
Lorsque vous planifiez un environnement de transfert, vous devez veiller à ne pas contaminer les données de production et inversement. Pour cela, vous disposez de deux méthodes : ajoutez des entrées au fichier hosts si cette opération est autorisée dans votre environnement ou créez des mappages pour masquer les serveurs qui n'existent pas dans l'environnement de transfert. Veillez à inclure dans le mappage tous les autres serveurs CLM ou produits non CLM qui peuvent être connectés au serveur de production. Pour plus d'informations, reportez-vous à l'étape 3.c et à la rubrique relative aux mappages fictifs pour les environnements de tranfert.
Par exemple, vous pouvez avoir une application CCM (Change and Configuration Management) sur un serveur de production avec des liens à CCM sur un autre serveur de production et des liens à QM (Quality Management) sur un autre serveur de production.
Vous pouvez également avoir des intégrations avec d'autres produits non CLM, tels que Rational ClearQuest. Dans ce cas, vous devez d'abord masquer les adresses URL des autres serveurs CCM et QM et vérifier que l'adresse URL de Rational ClearQuest est également masquée ou mappée à un serveur passerelle Rational ClearQuest de transfert.
Important : Ne connectez pas un clientRational Team
Concert aux référentiels de production et de transfert. Utilisez toujours un espace de travail de transfert pour vous connecter au serveur de tranfert.
Le diagramme ci-dessous affiche les principales étapes à suivre pour configurer un environnement de transfert à l'aide de la fonction de changement du nom de serveur. On suppose que les dernières versions de CLM (version 4) et de RRDI (version 2) sont déjà installées.
- Préparez le changement de nom en suivant les instructions de la rubrique Préparation du fichier de mappage.
Veillez à créer des mappages fictifs pour toutes les adresses URL affectées dans le fichier de mappage. Cette opération est nécessaire pour éviter des liens croisés entre l'environnement de transfert et l'environnement de production. Pour plus d'informations, reportez-vous à la rubrique relative aux mappages fictifs pour les environnements de transfert.
Le résultat final de la phase préparatoire est un fichier de mappage généré sur le système Jazz Team
Server source d'origine.
Après avoir examiné et modifié le fichier de mappage avec précaution, copiez-le dans le répertoire répertoire_installation_Jazz\server sur le système Jazz Team
Server cible de l'environnement de transfert.
- Effectuez une copie de sauvegarde de l'environnement de production version 4 et copiez les index de texte et les fichiers de configuration des applications sur le serveur de transfert cible.
Comme vous devez arrêter les serveurs de production pour suivre ces étapes, veillez à effectuer la copie de sauvegarde au moment opportun, de préférence juste avant la configuration de l'environnement de transfert. Si des modifications sont apportées à l'environnement de production avant le changement de nom, vous devez regénérer le fichier de mappage avant de l'importer sur le serveur de transfert. Lorsque les serveurs sont arrêtés, les utilisateurs ne peuvent pas créer ou utiliser les liens des systèmes externes intégrés au déploiement CLM que vous souhaitez renommer.
- Arrêtez Jazz Team
Server et les applications CLM distribuées qui sont enregistrées sur le système Jazz Team
Server dans l'environnement de production.
- Effectuez la copie de sauvegarde de toutes les bases de données de l'environnement de production CLM 4.0, y compris la base de données de Jazz Team
Server, les bases de données des applications CCM et QM, la base de données de l'entrepôt de données et la base de données du magasin de contenu RRDI. Copiez les bases de données de l'environnement de production vers l'environnement de transfert en suivant les étapes de la rubrique Déplacement d'une base de données CLM.
- Copiez les index JFS/text du serveur de production source sur le serveur de transfert cible. (Pour les systèmes distribués, accédez au serveur approprié pour copier les fichiers.)
Les exemples suivants s'appliquent à un serveur Linux et supposent que les unités des ordinateurs de transfert sont montées sur le réseau.
Si ce n'est pas possible dans votre environnement, utilisez d'autres méthodes de transfert de fichiers pour garantir la copie des fichiers.
cp -R répertoire_installation_Jazz_source/server/conf/jts/indices répertoire_installation_Jazz_cible/server/conf/jts
cp -R répertoire_installation_Jazz_source/server/conf/ccm/indices répertoire_installation_Jazz_cible/server/conf/ccm
cp -R répertoire_installation_Jazz_source/server/conf/qm/indices répertoire_installation_Jazz_cible/server/conf/qm
- Copiez les fichiers de configuration des applications du serveur de production source vers le serveur de transfert cible. (Pour les systèmes distribués, accédez au serveur approprié pour copier les fichiers.) Comme à l'étape précédente, les exemples ci-dessous s'appliquent à un serveur Linux et supposent que les unités des ordinateurs de transfert sont montées sur le réseau.
cp répertoire_installation_Jazz_source/server/conf/jts/teamserver*.properties répertoire_installation_Jazz_cible/server/conf/jts
cp répertoire_installation_Jazz_source/server/conf/ccm/teamserver*.properties répertoire_installation_Jazz_cible/server/conf/ccm
cp répertoire_installation_Jazz_source/server/conf/qm/teamserver*.properties répertoire_installation_Jazz_cible/server/conf/qm
cp répertoire_installation_Jazz_source/server/conf/admin/admin.properties* répertoire_installation_Jazz_cible/server/conf/admin
cp répertoire_installation_Jazz_source/server/conf/admin/friends.rdf* répertoire_installation_Jazz_cible/server/conf/admin
cp répertoire_installation_Jazz_source/server/conf/rm/fronting.properties répertoire_installation_Jazz_cible/server/conf/rm
cp répertoire_installation_Jazz_source/server/conf/rm/friendsconfig.rdf répertoire_installation_Jazz_cible/server/conf/rm
- Copiez le fichier de mappage dans le répertoire répertoire_installation_Jazz_cible\server du serveur de production. Pour plus d'informations sur le fichier de mappage, reportez- vous à la rubrique Préparation du fichier de mappage.
Remarque : Si vous apportez des modifications de configuration au déploiement CLM avant de passer à l'étape suivante, vous devez regénérer le fichier de mappage.
- Redémarrez tous les serveurs CLM et autorisez les utilisateurs à continuer à utiliser l'environnement de production. Les étapes restantes s'appliquent toutes à l'environnement de test de transfert.
- Suivez les étapes ci-dessous dans l'environnement de test de transfert :
- Restaurez les copies de sauvegarde des bases de données de l'environnement de production dans l'environnement de transfert. Il est recommandé d'utiliser un serveur de base de données distinct dans l'environnement de transfert pour éviter la surcharge du serveur de base de données dans l'environnement de production.
- Remplacez les paramètres de connexion de la base de données dans les fichiers répertoire_installation_Jazz/server/conf/nom_application/teamserver.properties afin qu'ils pointent vers les paramètres de connexion de la copie de transfert de la base de données dans l'environnement de test. Ils incluent les entrées de la base de données jts, des bases de données de l'application ccm et qm, de la base de données de l'entrepôt de données et des mots de passe mis à jour.
- Outre les mappages fictifs du fichier de mappage, mettez à jour le fichier hosts si votre environnement le permet pour empêcher l'accès aux URL des systèmes de production et éviter les modifications accidentelles des artefacts sur le serveur de production.
L'objectif est de résoudre les noms d'hôte sous la forme d'une adresse IP erronée qui n'est pas utilisée par l'un des serveurs CLM de l'environnement de production. Ainsi, si un serveur de l'environnement de transfert tente d'établir une connexion avec un serveur de production, la connexion échoue.
Etablissez la liste de tous les noms d'hôte distincts qui figurent dans le fichier de mappage. Il peut s'agir d'adresses URL source ou d'adresses URL affectées. Pour chaque nom d'hôte, créez une entrée dans le fichier hosts qui mappe le nom d'hôte à un adresse IP erronée. Vous devez modifier le fichier hosts pour tous les serveurs de l'environnement de transfert, y compris les serveurs tiers et les postes de travail client. Le fichier hosts suivant présente des exemples d'entrée pour le serveur de transfert :
# 10.10.10.10 représente une adresse IP qui n'héberge pas une application clm.
10.10.10.10 ProductionServerP1
10.10.10.10 ProductionServerP2
10.10.10.10 ProductionServerP3
- Ouvrez une invite de commande dans le répertoire répertoire_installation_Jazz\server et importez le fichier de mappage sur le système Jazz Team
Server cible à l'aide de la commande repotools-jts -importURLMappings.
- Si vous disposez d'un déploiement tout en un, importez le fichier de mappage en utilisant la commande repotools-jts -importURLMappings de la manière suivante :
repotools-jts.bat
-importURLMappings fromFile="C:\mappings.txt"
./repotools-jts.sh -importURLMappings
fromFile="opt/mappings.txt"
Le changement de nom est lancé en mode hors ligne sur le système Jazz Team
Server, avant le redémarrage du serveur.
- Si vous disposez d'un déploiement distribué et que vous êtes autorisé à mapper les unités réseau, mappez une unité réseau de l'hôte Jazz Team
Server vers chacun des hôtes d'application. Créez ensuite un fichier (par exemple, serverConfFile.txt) qui contient 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
Exécutez ensuite la commande repotools-jts -importURLMappings et ajoutez le paramètre serverConfFile=, comme indiqué ci-dessous.
repotools-jts.bat
-importURLMappings fromFile="C:\mappings.txt" serverConfFile="C:\serverConf.txt"
./repotools-jts.sh -importURLMappings
fromFile="/opt/mappings.txt" serverConfFile="/opt/serverConf.txt"
- Si vous disposez d'un déploiement CLM distribué et que vous n'êtes pas autorisé à remapper des unités réseau, exécutez la commande repotools-jts -importURLMappings comme indiqué ci-après :
repotools-jts.bat
-importURLMappings fromFile="C:\mappings.txt"
./repotools-jts.sh -importURLMappings
fromFile="opt/mappings.txt"
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.
Vous devez copier le fichier .mappingEvent après l'importation du fichier de mappage mais avant le démarrage du 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 d'un système Jazz Team
Server et de ses applications enregistrées est identique.
Vérifiez que le changement de nom a réussi en vérifiant les données générées sur la console et le fichier server/repotools-jts_importURLMappings.log.
Si des erreurs s'affichent ou que vous constatez que vous avez fait une erreur dans le fichier de mappage, reportez-vous à la rubrique Traitement des incidents liés au renommage de serveur pour identifier et résoudre l'incident.
Remarque : Les serveurs sous z/OS doivent être renommés à l'aide de l'exemple de membre JCL HLQ.SBLZSAMP(BLZRENAM). Pour connaître les instructions de personnalisation détaillées, reportez-vous à l'en-tête de commentaire de BLZRENAM.
- Démarrez Jazz Team
Server et les applications CLM distribuées qui sont enregistrées auprès de Jazz Team
Server.
A ce stade, les applications CLM sont synchronisées avec le système Jazz Team
Server pour appliquer les mappages d'URL et mettre à jour leurs données d'entrepôt. Cette procédure doit prendre 5 minutes environ pour un petit ensemble de données et jusqu'à 30 minutes pour un ensemble de données très volumineux.
- Connectez-vous au système Jazz Team
Server en entrant https://nouvel hôte:port/jts/serverRenameStatus pour vérifier le statut de l'opération de changement de nom.
Attendez que le changement de nom de toutes les applications soit terminé et que l'étape de finalisation du changement de nom du serveur aboutisse. Vérifiez que le message suivant s'affiche : L'opération de renommage du serveur a abouti. Jazz Team Server et les applications sont entièrement fonctionnels. Vous pouvez commencer à utiliser immédiatement les serveurs et aucun redémarrage n'est nécessaire.
Si des erreurs s'affichent, reportez-vous à la rubrique Traitement des incidents liés au renommage de serveur pour identifier et résoudre l'incident.
Remarque : Toute tentative de connexion à l'interface utilisateur Web de l'une des applications CLM avant l'exécution du changement de nom vous redirige vers cette page d'état.
- Suivez les étapes de vérification du changement de nom du serveur décrites à l'étape Vérification du renommage de serveur.
Remarque : Si vous avez défini des mappages fictifs pour protéger l'environnement de production, des erreurs relatives à ces adresses URL risquent d'apparaître dans la section Applications et amis de la page de diagnostic d'application du serveur de transfert.
- Facultatif : Suivez les étapes ci-dessous pour configurer
Rational Reporting for Development Intelligence (RRDI) dans l'environnement de transfert :
- Effectuez une copie de sauvegarde des bases de données suivantes de l'environnement de production et restaurez-les sur un nouveau serveur de base de données pour une nouvelle installation de RRDI dans l'environnement de transfert :
- La base de données du magasin de contenu (par exemple, RICM)
- L'entrepôt de données (par exemple, RIDW, s'il n'a pas encore sauvegardé et restauré).
- Installez Rational Reporting for Development Intelligence
version 2.0 dans l'environnement de transfert. Pour plus d'informations, reportez-vous à la rubrique Installation de Rational Reporting for Development Intelligence à l'aide d'Installation Manager.
- Configurez le serveur de rapport en exécutant l'application RRDI Setup. Pour plus d'informations, reportez-vous à la rubrique Tâches de post-installation. Veillez à effectuer les opérations suivantes :
- Dans la page Configuration de la base de données Content Store, indiquez les propriétés de connexion à la base de données (par exemple, RICM) que vous avez restaurées à l'étape 7.a.
- Dans la page Configuration de Data Warehouse, indiquez les propriétés de connexion de la base de données Data Warehouse (par exemple, RIDW) que vous avez restaurées à l'étape 7.a.
- Connectez-vous au système Jazz Team
Server et mettez à jour les adresses URL du serveur de rapport stockées dans la section Propriétés avancées dans les pages d'administration du système Jazz Team
Server et de CCM et QM pour indiquer le serveur de rapport RRDI transféré.
Remarque : Cette étape est nécessaire uniquement si le fichier de mappage ne dispose pas des adresses URL de RRDI.
- Vérifiez que tous les rapports qui ont déjà importés à partir du serveur de rapport RRDI de l'environnement de production continuent à fonctionner.
- Après avoir renommé un serveur CLM, vous devez réexécuter les rapports ou les vues de rapport Cognos associés à l'action Afficher le rapport le plus récent pour assurer la mise à jour des rapports HTML en mémoire cache.
- Connectez-vous au serveur de rapport RRDI.
- Recherchez les rapports ou les vues de rapports dont les versions de sortie sont placées en mémoire cache.
Remarque : Si un rapport ou une vue de rapport dispose d'une version de sortie en mémoire cache, vous pouvez cliquer sur Afficher les versions de sortie de ce rapport pour afficher les rapports en mémoire 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 les réexécuter pour les mettre à jour. Dans le cas contraire, les utilisateurs qui exécutent les rapports ou les vues de rapport affichent des liens obsolètes qui pointent vers l'ancien serveur CLM.
- Cliquez sur Options d'exécution pour réexécuter les rapports et les vues de rapport.
- Dans l'afficheur de rapport, cliquez sur pour mettre à jour les versions de sortie en mémoire cache associées aux rapports ou aux vues de rapport.
- Importez un nouveau rapport à partir du serveur de rapport RRDI transféré.
Vérifiez que l'importation aboutit et que le rapport importé s'exécute normalement.
- Si vous avez configuré les rapports opérationnels de Rational Quality
Manager dans RRDI, suivez les étapes indiquées pour générer le fichier xdc du nouveau serveur et le configurer dans le gestionnaire ODBC 32 bits. Pour plus d'informations, reportez-vous à la rubrique Configuration de la génération de rapports opérationnels.
- Si vous ajoutez d'autres composants dans l'environnement de transfert, par exemple des moteurs de génération Jazz, des clients Rational Team
Concert, Rational ClearQuest ou Rational ClearCase, suivez les étapes supplémentaires requises. Pour plus d'informations, reportez-vous à la rubrique Restrictions et informations supplémentaires.