Cette rubrique décrit les étapes à suivre pour mettre à niveau le serveur Rational Team
Concert (RTC)
version 3.0 vers les applications Rational solution for Collaborative Lifecycle Management (CLM) version 4 avec une configuration qui utilise un serveur d'applications Tomcat 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 RTC version
3.0 vers une configuration de CLM 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. 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 vers la version 4.
- Sauvegardez les référentiels de la version 3.0 à l'aide des utilitaires UNLOAD et LOAD de DB2 for z/OS. Pour plus de détails, voir 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 pour créer des tables dans les nouvelles 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.
- 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 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 afin de 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 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.
- Créez une base de données DB2 for z/OS appelée RIDW à utiliser en tant qu'entrepôt de données et accordez les droits nécessaires. Pour plus de détails, voir Configuration de DB2 for z/OS pour une utilisation avec Jazz Team Server.
- Déployez les applications en démarrant et en arrêtant le serveur Tomcat version 4 (ou déployez les fichiers ccm.war et jts.war).
Remarque : Si les fichiers web.xml des applications version 3.0 ont été personnalisés (par exemple pour prendre en charge un registre LDAP), les étapes restantes les migrent vers les applications version 4 et modifient le fichier web.xml dans chacune des applications. Toutefois, les fichiers.war sont signés. Cela signifie que des modifications ne peuvent être apportées qu'à la version déployée du fichier .war. Si les applications sont redéployées après la migration, les fichiers de la version 3.0 doivent être une nouvelle fois personnalisés manuellement.
- 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 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 :
- 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 :
- Remplacez la ligne : applicationContextRoot=jazz par applicationContextRoot=ccm.
Le contexte d'application doit être /ccm sauf si le serveur version 3 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.
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.
- Arrêtez le serveur Tomcat version 3 RTC.
- Copiez les fichiers d'index en effectuant les opérations suivantes :
- Copiez les index JFS/text de la version 3 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
Ouvrez une invite de commande et entrez la commande suivante pour copier les index de la version 3 vers la version 4.0 :cp -R <répertoire_configuration_3.0>/jts/indices <répertoire_configuration_4.0>/jts/indices
cp -R <répertoire_configuration_3.0>/ccm/indices <répertoire_configuration_4.0>/ccm/indices
Modifiez les fichiers teamserver.properties de JTS et CCM 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.
- Facultatif : Configurez l'entrepôt de données. Modifiez les fichiers teamserver.properties de JTS et CCM 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 et CCM pour inclure les paramètres de l'entrepôt de données db2z et supprimer les propriétés de l'entrepôt de données Derby 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
- Si vous avez mis à jour le fichier teamserver.properties pour l'entrepôt de données, créez un référentiel de l'entrepôt de données en modifiant et en soumettant le travail BLZCREDB de l'exemple de membre SBLZSAMP version 4 pour créer les tables de l'entrepôt de données. Associez la variable d'application @appl@ à la valeur jts.
La commande des outils de référentiel @repotoolsCommand@ est -createWarehouse.
- Démarrez les serveurs Tomcat version 4 en modifiant et en soumettant le travail BLZSRVD de l'exemple SBLZSAMP version 4. Vérifiez que la variable du répertoire de configuration @confPath@ et la variable du répertoire de travail @workPath@ possèdent les nouvelles valeurs du répertoire de la version 4.
- Activez les licences en effectuant les opérations suivantes :
- Connectez-vous en tant qu'administrateur à Jazz Team Server 4.0.
- 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.
- Si vous souhaitez ajouter les applications QM (Quality Management) ou RM (Requirements
Management), suivez les instructions pour les nouvelles installations.
Pour plus d'informations, voir Installation et configuration de Jazz Team Server et de la solution Rational pour des applications Collaborative Lifecycle Management sous z/OS.