Mise à niveau hors ligne vers la version 3.0.1 à l'aide du script de mise à niveau

Cette rubrique explique comment mettre à niveau IBM® Rational Requirements Composer version 2 vers la version 3.0.1 à l'aide du script rm_upgrade.

Avant de commencer

Avant de lancer la mise à niveau, vérifiez que les horloges de toutes les machines sont synchronisées via le protocole NTP (Network Time Protocol). 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. 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.

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

Important : Pour pouvoir utiliser le script de mise à niveau dans un environnement distribué où vous installez l'application Gestion des exigences (RM) séparément de Jazz Team Server, ce script doit pouvoir accéder à l'unité ou au système de fichiers sur lequel RM est installée. Sous Windows, par exemple, l'unité doit être monté en tant que : lettre de l'unité montée:\server\conf. Un chemin d'accès absolu, tel que \\<nom_machine>\rép_install_JTS301\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 de l'administrateur.

Vous pouvez suivre cas instructions de mise à niveau dans le cas d'un déploiement sur un seul serveur ou d'un déploiement distribué, ou bien monter une unité depuis Jazz Team Server et l'application Gestion des exigences.

Si vous utilisez un déploiement distribué en réseau et n'êtes pas habilité à monter l'unité, ou si vous êtes un administrateur expérimenté, et comptez réaliser chaque étape manuellement, vous pouvez suivre les instructions de la rubrique Mise à niveau hors ligne manuelle vers la version 3.0.1. Les étapes manuelles détaillent ce qu'effectuent les scripts.

Dans un environnement IBM WebSphere Application Server, remplacez le chemin d'installation par un chemin ne comportant pas d'espaces, tel que C:\IBM\JazzTeamServer. Toutefois, si un paramètre de nom ou de chemin de fichier comporte un espace, vous devez encadrer ce paramètre avec des guillemets. Par exemple, "C:\Program Files\IBM".

Procédure

  1. Consultez la rubrique Présentation du processus de déploiement et de mise à niveau. Consultez également le cas échéant les rubriques de la section : Planification du déploiement et de la mise à niveau.
    Important :
    • La racine de contexte RM version 2 d'origine (/rdm) et les URI de tous les artefacts RM seront conservés. La racine de contexte de Jazz Team Server sera changée de /jazz en /jts.
    • Si un URI public a été défini dans l'installation de la version 2, vous devez utiliser le même dans la version 3.0.1.
  2. Vérifiez que votre configuration matérielle et logicielle répond aux exigences minimales pour votre application, ou les dépasse (voir system requirements). Vérifiez les informations suivantes dans le fichier teamserver.properties version 2 actuel :
    • La propriété d'URI public - com.ibm.team.repository.server.webapp.url
    • Les informations de connexion à votre serveur de base de données (généralement, com.ibm.team.repository.db.vendor, com.ibm.team.repository.db.jdbc.location et com.ibm.team.repository.db.jdbc.password).

    Vous devez utiliser le même URI public dans la version 3.0.1. Si un URI public n'a pas été défini, utilisez l'interface Web d'administration de la version 2 (sous Propriétés avancées) pour définir l'URI avec nom d'hôte qualifié (https://hostname.example.com:port) avant la mise à niveau.

    La ligne de l'URI public dans le fichier teamserver.properties devrait être similaire à ceci :
    com.ibm.team.repository.server.webapp.url=https\://hostname.example.com\:9443/jazz
  3. Téléchargez depuis la page de projet Jazz.net le logiciel IBM Rational Requirements Composer et les autres applications de la solution Rational for Collaborative Lifecycle Management (CLM) à installer. Pour obtenir des instructions, voir Téléchargement du support d'installation du produit.
  4. Arrêtez le serveur IBM Rational Requirements Composer version 2.
  5. Sauvegardez la base de données IBM Rational Requirements Composer version 2 et le fichier teamserver.properties dans un emplacement temporaire (tmp). Le fichier teamserver.properties contient l'emplacement de la base de données, nécessaire à chaque application pour s'y connecter. Par défaut, ce fichier est situé dans la version 2 sous le chemin rép_install\server\conf\jazz\teamserver.properties. Pour les instructions de sauvegarde, reportez-vous aux rubriques suivantes :
  6. Exportez les données depuis votre base de données IBM Rational Requirements Composer existante :
    1. Accédez au répertoire IBM Rational Requirements Composer version 2 rép_install_RRC2\server.
    2. Exécutez la commande repotools -export (sous Windows) ou ./repotools.sh - export (sous AIX et Linux) et enregistrez le fichier hors de la structure de répertoires IBM Rational Requirements Composer, comme illustré dans l'exemple suivant de la version 2.0.1 :

    Windows : repotools -export toFile=c:\tmp\rrcdata.tar

    AIX or Linux : repotools -export toFile=/tmp/rrcdata.tar

    où la variable the toFile spécifie le nom du fichier .tar vers lequel exporter la base de données.

    Remarque :
  7. Si vous avez déjà installé Jazz Team Server version 3.0.1, arrêtez tous les serveurs de la version 3.0.1, y compris le serveur Jazz Team Server et ceux des autres applications CLM et sauvegardez votre base de données Jazz Team Server version 3.0.1 et votre environnement. Passez à l'étape 10.
  8. Si vous n'avez pas installé la version 3.0.1 de Jazz Team Server, installez Jazz Team Server. N'exécutez pas l'assistant de configuration.
  9. Si vous n'avez pas encore installé Jazz Team Server version 3.0.1 et que vous utilisez une base de données autre que la base de données par défaut Derby, vous devez créer les bases de données Jazz Team Server.

    Des bases de données sont requises pour Jazz Team Server et l'entrepôt de données. Vous n'avez pas besoin de créer une base de données pour l'application Gestion des exigences vu qu'elle utilise celle de Jazz Team Server pour le stockage des données. Pour plus de détails sur chaque base de données, consultez les rubriques dans Configuration de la base de données.

    Remarque : Si vous utilisez une base de données Oracle ou SQL Server, assurez-vous de copier le pilote de base de données dans l'emplacement approprié. Pour plus de détails, voir Configuration d'une base de données Oracle et Configuration d'une base de données de serveur SQL.
  10. Installez l'application Gestion des exigences sur une autre machine. Pour obtenir des instructions, voir Installation à l'aide d'IBM Installation Manager.

    Lors de l'installation, sélectionnez Utiliser la racine de contexte Rational Requirements Composer 2.x. Ceci installera l'application RM avec l'option requise pour préserver la racine de contexte /rdm version 2 pour RM, laquelle est nécessaire pour conserver les liens aux artefacts RM . Si vous ne sélectionnez pas cette option, la mise à niveau échouera. Pour plus de détails, voir Présentation du processus de déploiement et de mise à niveau.

  11. A la fin de l'installation, sélectionnez Aucun pour la question Quel programme souhaitez-vous démarrer ? et cliquez sur Terminer, puis sur Quitter.
  12. Si vous procédez à un déploiement sur WebSphere Application Server, arrêtez et désinstallez les fichiers .war suivants de la version 2 : converter.war, jazz.war, rrc-help.war et rdm.war. Pour plus d'informations, voir Configuration de WebSphere Application Server pour la mise à niveau de la version 3.
  13. Exécutez le script de mise à niveau hors ligne. Ouvrez une nouvelle fenêtre de commande depuis l'emplacement où vous avez installé Jazz Team Server version 3.0.1, accédez au répertoire rép_install_JTS301\server , et exécutez le script de mise à niveau upgrade\rm_upgrade.bat (sous Windows) ou le script de mise à niveau upgrade/rm_upgrade.sh (sous AIX ou Linux). Lors de son exécution, le script utilise la langue définie dans les paramètres régionaux de l'ordinateur.
    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. Pour plus d'informations sur le fichier de paramètres, reportez-vous à la rubrique 14.
    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 utilisiez des licences flottantes dans Rational Requirements Composer version 2, un problème connu peut vous imposer d'arrêter le script de mise à niveau, de démarrer Jazz Team Server et d'installer les licences flottantes de la version 3.0.1 avant d'importer vos données depuis la base de données IBM Rational Requirements Composer. Pour plus d'informations sur la marche à suivre, reportez-vous à la rubrique (en anglais) https://jazz.net/library/article/659.

    Si vous avez installé Jazz Team Server version 3.0.1 en même temps que l'application RM, 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\rm_upgrade.bat -oldApplicationHome rép_install_RRC2\server\conf -importFromFile c:\tmp\export.tar -createJTSTables 

    AIX or Linux :

    ./upgrade/rm_upgrade.sh -oldApplicationHome rép_install_RRC2/server/conf -importFromFile /tmp/export.tar -createJTSTables 
    Remarque : Le paramètre -createJTSTables s'applique aux installations dans lesquelles vous installez la version 3.0.1 Jazz Team Server et tous les produits Collaborative Lifecycle Management pour la première fois. Vous n'avez pas besoin d'inclure ce paramètre dans la commande si vous installez l'application RM seule, vu que Jazz Team Server version 3.0.1 existe déjà à un autre emplacement. . Le paramètre createTables crée une base de données Jazz Team Server et importe le contenu du fichier .tar. S'il existe déjà une base de données Jazz Team Server, vous ne devez pas inclure le paramètre createTables dans la ligne de commande, car il remplacera la base de données existante.

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

    Windows :

    rép_install_JTS301\server upgrade\rm_upgrade.bat -oldApplicationHome rép_install_RRCS2\server\conf -importFromFile c:\tmp\export.tar -newApplicationHome rép_install_RRC301\server\conf -jtsURL https://nom_domaine_entièrement_qualifié:port/jts

    AIX or Linux :

    rép_install_JTS301/server ./upgrade/rm_upgrade.sh -oldApplicationHome rép_install_RRCS2/server/conf -importFromFile /tmp/export.tar -newApplicationHome rép_install_RRC301/server/conf -jtsURL https://nom_domaine_entièrement_qualifié:port/jts
    Remarque :
    • Si vous utilisez un déploiement distribué et n'avez pas configuré Jazz Team Server version 3.0.1, vous pouvez alors ajouter le paramètre -createJTSTables dans l'exemple de ligne de commande ci-dessus.
    • Le paramètre -jtsURL correspond à l'URI public de Jazz Team Server. Par défaut, l'URI public de Jazz Team Server est dérivé de celui de l'application. Ce paramètre doit être spécifié dans un déploiement distribué où Jazz Team Server s'exécute sur une autre instance de serveur que l'application RM.

    Pour plus de détails sur les options de ligne de commande, entrez l'une des commandes suivantes :

    Windows : upgrade\rm_upgrade.bat -help

    AIX ou Linux : ./upgrade/rm_upgrade.sh -help

    En raison de la quantité d'informations à migrer, la migration hors ligne peut être assez longue.
    Avertissement : lors d'une migration hors ligne, vous devez vérifier les invites qui affichent le contenu des fichiers fusionnés, notamment la connexion de base de données spécifiée dans le fichier teamserver.properties et modifier ces fichiers si nécessaire.

    Ce script effectue les tâches suivantes :

    1. Met à jour les fichiers de configuration version 3.0.1 comme suit :
      • Exécute la commande -migration_rm_updateConfigurationFiles et met à jour les fichiers de the configuration et les fichiers Tomcat. 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.
        Important : Ne modifiez pas les propriétés de connexion à la base de données de l'entrepôt de données si elles se réfèrent actuellement à Derby. Utilisez uniquement l'assistant de configuration du serveur pour modifier ces propriétés.
        Remarque : Si vous n'avez pas encore installé Jazz Team Server version 3.0.1, vous devez renseigner à ce stade la propriété d'emplacement de la nouvelle base de données Jazz Team Server créée lors de l'étape 9.
      • Une fois que la fusion des fichiers de configuration a réussi, entrez [C] pour continuer. Une fenêtre du Bloc-notes (ou un éditeur vi sous les systèmes AIX ou Linux) s'ouvre et vous permet de vérifier le fichier teamserver.properties de Jazz Team Server. Vérifiez que la racine d'URI public dénoté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. Après quoi, enregistrez vos modifications (le cas échéant) et refermez l'éditeur pour poursuivre l'exécution du script.
      • Copie le fichier Tomcat users.xml de la version 2.
      • Fusionne le fichier friendsconfig.rdf de la version 2, lequel contient la liste des serveurs configurés pour l'intégration interréférentiel, avec celui de la version 3.0.1.
      • Fusionne le contenu des fichiers server.xml et web.xml (paramètres LDAP) avec ceux de la 3.0.1.
    2. Importe les données exportées de RM version 2 depuis le fichier .tar vers la base de données Jazz Team Server version 3.0.1 à l'aide de la commande repotools-jts -import (sous Windows) ou ./repotools-jts.sh -import (sous AIX et Linux).
      Remarque :
      • L'importation de référentiels volumineux pour l'application Gestion des exigences version 3.0.1 peut induire des erreurs OutOfMemoryException. Si votre nombre de projets et d'artefacts est significatif, remplacez la valeur du paramètre -Xmx dans le script repotools-jts.bat ou repotools-jts.sh (par défaut, 1500 Mo) par une valeur plus élevée. Pour des résultats optimaux, 4096 Mo sont recommandés si la machine dispose d'une mémoire suffisante.
      • Pour consulter la liste détaillée des modifications apportées aux fichiers de configuration de Rational Requirements Composer, reportez-vous à la rubrique Modifications apportées à Rational Requirements Composer.
  14. Facultatif : A la place de l'étape précédente, vous pouvez ouvrir le fichier des paramètres du scripts, modifier les valeurs par défaut et exécuter une forme abrégée de la ligne de commande. Pour des informations détaillées sur ces valeurs, reportez-vous à la rubrique rm_upgrade.

    Les versions anglaises et traduites des fichiers de paramètres sont situées dans le répertoire rép_install_Jazz\server\upgrade\params\rm_params.bat sous Windows et dans le répertoire ./params/rm_params.sh sous AIX ou Linux.

    1. Pour déterminer le nom exact du fichier de paramètres pour votre langue, exécutez depuis le répertoire rép_install_Jazz\server\upgrade la commande locale.bat -rm -showParamFileName sous Windows ou la commande ./locale.sh -rm -showParamFileName sous AIX ou Linux.
    2. Ouvrez le fichier rm_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. Toutefois, si un paramètre de nom ou de chemin de fichier comporte un espace, vous devez encadrer ce paramètre avec des guillemets. Spécifiez par exemple, OLD_APPLICATION_HOME="C:\Program Files\IBM\RRCS2002\server\conf". Consultez le fichier rép_install_Jazz\server\upgrade\doc\rm_help.txt pour plus d'informations sur chaque paramètre.
  15. Vérifiez que vos données de référentiel et vos fichiers de configuration ont été mis à jour. Pour plus d'informations, reportez-vous aux rubriques Vérification des fichiers de configuration lors de la mise à niveau et -migration_rm_updateConfigurationFiles.
  16. Une fois la migration hors ligne terminée, effectuez une sauvegarde de la base de données et de l'environnement Jazz Team Server version 3.0.1 dans un emplacement séparé de celui où vous avez sauvegardé la base de données de la version 2. Effectuez cette sauvegarde avant de procéder à la migration en ligne. Prenez soin de ne pas écraser votre sauvegarde de la base de données de la version 2.
  17. Si vous avez créé un certificat de sécurité pour son utilisation dans la version précédente, copiez ce certificat ou créez-en un nouveau. Pour plus de détails, voir Configuration des certificats de sécurité.
  18. Si vous exécutez le serveur d'applications Tomcat en tant que service Windows, vous devez supprimer le service, puis le réinstaller. Pour connaître la syntaxe de la commande, consultez la rubrique Exécution dans Apache Tomcat en tant que service Windows (32 bits).
  19. Si vous procédez au déploiement sur IBM WebSphere Application Server, déployez les fichiers 3.0 WAR et mappez les rôles de sécurité à un utilisateur ou à un groupe. Pour plus d'informations, reportez-vous à la rubrique Configuration de WebSphere Application Server pour la mise à niveau de la version 3.
  20. A l'issue de la sauvegarde, passez aux étapes de migration en ligne. Voir Etapes de mise à niveau de la migration en ligne.

Commentaires