Déplacement d'un déploiement pilote vers un serveur de production à l'aide d'un changement de nom de serveur

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.

Scénario de passage d'un pilote en mode production

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

  1. 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.

  2. Sauvegardez l'environnement du pilote version 4 et copiez les index de texte et les fichiers de configuration d'application dans la nouvelle installation.
    1. 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é.
    2. 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.
    3. 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 
    4. 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 
    5. 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.
  3. 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.
    1. Si vous effectuez un déploiement tout en un, importez le fichier des mappages à l'aide de la commande repotools-jts -importURLMappings comme suit :
      • For Windows operating system repotools-jts.bat -importURLMappings fromFile=".\mappings.txt"
      • For Unix operating systems ./repotools-jts.sh -importURLMappings fromFile="./mappings.txt"

      Le changement de nom commencera en ligne sur Jazz Team Server avant qu'il soit redémarré.

    2. 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.

      • For Windows operating system repotools-jts.bat -importURLMappings fromFile=".\mappings.txt" serverConfFile=".\serverConf.txt"
      • For Unix operating systems ./repotools-jts.sh -importURLMappings fromFile="./mappings.txt" serverConfFile="./serverConf.txt"
    3. 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.

  4. 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.

  5. 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.
  6. Appliquez la procédure de vérification du changement de nom du serveur décrite dans Vérification du renommage de serveur.
  7. Facultatif : Effectuez les étapes suivantes pour configurer Rational Reporting for Development Intelligence (RRDI) dans l'environnement de production :
    1. 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é).
    2. 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.
    3. 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.
    4. 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.
    5. Vérifiez que tous les rapports précédemment importés à partir du serveur de rapports RRDI pilote fonctionnent toujours.
    6. 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.
      1. Connectez-vous au serveur de rapports RRDI.
      2. 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.
      3. Cliquez sur Exécuter avec des options pour réexécuter les rapports ou les vues de rapport.
      4. Dans l'afficheur de rapport, cliquez sur l'option de conservation de la version > Sauvegarder le rapport pour mettre à jour les versions de sortie mises en cache associées aux rapports ou aux vues de rapport.
    7. 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.
    8. 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.
  8. 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.

Commentaires