Cette rubrique décrit les étapes à suivre pour mettre à niveau le serveur version 3.0.1.x des applications Rational solution for Collaborative Lifecycle Management (CLM) vers la version
4 avec une configuration qui utilise WebSphere Application
Server et DB2 for z/OS.
Avant de commencer
Effectuez des copies des membres BLZSAMP pour vérifier les fichiers d'origine, si nécessaire. Vérifiez les fichiers journaux des exemples après la soumission des travaux. Le code retour attendu est 0.
Pourquoi et quand exécuter cette tâche
Les étapes suivantes permettent de migrer la configuration de la version
3.0.1.x vers une configuration de la version 4.0.
Procédure
- Installez le package CLM version 4 à l'aide de l'installation SMP/E. L'emplacement de la configuration de la version 4 doit être différent de celui de la version 3.0.1.x. L'installation du package SMP/E permet de disposer de nouveaux outils de sauvegarde de la base de données utilisés pour la mise à niveau. Pour plus de détails, voir Présentation du processus d'installation SMP/E.
Remarque : Les FMID de la version
4 ont changé. Il n'y a donc pas de correctifs PTF pour mettre à niveau la version 3.0.1.x vers la version 4.
- Arrêtez et sauvegardez les référentiels de la version 3.0.1.x à l'aide des utilitaires UNLOAD et LOAD de DB2 for z/OS. Pour plus d'informations, reportez-vous à la rubrique Utilisation du processus de déchargement et chargement DB2 pour sauvegarde.
Vous pouvez utiliser d'autres outils pour effectuer des copies de sauvegarde si ces outils ont été testés et vérifiés.
Important : Vous devez effectuer des copies de sauvegarde des référentiels avant de lancer une mise à niveau car les modifications apportées au canevas de référentiel par la procédure de mise à niveau ne peuvent pas être annulées.
- Pour vérifier les procédures de sauvegarde et de restauration, exécutez les étapes des utilitaires UNLOAD et LOAD dans une nouvelle base de données et un nouveau préfixe de schéma.
- Utilisez l'exemple de travail BLZCREDB de la version 3.0.1.x pour créer des tables dans la nouvelle bases de données.
- Pour tester intégralement les procédures de sauvegarde et de restauration des bases de données, créez des bases de données supplémentaires pour chaque référentiel. Les bases de données que vous créez doivent disposer des mêmes droits que les bases de données existantes.
- Si vous restaurez une copie de l'entrepôt de données, restaurez-la sur un sous-système DB2 z/OS car deux entrepôts de données ne peuvent pas se trouver sur un même sous-système.
- Créez des répertoires UNIX System
Services distincts (répertoire_travail_uss) pour chaque base de données.
- Utilisez des préfixes de schéma de référentiel dotés du même nombre de caractères.
- Vérifiez que les nouveaux référentiels de la version 3.0.1.x ont été correctement créés avant de lancer la mise à niveau.
- Configurez
Jazz Team
Server (JTS)
en modifiant et en soumettant le travail BLZCPJTS de l'exemple de membre SBLZSAMP version 4 pour définir la structure de la configuration et les répertoires de travail du serveur, y compris l'application Administration de projet de cycle de vie.
Remarque : Les répertoires de configuration (JAZZ_HOME) et de travail que vous créez pour la version 4 doivent être différents de ceux de la version 3.0.1.x pour permettre aux utilitaires de mise à niveau de fusionner les deux versions. Par exemple, le répertoire de configuration par défaut de la version 3.0.1.x est /etc/jazz. Pour la version 4, vous devez donc utiliser /etc/jazz40. De la même manière, utilisez /u/jazz40 pour le répertoire de travail.
Suivez les instructions indiquées dans l'exemple de membre ou reportez-vous à la rubrique Création de répertoires supplémentaires pour Jazz Team Server et les applications Rational solution for Collaborative Lifecycle Management.
- Configurez le serveur CCM (Change and Configuration Management) en modifiant et en soumettant le travail BLZCPCCM de l'exemple de membre SBLZSAMP version 4 pour définir la structure de la configuration et des répertoires de travail du nouveau serveur avec des définitions
CCM. Suivez les instructions indiquées dans l'exemple de membre ou reportez-vous à la rubrique Création de répertoires supplémentaires pour Jazz Team Server et les applications Rational solution for Collaborative Lifecycle Management.
- Configurez le serveur QM en modifiant et en soumettant le travail BLZCPQM de l'exemple de membre SBLZSAMP version 4 pour définir la structure de la configuration et des répertoires de travail du nouveau serveur avec des définitions
QM. Suivez les instructions indiquées dans l'exemple de membre.
- Configurez le serveur RM (Requirements Management) en modifiant et en soumettant le travail BLZCPRM de l'exemple de membre SBLZSAMP version 4 pour définir la structure de la configuration et des répertoires de travail du nouveau serveur avec des définitions
RM. Suivez les instructions indiquées dans l'exemple de membre.
- Désinstallez les applications 3.0.1.x de WebSphere Application
Server en effectuant les opérations suivantes :
- Connectez-vous à la console de WebSphere Application
Server Integrated Solutions à l'adresse https://example.com:9043/ibm/console/logon.jsp
- Cliquez sur Applications > Types d'application > Applications d'entreprise WebSphere.
- Notez le mappage des rôles de sécurité des applications de la version 3.0.1.x suivantes pour pouvoir les recréer pour les applications équivalentes de la version 4 :
- Arrêtez et désinstallez les applications 3.0.1.x suivantes :
- jts_war
- ccm_war
- qm_war
- rm_war
- clmhelp_war
- admin_war
- Sauvegardez les modifications apportées à la configuration maître lorsque vous y êtes invité.
- Mettez à jour les propriétés personnalisées JAZZ_HOME et log4j.configuration en effectuant les opérations suivantes :
- Connectez-vous à la console de WebSphere Application
Server Integrated Solutions à l'adresse https://example.com:9043/ibm/console/logon.jsp
- Cliquez sur Serveurs > Types de serveur > Serveurs d'applications WebSphere.
- Cliquez sur le nom du serveur pour l'ouvrir. Le nom du serveur par défaut est "server1."
- Sous Infrastructure du serveur, sélectionnez Gestion des processus et Java> Définition des processus.
- Sous Propriétés supplémentaires, sélectionnez Machine virtuelle Java.
- Sous Propriétés supplémentaires, sélectionnez Propriétés personnalisées.
- Sélectionnez JAZZ_HOME et mettez à jour sa valeur en indiquant file:///<répertoire_configuration_4.0>.
Par exemple, file:///etc/jazz40.
- Sélectionnez log4j.configuration et mettez à jour sa valeur en indiquant file:///<répertoire_configuration_4.0>/startup_log4j.properties.
Par exemple, file:///etc/jazz40/startup_log4j.properties.
- Sauvegardez les modifications apportées à la configuration maître lorsque vous y êtes invité.
Pour
plus d'informations, voir Configuration de WebSphere Application Server.
- Arrêtez WebSphere Application
Server.
- Supprimez les fichiers et les répertoires temporaires de WebSphere et effacez la mémoire cache en effectuant les opérations suivantes :
- Accédez au répertoire temporaire situé sous le profil WebSphere Application Server, en général <racine_profil_WAS>/temp/<nom_noeud>/<nom_serveur> et supprimez les répertoires <application>_war.
- Accédez à <racine_profil_WAS>/temp/wscache et accédez à <application>_war, s'il existe.
- Migrez la configuration du serveur JTS. Exécutez les outils de référentiel pour fusionner les paramètres des fichiers de configuration de la version 3.0.1.x avec ceux de la version 4 de JTS en modifiant le travail BLZJTSU de l'exemple de membre SBLZSAMP version 4.
Avant de soumettre le travail BLZJTSU, procédez comme suit :
- Supprimez les lignes contenant les paramètres suivants :
oldTomcatHome
newTomcatHome
- Remplacez la ligne : updateTomcatFiles=yes par updateTomcatFiles=no
- Remplacez la variable @pathPrefix@ en indiquant le préfixe du chemin des fichiers binaires de la version 4.
Remarque : La commande des outils de référentiel migration_jts_updateConfigurationFiles utilisée par cet exemple de membre a été ajoutée dans la version 3.0.1.
Si @pathPrefix@ correspond à des versions antérieures, la commande des outils de référentiel n'utilise pas la commande de mise à jour de la version 4.
- Suivez les instructions indiquées dans l'exemple de travail BLZJTSU.
Soumettez le travail BLZJTSU et vérifiez les données qu'il génère, ainsi que le fichier de propriétés mis à jour.
Remarque : Les propriétés de l'entrepôt de données qui correspondent à un entrepôt de données Derby sont conservées lors de cette opération de fusion mais elles seront traitées ultérieurement.
- Migrez la configuration du serveur CCM. Exécutez les outils de référentiel pour fusionner les paramètres des fichiers de configuration de la version 3.0.1.x avec ceux de la version 4 de CCM en modifiant le travail BLZCCMU de l'exemple de membre SBLZSAMP version 4.
Avant de soumettre le travail BLZCCMU, procédez comme suit :
- Supprimez les lignes contenant les paramètres suivants :
oldTomcatHome
newJTSTomcatHome
newApplicationTomcatHome
- Remplacez la ligne : updateTomcatFiles=yes par updateTomcatFiles=no
- Remplacez la ligne : applicationContextRoot=jazz par applicationContextRoot=ccm.
Le contexte d'application doit être /ccm sauf si le serveur version 3.0.1.x a été migré à partir de la version 2.x.
- Remplacez la variable @pathPrefix@ en indiquant le préfixe du chemin des fichiers binaires de la version 4.
Remarque : La commande des outils de référentiel migration_ccm_updateConfigurationFiles utilisée par cet exemple de membre a été ajoutée dans la version 3.0.1.x.
Si @pathPrefix@ correspond à des versions antérieures, la commande des outils de référentiel n'utilise pas la commande de mise à jour de la version 4.
- Suivez les instructions indiquées dans l'exemple de travail BLZCCMU.
Soumettez le travail BLZCCMU et vérifiez les données qu'il génère, ainsi que le fichier de propriétés mis à jour.
Remarque : Les propriétés de l'entrepôt de données qui correspondent à un entrepôt de données Derby sont conservées lors de cette opération de fusion mais elles seront traitées ultérieurement.
- Migrez la configuration du serveur QM. Exécutez les outils de référentiel pour fusionner les paramètres des fichiers de configuration de la version 3.0.1.x avec ceux de la version 4 de QM en modifiant le travail BLZQMU de l'exemple de membre SBLZSAMP version 4.
Avant de soumettre le travail BLZQMU, procédez comme suit :
- Supprimez les lignes contenant les paramètres suivants :
oldTomcatHome
newJTSTomcatHome
newApplicationTomcatHome
- Remplacez la ligne : updateTomcatFiles=yes par updateTomcatFiles=no
- Remplacez la variable @pathPrefix@ en indiquant le préfixe du chemin des fichiers binaires de la version 4.
Remarque : La commande des outils de référentiel migration_qm_updateConfigurationFiles utilisée par cet exemple de membre a été ajoutée dans la version 3.0.1.x.
Si @pathPrefix@ correspond à des versions antérieures, la commande des outils de référentiel n'utilise pas la commande de mise à jour de la version 4.
- Suivez les instructions indiquées dans l'exemple de travail BLZQMU.
Soumettez le travail BLZQMU et vérifiez les données qu'il génère, ainsi que le fichier de propriétés mis à jour.
Remarque : Les propriétés de l'entrepôt de données qui correspondent à un entrepôt de données Derby sont conservées lors de cette opération de fusion mais elles seront traitées ultérieurement.
- Migrez la configuration du serveur RM. Exécutez les outils de référentiel pour fusionner les paramètres des fichiers de configuration de la version 3.0.1.x avec ceux de la version 4 de RM en modifiant le travail BLZRMU de l'exemple de membre SBLZSAMP version 4.
Avant de soumettre le travail BLZRMU, procédez comme suit :
- Supprimez les lignes contenant les paramètres suivants :
oldTomcatHome
newJTSTomcatHome
newApplicationTomcatHome
- Remplacez la ligne : updateTomcatFiles=yes par updateTomcatFiles=no
- Remplacez la variable @pathPrefix@ en indiquant le préfixe du chemin des fichiers binaires de la version 4.
Remarque : La commande des outils de référentiel migration_rm_updateConfigurationFiles utilisée par cet exemple de membre a été ajoutée dans la version 3.0.1.x. Si @pathPrefix@ correspond à des versions antérieures, la commande des outils de référentiel n'utilise pas la commande de mise à jour de la version 4.
- Suivez les instructions indiquées dans l'exemple de travail BLZRMU.
Soumetttez le travail BLZRMU et vérifiez les données qu'il génère, ainsi que le fichier de propriétés mis à jour.
Remarque : Les propriétés de l'entrepôt de données qui correspondent à un entrepôt de données Derby sont conservées lors de cette opération de fusion mais elles seront traitées ultérieurement.
- Copiez les fichiers d'index en effectuant les opérations suivantes :
- Copiez les index JFS/text de la version 3.0.1.x vers la version
4. Pour les systèmes distribués, accédez au serveur approprié et copiez les fichiers.
- Ouvrez une invite de commande et entrez la commande suivante pour effacer le répertoire indices 4.0 par défaut :
rm -rf <répertoire_configuration_4.0>/jts/indices
rm -rf <répertoire_configuration_4.0>/ccm/indices
rm -rf <répertoire_configuration_4.0>/qm/indices
- Ouvrez une invite de commande et entrez la commande suivante pour copier les index de la version 3.0.1.x vers la version 4.0 :
cp -R <répertoire_configuration_3.0.1.x>/jts/indices <répertoire_configuration_4.0>/jts/indices
cp -R <répertoire_configuration_3.0.1.x>/ccm/indices <répertoire_configuration_4.0>/ccm/indices
cp -R <répertoire_configuration_3.0.1.x>/qm/indices <répertoire_configuration_4.0>/qm/indices
Modifiez les fichiers teamserver.properties de JTS, CCM et QM pour vous assurer que les propriétés com.ibm.team.fulltext.indexLocation et com.ibm.team.jfs.index.root.directory disposent des informations d'emplacement appropriées.
- Mettez à niveau la base de données JTS. Exécutez les outils de référentiel pour ajouter les tables de base de données 4.0 dans le référentiel JTS en modifiant et en soumettant une copie du travail BLZADDTB de l'exemple de membre SBLZSAMP version 4. La variable d'application @appl@ doit avoir pour valeur jts. Suivez les instructions fournies avec l'exemple de membre et examinez attentivement les données générées par le travail.
- Mettez à niveau la base données CCM. Si vous avez configuré l'application CCM, exécutez les outils de référentiel pour ajouter les tables de base de données 4.0 dans le référentiel CCM en modifiant et en soumettant une copie du travail BLZADDTB de l'exemple de membre SBLZSAMP version 4. La variable d'application @appl@ doit avoir pour valeur ccm.
Suivez les instructions fournies avec l'exemple de membre et examinez attentivement les données générées par le travail.
- Mettez à niveau la base de données QM. Si vous avez configuré l'application QM, exécutez les outils de référentiel pour ajouter les tables de base de données 4.0 dans le référentiel QM en modifiant et en soumettant une copie du travail BLZADDTB de l'exemple de membre SBLZSAMP version 4. La variable d'application @appl@ doit avoir pour valeur qm.
Suivez les instructions fournies avec l'exemple de membre et examinez attentivement les données générées par le travail.
- Facultatif : Configurez l'entrepôt de données. Modifiez les fichiers teamserver.properties de JTS, CCM et QM pour inclure les paramètres du référentiel de l'entrepôt de données. Les mêmes paramètres s'appliquent aux trois fichiers.
Important : Si vous ne mettez pas en oeuvre l'entrepôt de données autonome à ce stade, vous pouvez ignorer cette étape. Toutefois, si vous ignorez cette étape, vous devez ignorer l'étape de configuration de l'entrepôt de données lorsque vous utilisez l'assistant de configuration de Jazz Team Server.
Si vous configurez l'entrepôt de données maintenant, vous devez mettre à jour les fichiers teamserver.properties de JTS, CCM et QM pour inclure les paramètres de l'entrepôt de données et supprimer les propriétés de l'entrepôt de données Derby db2z existantes. Mettez les lignes en commentaire en utilisant le caractère #, comme dans l'exemple ci-dessous :
#com.ibm.team.datawarehouse.db.net.port
#com.ibm.team.datawarehouse.db.vendor=DERBY (ou derby_net)
#com.ibm.team.datawarehouse.db.jdbc.location=/répertoire_dans_répertoire_de_travail ou
#com.ibm.team.datawarehouse.db.jdbc.location=//localhost\:1527// ...
Ajoutez les informations suivantes :
com.ibm.team.datawarehouse.db.vendor = db2z
com.ibm.team.datawarehouse.db.jdbc.location=//ipAddress:ipPort/location:user=jazzDBuser;password={password};
com.ibm.team.datawarehouse.db.jdbc.password=jazzDBpswd
# Utilisateur de base de données auquel les autorisations appropriées seront octroyées
com.ibm.team.datawarehouse.report.user = RPTUSER
com.ibm.team.datawarehouse.db.db2.dsn.dbname=RIDW
- Mettez à niveau l'entrepôt de données. Si vous avez configuré l'entrepôt de données, exécutez les outils de référentiel pour mettre à niveau le référentiel de l'entrepôt de données 4.0 en modifiant et en soumettant une copie du travail BLZDWHUP de l'exemple de membre SBLZSAMP version 4. Suivez les instructions fournies avec l'exemple de membre et examinez attentivement les données générées par le travail.
- Démarrez WebSphere Application
Server.
- Déployez les fichiers war de la version 4 dans WebSphere Application
Server en effectuant les opérations suivantes :
- Connectez-vous à la console de WebSphere Application
Server Integrated Solutions à l'adresse https://example.com:9043/ibm/console/logon.jsp
- Ouvrez la page Applications d'entreprise en sélectionnant Applications > Types d'application > Applications d'entreprise WebSphere.
- Installez les fichiers .war version 4 suivants :
- jts.war
- ccm.war
- qm.war
- rm.war
- clmhelp.war
- admin.war
- Mappez les rôles de sécurité des applications de la version 4 ci-dessous en fonction des éléments que vous avez notés lors de la désinstallation effectuée à l'étape précédente :
- Démarrez les applications à partir de la console WebSphere Application
Server Integrated Solutions :
- jts_war
- ccm_war
- qm_war
- rm_war
- clmhelp_war
- admin_war
- Réinitialisez le serveur en ouvrant un navigateur et en collant les adresses URL suivantes :
https://serveur_jts.mondomaine.com:9443/jts/admin#action=com.ibm.team.repository.admin.serverReset
https://serveur_ccm.mondomaine.com:9443/ccm/admin#action=com.ibm.team.repository.admin.serverReset
https://serveur_qm.mondomaine.com:9443/qm/admin#action=com.ibm.team.repository.admin.serverReset
Remarque : Vous devez redémarrer le serveur pour appliquer sa réinitialisation.
- Activez les licences en effectuant les opérations suivantes :
- Connectez-vous en tant qu'administrateur à Jazz Team Server 4.0.x.
- Accédez à la page Server Administration> License Key Management et activez les licences.
Remarque : Vous n'avez pas besoin d'exécuter la configuration sur le système 4.0 car tout est déjà configuré.
Remarques sur les licences : - Avec les éditions intermédiaires, vous devez activer les licences d'accès anticipé fournies avec l'édition intermédiaire.
- Pour l'édition finale de la version 4.0, vous devez acquérir de nouvelles licences.
Les licences de la version 4 sont compatibles avec les applications de la version 3 mais les applications de la version 4 ne fonctionnent pas avec les licences de la version 3. Pour plus d'informations, voir Gestion des licences.
- Migrez Rational Requirements
Composer (RRC). Si vous avez configuré des applications RM, vous devez exécuter l'utilitaire de migration en ligne RM en effectuant les opérations suivantes :
- Ouvrez un navigateur, videz sa mémoire cache et accédez au client Web RM. Indiquez le nom et le numéro de port du serveur dans l'URL suivante : https://nom_serveur:port/rdm/web/projects/migration.
Le port par défaut est 9443. La page détecte qu'une migration est en cours et lance l'assistant de migration.
- Acceptez la licence Rational Requirements Composer -
Analyst Client Access.
- Cliquez sur Ouvrir le panneau du service de migration et sélectionnez l'assistant de migration pour lancer la migration de
Rational Requirements Composer.
Le statut indiquant la zone de stockage traitée et l'heure de l'opération d'indexation est communiqué à l'administrateur dans la page Web de la migration lors de l'exécution de la procédure.
Important : Une fois que la migration a commencé, vous ne pouvez
pas annuler cette opération avant qu'elle ne soit terminée.
Une fois que la migration est terminée, les données de Rational Requirements Composer sont réindexées.
- Une fois que la réindexation est terminée, l'application effectue des
contrôles de validation et de cohérence sur les données migrées et renvoie des informations à l'administrateur.
- Lorsque le message indiquant que la migration est terminée s'affiche, cliquez sur Fermer. Vous êtes ensuite redirigé vers l'application RRC.
Pour plus d'informations, voir Etapes de mise à niveau de la migration en ligne.