Mise à niveau manuelle de la version 3.0 à la version 3.0.1

Cette rubrique décrit la procédure manuelle de la mise à niveau de Rational Team Concert version 3.0 vers la version 3.0.1 à l'aide des outils de référentiel.

Avant de commencer

Avant de mettre le serveur à niveau, vérifiez que vous disposez d'une copie à jour valide de votre base de données de référentiel Rational Team Concert et Jazz Team Server version 3.0.

Vérifiez également que les horloges de toutes les machines sont synchronisées à l'aide du protocole de synchronisation NTP. L'heure est l'élément critique permettant à un événement sur un noeud du réseau d'être mappé à un événement correspondant sur un autre noeud. Pour évitez des problèmes, vous pouvez déployer le service NTP dans l'entreprise. Pour plus d'informations sur NTP, visitez http://www.ntp.org/. De plus, tous les serveurs doivent utiliser la même méthode d'authentification pour leurs utilisateurs.

Si vous comptez mettre à niveau plusieurs produits, reportez-vous à la rubrique Ordre de mise à niveau pour vous aider à décider par lequel commencer.

Si vous utilisez la base de données Derby, copiez les bases de données JTS et CCM de la version 3.0 vers la version 3.0.1. Pour plus d'informations, voir Sauvegarde et restauration de la base de données Derby.
Remarque : Si vous utilisez la même base de données, la migration des données n'est pas requise. Mais si vous basculez vers une autre base de données lors de la mise à niveau, vous devez exporter les données depuis l'ancienne et les importer dans la nouvelle.

Mise à niveau de Jazz Team Server (JTS)

  1. Consultez les rubriques de la section Planification du déploiement et de la mise à niveau, le cas échéant.
  2. Arrêtez le serveur 3.0 JTS.
  3. Si vous n'avez pas encore installé Jazz Team Server dans le cadre d'une installation CLM, installez Jazz Team Server dans un nouvel emplacement sur le disque. Si vous avez déjà installé Jazz Team Server et mis à niveau vers la version 3.0.1 et si vous souhaitez installer et mettre à niveau l'application Gestion des modifications et de la configuration, passez à Mise à niveau de la gestion des modifications et de la Configuration (CCM).
  4. Lors de l'installation, sélectionnez Utiliser les racines de contexte de l'application 3.x par défaut.
  5. A la fin de l'installation, sélectionnez Aucun lorsque le système vous demande quel programme vous souhaitez démarrer.
  6. Accédez à <rép_install_3.0.1JTS>/server et exécutez la commande suivante :

    Si vous utilisez WebSphere Application Server, spécifiez le paramètre updateTomcatFiles=no dans la commande. Pour plus d'informations sur les paramètres qui peuvent être utilisés avec cette commande, voir -migration_jts_updateConfigurationFiles.

    repotools-jts -migration_jts_updateConfigurationFiles oldJTSHome=<rép_install_3.0JTS>/server/conf 

    Cette commande exécute les tâches suivantes :

    • Met à jour le fichier V3.0.1 teamserver.properties en fonction des informations du fichier V3.0.
    • Elle copie le contenu du fichier xml des utilisateurs Tomcat.
      A faire : Pour la base de données utilisateur Tomcat uniquement. Le fichier tomcat-users.xml est copié (non fusionné avec le fichier existant). Si vous mettez à niveau plusieurs applications CLM avec un JTS commun, vous devez fusionner manuellement les utilisateurs et regrouper les informations dans le fichier tomcat-users.xml. Les informations d'utilisateur et de groupe sont différentes si les utilisateurs font partie de différents groupes, dans différentes applications. Par exemple, utilisateurA dispose du rôle JazzAdmins dans CCM et du rôle JazzUsers dans QM. En outre, si certains utilisateurs se trouvent dans une application et non dans l'autre ou vice versa, ils doivent manuellement être ajoutés au fichier tomcat-users.xml.
    • Elle fusionne le contenu des fichiers server.xml et web.xml de la version 3.0 avec la version 3.0.1.
  7. Accédez à <rép_install_3.0.1JTS>/server et exécutez la commande suivante pour créer des tables de base de données JTS :
    repotools-jts -addTables
  8. Si vous utilisez Apache Tomcat, reportez-vous à Configuration d'Apache Tomcat.
  9. Si vous utilisez WebSphere Application Server, désinstallez vos application Web déjà installées et redéployez les fichiers jts.war, admin.war et clmhelp.war fournis avec l'installation 3.0.1. Pour plus de détails, voir Configuration de WebSphere Application Server pour la mise à niveau de la version 3.
  10. Démarrez le serveur JTS.
  11. Continuez avec Exécution de l'assistant de configuration pour configurer le serveur.

Mise à niveau de la gestion des modifications et de la Configuration (CCM)

  1. Consultez les rubriques de la section Planification du déploiement et de la mise à niveau, le cas échéant.
  2. Arrêtez le serveur CCM 3.0.
  3. Installez l'application CCM dans un nouvel emplacement sur le disque.
  4. Lors de l'installation, sélectionnez Utiliser les racines de contexte de l'application 3.x par défaut.
    Important : Si Rational Team Concert version 3.0 a été mis à niveau à partir d'une version 2, sélectionnez Utiliser la racine de contexte de Rational Team Concert 2.x pour conserver la racine de contexte /jazz.
  5. A la fin de l'installation, sélectionnez Aucun lorsque le système vous demande quel programme vous souhaitez démarrer.
  6. Accédez à <rép_install_3.0.1CCM>/server et exécutez la commande suivante :

    Si vous utilisez WebSphere Application Server, spécifiez le paramètre updateTomcatFiles=no dans la commande. Pour plus d'informations sur les paramètres qui peuvent être utilisés avec cette commande, voir -migration_ccm_updateConfigurationFiles.

    Remarque : La racine applicationContextRoot par défaut est jazz. Si vous mettez à niveau à partir de la version 3, veillez à spécifier le paramètre applicationContextRoot et à le définir par ccm.
    repotools-ccm -migration_ccm_updateConfigurationFiles oldApplicationHome=<rép_install_3.0CCM>/server/conf applicationContextRoot=ccm

    Cette commande exécute les tâches suivantes :

    • Met à jour le fichier v3.0.1 teamserver.properties en fonction des informations du fichier v3.0.
    • Copie le contenu du fichier tomcat-users.xml.
      A faire : Pour la base de données utilisateur Tomcat uniquement. Le fichier tomcat-users.xml est copié (non fusionné avec le fichier existant). Si vous mettez à niveau plusieurs applications CLM avec un JTS commun, vous devez fusionner manuellement les utilisateurs et regrouper les informations dans le fichier tomcat-users.xml. Les informations d'utilisateur et de groupe sont différentes si les utilisateurs font partie de différents groupes, dans différentes applications. Par exemple, utilisateurA dispose du rôle JazzAdmins dans CCM et du rôle JazzUsers dans QM. En outre, si certains utilisateurs se trouvent dans une application et non dans l'autre ou vice versa, ils doivent manuellement être ajoutés au fichier tomcat-users.xml.
    • Elle fusionne le contenu des fichiers server.xml et web.xml de la version 3.0 avec la version 3.0.1.
  7. Accédez à <rép_install_3.0.1CCM>/server et exécutez la commande suivante pour créer des tables de base de données CCM :
    repotools-ccm -addTables 
  8. Si vous utilisez Apache Tomcat, reportez-vous à Configuration d'Apache Tomcat.
  9. Si vous utilisez IBM WebSphere Application Server, désinstallez vos applications Web déjà installées et redéployez le fichier ccm.war fourni avec l'installation 3.0.1. Pour plus de détails, voir Configuration de WebSphere Application Server pour la mise à niveau de la version 3.
  10. Démarrez le serveur CCM.
  11. Utilisez l'interface Web d'administration si vous ajoutez l'application Gestion des modifications et de la configuration à un serveur Jazz Team Server établi. Voir Enregistrement d'applications avec Jazz Team Server.

Commentaires