Cette rubrique décrit le processus de mise à niveau manuelle de Rational Quality
Manager version
2 vers la version 3.
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.
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 sur le serveur de la version 2 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
- Consultez les rubriques de la section Planification du déploiement et de la mise à niveau, le cas échéant.
- 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
- 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.
- 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 vous ayez fini d'importer les données de la version 2 dans la base de données Gestion de la qualité (QM) version 3. A ce stade, vous devez arrêter
Jazz Team
Server.
Vous pouvez le redémarrer lorsque vous avez fini d'importer les données utilisateur et de licences dans
Jazz Team
Server (
14).
- Sauvegardez la base de données version 2 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 :
- Exportez les données depuis votre référentiel version 2 existant à l'aide de la commande
repotools -export et sauvegardez le fichier à un
emplacement distinct de l'infrastructure de répertoire de Rational Quality
Manager, comme indiqué dans l'exemple suivant de la
version 2.0.1 :
repotools -export toFile=c:\export.tar teamserver.properties=c:\Program%20Files\IBM\RQM201\server\conf\jazz\teamserver.properties
où toFile indique le nom du fichier TAR vers lequel le référentiel est exporté et teamserver.properties indique le chemin d'accès au fichier teamserver.properties.
- Si vous n'avez pas encore installé Jazz Team
Server,
installez le serveur, l'application Gestion de qualité 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.
- A la fin de l'installation, sélectionnez Aucun pour la question Quel programme désirez-vous démarrer ?.
- 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.
- Ouvrez une nouvelle fenêtre de commande dans la version 3.0.1 (rép_install_RQM301/server) et entrez repotools-jazz -migration_qm_updateConfigurationFiles oldApplicationHome=rép_install_RQM2/server/conf afin de fusionner les fichiers de configuration
Jazz de la version 2 avec ceux de la version 3.
Si vous avez installé
Jazz Team
Server version 3.0.1 séparément de l'application QM (par exemple, dans un environnement distribué), procédez comme suit :
- Montez l'unité ou le système de fichiers sur lequel Jazz Team
Server est installé.
- Indiquez l'emplacement de Jazz Team
Server 3.0.1 sur la ligne de commande -migration_qm_updateConfigurationFiles en incluant l'argument -newJTSHome.
Cette commande exécute les tâches suivantes :
- Met à jour les fichiers teamserver.properties de la version 3 pour les applications
et JTS en fonction des informations du fichier Jazz teamserver.properties de la version 2
- Copie le contenu du fichier xml des utilisateurs Tomcat
- Copie le fichier friendsconfig.rdf, lequel contient la liste des serveurs configurés pour l'intégration entre les référentiels
- Fusionne le contenu des fichiers server.xml et web.xml version 2 (paramètres LDAP)
avec ceux de la version 3.
- 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.
- 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.
- Importez les données Rational Quality
Manager
du référentiel version 2 exporté vers le nouveau référentiel Gestion de la qualité (QM) version 3
à l'aide de la commande repotools-jazz -import, comme indiqué dans l'exemple suivant :
repotools-jazz -import fromFile=c:\export.tar
où fromFile indique le nom du fichier TAR à partir duquel le référentiel sera 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.
- Créez la nouvelle base de données Jazz Team
Server (JTS) et transférez les données utilisateur et de licences depuis la base de données Gestion de la qualité.
- Exportez les données utilisateur à partir de l'application Gestion de la qualité
à l'aide de la commande repotools-jazz suivante :
repotools-jazz -migration_exportJTSData toFile=jtsData.tar
- Importez les données utilisateur et de licences dans la base de données Jazz Team
Server
à l'aide de la commande repotools-jtssuivante.
Important : S'il s'agit d'une nouvelle installation de Jazz Team
Server et n'importe quel produit Collaborative Lifecycle Management, la commande repotools-jts peut inclure le paramètre createTables, qui crée une nouvelle base de données JTS. S'il existe déjà une base de données JTS, vous ne devez pas inclure le paramètre createTables dans la ligne de commande, car il remplacera la base de données existante.
repotools-jts -migration_importJTSData fromFile=jtsData.tar createMappingFile=mapping-qm.txt createTables
- Importez les données de mappage utilisateur dans la base de données QM à l'aide de la commande
repotools-jazz suivante. Le mappage est utilisé
par l'application QM pour communiquer avec la base de données JTS.
repotools-jazz -migration_importUserMapping fromMappingFile=mapping-qm.txt
- 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, reportez-vous à la rubrique Configuration des certificats de sécurité.
- 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,
voir Exécution dans Apache Tomcat en tant que service Windows (32 bits, Rational Quality Manager).
- 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.
- Démarrez votre serveur d'application, Jazz Team
Server ou
WebSphere
Application Server version 3.
- 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).
- Accédez à jazz/admin et assurez-vous qu'il n'y a aucune erreur.
- 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.
- Ouvrez votre navigateur, libérez le cache du navigateur, puis reconnectez-vous
à votre projet.
- 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.
- 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 d'informations, reportez-vous à la rubrique Configuration de l'emplacement de l'aide dans un environnement distribué.
- 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.
- Mettez à jour vos rapports.
- Commencez par la migration de l'entrepôt de données version 2. Pour plus d'informations, reportez-vous à la rubrique Migration de données de rapports depuis la version 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 d'informations, reportez-vous à la rubrique Mise à jour des modèles de rapport prédéfinis.
- Si vous utilisiez Rational Common
Reporting dans la version 2, vous devez migrer les rapports vers Rational Reporting for Development Intelligence.
Pour plus de détails, voir Migration vers Rational Reporting
for Development Intelligence.
- Vérifiez que la mise a niveau est complète. Pour plus d'informations, reportez-vous à la rubrique Vérification de la mise à niveau.
Que faire ensuite
A l'issue de la mise à niveau, passez à la rubrique
Configuration de Jazz Team Server et de la première application après la mise à niveau.
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.