Mise à niveau de Rational Quality Manager vers la version 3.0.1 à l'aide du script de mise à niveau

Cette rubrique décrit comment mettre à niveau Rational Quality Manager de version 2 vers la version 3 à l'aide du script qm_upgrade.

Avant de commencer

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

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

Dans un environnement WebSphere Application Server, il est recommandé de remplacer le chemin d'installation par un chemin sans espace, par exemple C:\IBM\JazzTeamServer. Si un paramètre de nom ou de chemin de fichier comporte un espace, vous devez encadrer ce paramètre avec des guillemets.

Si vous effectuez une mise à niveau depuis la version 2.0.1 iFix02 ou ultérieure, effectuez une mise à niveau vers la version 2.0.1.1 ou ultérieure avant d'exporter vos données. Puis, exécutez la commande repotools suivante afin d'éviter des erreurs potentielles lors du processus d'exportation et d'importation.

Windows : repotools -repairRequests

Unix/Linux : ./repotools.sh -clean -repairRequests

Les utilisateurs des versions antérieures à la version 2.0.1 iFix02 peuvent ignorer cette étape.

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 dans votre fichier teamserver.properties de la version 2 la propriété d'URL publique com.ibm.team.repository.server.webapp.url et 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 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. Téléchargez le logiciel Rational Quality Manager depuis la page de projet appropriée sur jazz.net. Pour obtenir des instructions, voir Téléchargement du support d'installation du produit.
  4. Arrêtez le serveur de la version 2.
    Remarque : Si vous opérez dans un environnement distribué et avez déjà installé Jazz Team Server 3.0.1, pour minimiser les temps d'indisponibilité de Jazz Team Server et des autres applications, vous pouvez laisser le serveur en opération jusqu'à ce que le script de mise à niveau ait fini d'importer les données de la version 2 dans la base de données Gestion de la qualité (QM) de la version 3. A ce stade, vous devez arrêter Jazz Team Server. Vous pouvez le redémarrer après que le script ait fini d'importer les données utilisateur et de licences dans Jazz Team Server.
  5. Sauvegardez la base de données et le fichier teamserver.properties dans un emplacement temporaire. Par défaut, le fichier teamserver.properties est situé sous le chemin rép_install\server\conf\jazz\teamserver.properties pour la version 2. Pour les instructions de sauvegarde, reportez-vous aux rubriques suivantes :
  6. Exportez les données depuis votre référentiel existant de la version 2.
    1. Basculez vers le répertoire rép_install_RQM2\server de la version 2.
    2. Exécutez la commande repotools -export et enregistrez le fichier en dehors de la structure de répertoire Rational Quality Manager, comme indiqué dans l'exemple suivant de la version 2.0.1 :

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

    Unix/Linux : ./repotools.sh -export toFile=/tmp/export.tar

    où toFile indique le nom du fichier TAR vers lequel le référentiel est exporté.

    Remarque : Des instructions d'utilisation détaillées de repotools sont disponibles sur le site (en anglais) Getting Started with Repository Migration, ainsi que dans la rubrique Référence de ligne de commande Repotools. Utilisez bien la version de repotools incluse avec votre produit version 2 existant.
  7. Si vous n'avez pas encore installé Jazz Team Server, téléchargez et installez le serveur, l'application Quality manager et les clés de licence de base nécessaires à un nouvel emplacement du disque. Si vous avez déjà installé le serveur, installez l'application Gestion de la qualité. Pour obtenir des instructions, voir Installation à l'aide d'IBM Installation Manager.
    Important : Les exigences, défauts et autres éléments de travail ne sont plus créés dans l'application de gestion de qualité comme c'était le cas dans la version 2. Les équipes de test qui souhaitent bénéficier de ces fonctionnalités doivent également installer Gestion des exigences et Gestion des modifications et de la configuration. Dans un environnement distribué, ces applications peuvent être installées séparément.

    Lors de l'installation, sélectionnez Utiliser la racine de contexte de Rational Quality Manager 2.x. Cette opération permet d'installer l'application sur la racine de contexte /jazz, plutôt que sur /qm. Cette option est requise pour préserver les liens vers les artefacts QM. Si vous ne sélectionnez pas cette option, la mise à niveau échouera. Pour plus d'informations, reportez-vous à la rubrique Présentation du processus de déploiement et de mise à niveau.

  8. A la fin de l'installation, sélectionnez Aucun pour la question Quel programme désirez-vous démarrer ?.
  9. Si vous procédez à un déploiement sur WebSphere Application Server, arrêtez et désinstallez les applications jazz.war et help.war de la version 2.
  10. Si vous utilisez une base de données autre que la base de données Derby par défaut, créez les bases de données de la version 3.

    Des bases de données sont requises pour Jazz Team Server, les applications Gestion de la qualité, Gestion des modifications et de configuration 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 (RM) 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.
  11. Dans votre installation de la version 3, ouvrez une nouvelle fenêtre de commande, accédez au répertoire rép_install_Jazz\server et exécutez le script upgrade\qm_upgrade.bat sous Windows ou le script upgrade/qm_upgrade.sh sous UNIX.
    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 à la rubrique 12 pour les instructions concernant le fichier de paramètres.
    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 QM, 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\qm_upgrade.bat -oldApplicationHome rép_install_RQM201\server\conf -importFromFile c:\tmp\export.tar -createJTSTables

    Unix/Linux :

    ./upgrade/qm_upgrade.sh -oldApplicationHome rép_install_RQM201/server/conf -importFromFile /tmp/export.tar -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 QM (par exemple, dans un environnement distribué), vous devez spécifier l'emplacement du serveur Jazz Team Server 3.0.1 et exécuter le script depuis le répertoire d'installation de QM 3.0.1. Dans ce cas, incluez l'argument -newJTSHome.

    Windows :

    upgrade\qm_upgrade.bat -oldApplicationHome rép_install_RQM201\server\conf -importFromFile c:\tmp\export.tar -newJTSHome rép_install_JTS301\server\conf

    Unix/Linux :

    ./upgrade/qm_upgrade.sh -oldApplicationHome rép_install_RQM201/server/conf -importFromFile /tmp/export.tar -newJTSHome rép_install_JTS301\server\conf
    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 QM.
    • Si Jazz Team Server 3.0.1 est toujours en cours d'exécution, vous devez l'arrêter avant que le script n'entame le processus de migration des informations utilisateur et de licences. Jazz Team Server et les applications qui en dépendent seront placés hors ligne.

    Si vous avez besoin de plus d'informations sur les options de ligne de commande, entrez la commande suivante :

    Windows : upgrade\qm_upgrade.bat -help

    Unix/Linux : ./upgrade/qm_upgrade.sh -help

    Le script suivant exécute les tâches suivantes :

    1. Met à jour les fichiers de configuration version 3 comme suit :
      • Exécute la commande -migration_qm_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.
        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 10, ou, si vous réutilisez votre base de données Quality Manager version 2, vérifier que cette base de données a été sauvegardée au cas où vous devriez redémarrer le serveur Quality Manager version 2.
        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.
      • 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 et 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 xml des utilisateurs Tomcat version 2.
      • Fusionne le fichier friendsconfig.rdf version 2, qui contient la liste des serveurs configurés pour l'intégration interréférentiel, avec celui de la version 3.
      • Fusionne le contenu des fichiers server.xml et web.xml version 2 (paramètres LDAP) avec ceux de la version 3.
    2. Importe les données version 2 exportées depuis le fichier TAR dans la base de données Gestion de la qualité (QM) version 3 à l'aide de la commande repotools-jazz -import.
      Remarque : L'importation de référentiels volumineux pour Quality Management 3.0.1 peut induire des erreurs OutOfMemoryException. Les clients avec un nombre significatif de projets et d'artefacts devraient modifier le paramètre -Xmx du script repotools-jazz.bat ou repotools-jazz.sh en remplaçant la valeur par défaut (1500 Mo) par une valeur plus élevée. 4096 Mo sont recommandés si la machine dispose d'une mémoire suffisante et opère sous un système d'exploitation 64 bits.
    3. Exporte les données utilisateur et de licences depuis la base de données Gestion de la qualité (QM).
    4. Importe les données utilisateur et de licences QM dans Jazz Team Server.
    5. Importe les données de mappage utilisateur dans la base de données QM. Le mappage est utilisé par l'application QM pour communiquer avec la base de donnéesJazz Team Server.
    Remarque : Pour consulter la liste détaillée des modifications apportées aux fichiers de configuration de Rational Quality Manager, reportez-vous à la rubrique Modifications apportées à Rational Quality Manager
  12. 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 de paramètres sont situées dans le répertoire rép_install_Jazz\server\upgrade\params\qm_params.bat sous Windows ou dans le répertoire ./params/qm_params.sh sous UNIX.

    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 -qm -showParamFileName sous Windows ou la commande ./locale.sh -qm -showParamFileName sous UNIX.
    2. Ouvrez le fichier qm_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. Si ce chemin comporte des espaces, prenez soin de l'encadrer avec des guillemets. Consultez le fichier rép_install_Jazz\server\upgrade\doc\qm_help.txt pour plus d'informations sur chaque paramètre.
  13. Vérifiez vos fichiers de configuration. Pour plus d'informations, reportez-vous aux rubriques Vérification des fichiers de configuration lors de la mise à niveau et -migration_qm_updateConfigurationFiles.
  14. Si vous avez créé un certificat de sécurité en vue d'une utilisation avec la version précédente, copiez-le à partir de la version précédente ou créez-en un nouveau. Pour plus de détails, voir Configuration des certificats de sécurité.
  15. Si vous exécutez un serveur d'application Tomcat comme un service Windows, vous devez supprimer et réinstaller le service. Pour connaître la syntaxe de la commande, consultez la rubrique Exécution dans Apache Tomcat en tant que service Windows (32 bits).
  16. Si vous procédez au déploiement sur WebSphere Application Server, déployez les fichiers WAR 3.0 et mappez des rôles de sécurité vers l'utilisateur ou le groupe. Pour plus de détails, voir Configuration de WebSphere Application Server pour la mise à niveau de la version 3 et Déploiement d'applications CLM sur WebSphere Application Server.
  17. Démarrez votre serveur d'application, Jazz Team Server ou WebSphere Application Server version 3.
    Remarque : Si l'application QM a été installée séparément, vous devrez également démarrer l'application CLM.
  18. 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 de la qualité 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 de la qualité à un serveur Jazz Team Server existant (voir Enregistrement d'applications avec Jazz Team Server).

  19. Migrez vos exigences de la version 2 vers l'application Gestion des exigences (RM). Pour plus de détails, voir Migration d'exigences basées élément de travail.
    Remarque : Cette étape est obligatoire si vous gérez vos exigences version 2 en interne dans Rational Quality Manager. Elle n'est pas nécessaire si vous avez utilisé un fournisseur d'exigences externe.
  20. Ouvrez votre navigateur, libérez le cache du navigateur, puis reconnectez-vous à votre projet.
  21. Mettez à niveau les licences. Pour consulter une brève présentation, voir Explications relatives à l'octroi de licences. Suivez ensuite les étapes répertoriées dans Installation et gestion des clés de licence.
    Remarque : Les licences de Quality Manager et Lab Manager dans la version 2 sont maintenant appelées licences Quality Professional dans la version 3. Il n'existe plus de licence séparée pour Lab Manager. Les licences de connecteur dans la version 2 sont toujours appelés licences de connecteur, tandis que les licences d'afficheur de la version 2 sont maintenant appelés licences du connecteur.
  22. Si votre application d'aide (clmhelp.war) réside sur un autre serveur que l'application en cours, configurez l'emplacement de l'aide. Pour plus de détails, voir Configuration de l'emplacement de l'aide dans un environnement distribué.
  23. Mettez à jour vos tableaux de bord.

    Connectez-vous à votre application en tant qu'administrateur et accédez à n'importe quelle page à l'aide d'un tableau de bord. Cliquez ensuite sur Migrer pour mettre à niveau tous les tableaux de bord.

  24. Mettez à jour vos rapports.
    1. Commencez par la migration de l'entrepôt de données version 2. Pour plus de détails, voir Migration de données de rapports depuis la version 2.
    2. Lancez ensuite le client Rational Team Concert et effectuez une mise à niveau vers les modèles de rapports les plus récents. Pour plus de détails, voir Mise à jour des modèles de rapport prédéfinis.
    3. Si vous utilisiez Rational Common Reporting dans la version 2, vous devez migrer les rapports vers Rational Reporting for Development Intelligence. Pour plus d'informations, reportez-vous à la rubrique Migration vers Rational Reporting for Development Intelligence.
  25. Vérifiez que la mise a niveau est complète. Pour plus de détails, voir Vérification de la mise à niveau.

Que faire ensuite

A l'issue de la mise à niveau, passez aux rubriques Configuration de Jazz Team Server et de la première application après la mise à niveau et Enregistrement d'applications supplémentaires auprès de Jazz Team Server.
Remarque : Si vous migrez depuis Rational Common Reporting, sauvegardez votre base de données d'entrepôt de données Rational Common Reporting avant de configurer le serveur. Pour les instructions de sauvegarde, reportez-vous à la documentation du système de gestion de base de données relationnelle hébergeant votre entrepôt de données.

Commentaires