Cette rubrique décrit comment effectuer manuellement les étapes de mise à niveau
pour une migration hors ligne du serveur depuis IBM® Rational Requirements Composer
version 2 vers la version 3.0.1.
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 d'un noeud de réseau d'être mappé vers un événement correspondant sur un autre noeud. Cet écueil peut être évité en déployant le protocole du service NTP à l'échelon de 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.
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
- 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 votre installation de la version 2, vous devez utiliser le même dans la version 3.0.1.
- Vérifiez que votre configuration matérielle et logicielle répond aux exigences minimales pour votre application, ou les dépasse. Reportez-vous à la rubrique (en anglais)system
requirements. Extrayez les informations suivantes depuis votre fichier
teamserver.properties de la version 2 :
- 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 à l'exemple suivant :
com.ibm.team.repository.server.webapp.url=https\://<hostname.example.com>\:9443/jazz
- Téléchargez depuis Jazz.net le logiciel IBM
Rational Requirements Composer software , ainsi que les autres applications de la solution Rational pour Collaborative Lifecycle
Management (CLM) à installer. Pour obtenir des instructions,
voir Téléchargement du support d'installation du produit.
- Arrêtez le serveur IBM
Rational Requirements Composer version
2.
- 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, information dont chaque application a besoin pour se connecter à la base de données. 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 :
- Exportez les données depuis votre base de données IBM
Rational Requirements Composer existante.
- Accédez au répertoire IBM
Rational Requirements Composer version
2 rép_install_RRC2\server.
- Exécutez la commande Windows repotools -export ou la commande AIX ou Linux ./repotools.sh - export, 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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 utilisez la commande suivante pour fusionner les fichiers de configuration de la version 2 avec ceux de la
version 3.0.1 : repotools-jts -migration_rm_updateConfigurationFiles
oldApplicationHome=rép_install_RRCS20/server/conf.
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.
repotools-jts -migration_rm_updateConfigurationFiles
oldApplicationHome=rép_install_RRC2/server/conf newApplicationHome=<rép_install_JTS301>/server/conf -jtsURL https://<nom_domaine_entièrement_qualifié>:<port>/jts
Remarque : 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.
Cette commande exécute les tâches suivantes :
- Met à jour les fichiers rép_install_Jazz/server/conf/app/teamserver.properties de la version 3 en fonction des informations du fichier Jazz rép_install_Jazz/server/conf/jazz/teamserver.properties de la version 2.
Vous aurez la possibilité de modifier les valeurs, telles que les propriétés d'emplacement de base de données Jazz Team
Server, ce sont des informations que le script ne peut pas obtenir de la version 2.
Remarque : Si vous n'avez pas encore installé et configuré la version 3.0.1 de
Jazz Team
Server, à ce stade vous devez entrer la propriété d'emplacement de base de données pour la nouvelle base de données
Jazz Team
Server
créée précédemment lors de l'étape
9.
- 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.
Pour plus de détails, reportez-vous aux rubriques Fusion des fichiers de configuration et -migration_updateConfigurationFiles.
- Importez les données de Rational Requirements Composer depuis le référentiel exporté de la version 2 vers le nouveau référentiel Gestion des exigences (RM), version 3, à l'aide de la commande repotools-jts -importapplicationdata,
comme illustré dans l'exemple suivant :
repotools-jts migration_importapplicationdata fromFile=c:\export.tar
où la variable fromFile spécifie le nom du fichier .tar depuis lequel importer le référentiel.
Remarque : - S'il s'agit d'une nouvelle installation de Jazz Team
Server et de n'importe quel produit Collaborative Lifecycle Management, vous pouvez inclure le paramètre createTables dans le lien de commande si vous importez les données utilisateurs dans Jazz Team
Server pour la première fois. 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 utilisiez des licences flottantes dans IBM
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 version
2. Pour plus d'informations sur la marche à suivre, reportez-vous à la rubrique (en anglais) https://jazz.net/library/article/659.
- L'importation de référentiels volumineux pour Requirements Management 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.
- Vérifiez vos données de référentiel et vos fichiers de configuration. Pour plus d'informations, reportez-vous à la rubrique
Vérification des fichiers de configuration lors de la mise à niveau.
- 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.
- 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é.
- 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).
- 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 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.
- A l'issue de la sauvegarde, passez aux étapes de migration en ligne. Voir
Etapes de mise à niveau de la migration en ligne.