Mise à niveau de la version 2 à la version 3.0.1 à l'aide du script de mise à niveau

Vous pouvez utiliser le script de mise à niveau pour minimiser le nombre de commandes à exécuter manuellement lors de la mise à niveau de vos données d'application.

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

Vérifiez que les horloges de tous les serveurs sont synchronisées à l'aide du protocole de synchronisation NTP. L'heure est l'élément critique permettant à un événement d'un noeud de réseau d'être mappé vers un événement correspondant sur un autre noeud. Ces problèmes peuvent être évités par un déploiement d'entreprise du service NTP. 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.

Important : Pour pouvoir utiliser le script de mise à niveau dans un environnement distribué où vous installez l'application Gestion de la qualité séparément de Jazz Team Server, le script de mise à niveau doit pouvoir accéder à l'unité ou au système de fichiers sur lequel Jazz Team Server est installé. Sous Windows, par exemple, le mappage doit suivre la forme <lettre de l'unité mappée>:\server\conf. Un chemin d'accès absolu (\\<nom_machine>\<rép_install>server\conf) ne fonctionnera pas. L'unité montée doit être configurée avec les droits de lecture, écriture et exécution pour le compte admin.

Si vous utilisez la base de données Derby, copiez la base de données de Rational Team Concert (<rép_install_RTC2>\server\BD_référentiel) de la version 2 vers la version 3.0.1. Pour plus d'informations, voir Sauvegarde et restauration de la base de données Derby.

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

Procédure

  1. Consultez les rubriques de la section Planification du déploiement et de la mise à niveau, le cas échéant.
  2. Vérifiez le fichier teamserver.properties version 2 existant pour la propriété com.ibm.team.repository.server.webapp.url.

    Vous devez utiliser la même URL publique dans la version 3.0.1. Si une URL publique n'a pas été définie, utilisez l'interface Web d'administration de la version 2 (Propriétés avancées) pour spécifier l'URL avec nom d'hôte qualifié (https://hostname.example.com:port) avant de procéder à la mise à niveau.

    La ligne de l'URL publique dans teamserver.properties devrait être similaire à ceci :
    com.ibm.team.repository.server.webapp.url=https\://<hostname.example.com>\:9443/jazz
  3. Arrêtez le serveur version 2.
  4. Si vous ne l'avez pas encore fait, installez Jazz Team Server et l'application Gestion des modifications et de la configuration (CCM) dans un nouvel emplacement. Si vous avez déjà installé Jazz Team Server et mis à niveau vers la version 3.0.1, installez l'application Gestion des modifications et de la configuration.
  5. Lors de l'installation, sélectionnez Utiliser la racine de contexte de Rational Team Concert 2.x.
  6. A la fin de l'installation, sélectionnez Aucun lorsque le système vous demande quel programme vous souhaitez démarrer.
  7. Créez une base de données séparée pour Jazz Team Server avec les mêmes paramètres que pour votre base de données version 2.x mais avec un nom différent. Pour plus d'informations sur la création de bases de données, reportez-vous à la rubrique Configuration de la base de données.
    Remarque : Une base de données Jazz Team Server distincte de la base de données CCM est requise. Créez une base de données JTS si vous ne l'avez pas encore fait.
  8. Accédez à <rép_install_3.0.1CCM>/server et exécutez la commande suivante :
    Remarque : Vous pouvez exécuter le script en spécifiant tous les arguments dans la ligne de commande. Vous pouvez aussi, si vous allez exécuter plusieurs fois le script de mise à niveau, éditer le fichier des paramètres du script et exécuter une ligne de commande concise. Reportez-vous à l'étape suivante pour consulter les instructions pour le fichier de paramètres.

    Si vous avez besoin de plus d'informations sur les options de ligne de commande, voir ccm_upgrade.

    Important : Bien que le fichier de script soit situé sous le répertoire de mise à niveau, il doit être exécuté depuis le répertoire du serveur. De plus, si votre chemin d'accès comporte des espaces, prenez soin de l'encadrer avec des guillemets.

    Si vous avez installé la version 3.0.1 de Jazz Team Server en même temps que l'application CCM, et qu'il s'agit de la première ou de la seule application que vous mettez à niveau, la syntaxe de la commande est la suivante :

    Windows
    upgrade\ccm_upgrade.bat -oldApplicationHome <RTC2.x_install_dir>\server\conf -createJTSTables
    UNIX
    upgrade/ccm_upgrade.sh -oldApplicationHome <RTC2.x_install_dir>/server/conf -createJTSTables
    Remarque : Le paramètre -createJTSTables s'applique aux installations où vous installez Jazz Team Server 3.0.1 pour la première fois.

    Si vous avez installé Jazz Team Server version 3.0.1 séparément de l'application CCM (par exemple, dans un environnement distribué), vous devez spécifier l'emplacement de Jazz Team Server 3.0.1 et exécuter le script depuis le répertoire d'installation de CCM 3.0.1. Dans ce cas, incluez l'argument -newJTSHome.

    Windows
    upgrade\ccm_upgrade.bat -oldApplicationHome <RTC2.x_install_dir>\server\conf -newJTSHome <JTS3.0.1InstallDir>\server\conf
    UNIX
    upgrade/ccm_upgrade.sh -oldApplicationHome <RTC2.x_install_dir>/server/conf -newJTSHome <JTS3.0.1InstallDir>/server/conf
    Remarque : Si vous utilisez un déploiement distribué et n'avez pas configuré Jazz Team Server, vous pouvez alors ajouter le paramètre -createJTSTables dans l'exemple de ligne de commande ci-dessus.
    Le script exécute les tâches suivantes avec les interactions d'utilisateur indiquées :
    • Exécute la commande -migration_ccm_updateConfigurationFiles et met à jour les fichiers Tomcat et de configuration. Entrez [E] pour exécuter la commande, [S] pour ignorer cette étape ou appuyez sur la touche [Entrée] pour annuler l'exécution du script.
    • Une fois que la fusion des fichiers de configuration a réussi, entrez [C] pour continuer. La fenêtre Bloc-notes (ou un éditeur vi sur les systèmes Unix) qui apparaît vous permet de vérifier le fichier teamserver.properties CCM. Vérifiez que la racine d'URI public indiquée par la propriété com.ibm.team.repository.server.webapp.url est correcte. Vérifiez également que les propriétés de base de données sont correctes. L'emplacement de la base de données doit être différent de celui de la base de données JTS. Lorsque vous avez terminé, sauvegardez vos modifications, si nécessaire, et fermez l'éditeur pour continuer à exécuter le script.
      Important : Ne modifiez pas les propriétés de connexion à la base de données de l'entrepôt de données, y compris si elles sont définies par Derby. Utilisez uniquement l'assistant de configuration du serveur pour modifier ces propriétés.
      Pour plus d'informations sur la vérification des fichiers de configuration, voir Vérification des fichiers de configuration pendant la mise à niveau.
    • Poursuivez à exécuter le script jusqu'à ce qu'apparaisse un message indiquant que la mise à niveau CCM a réussi.
  9. Facultatif : A la place de l'étape précédente, vous pouvez ouvrir le fichier des paramètres du script, modifier les valeurs par défaut et exécuter une forme abrégée de la ligne de commande.

    Les versions anglaises et traduites des fichiers ccm_params se trouvent dans le répertoire <rép_install_3.0.1CCM>/server/upgrade/params.

    1. Pour déterminer le nom exact du fichier de paramètres pour votre langue, exécutez depuis le répertoire <rép_install_3.0.1CCM>\server\upgrade la commande locale.bat -ccm -showParamFileName sous Windows ou locale.sh -ccm -showParamFileName sur les systèmes UNIX.
    2. Ouvrez le fichier ccm_params ou sa version traduite pour modifier ou spécifier des valeurs pour chaque paramètre. L'un des paramètres devant être définis est le chemin d'accès au répertoire OLD_APPLICATION_HOME. Vérifiez que ce chemin ne comporte pas d'espaces.
  10. Si vous utilisez Apache Tomcat, reportez-vous à Configuration d'Apache Tomcat.
  11. Si vous utilisez WebSphere Application Server, désinstallez vos applications Web déjà installées et redéployez les fichiers jts.war, ccm.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.
  12. Configurez le serveur et les applications CLM que vous avez installées.

    Exécutez l'assistant de configuration du serveur si vous effectuez une mise à niveau de Jazz Team Server en même temps que l'application Gestion des modifications et de la configuration ou que l'une des applications CLM (voir Exécution de l'assistant de configuration) 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