Mise à niveau du serveur 3.0 avec WebSphere Application Server et DB2 for z/OS

Cette rubrique décrit les étapes à suivre pour mettre à niveau la version 3.0 de Jazz Team Server vers les applications Rational solution for Collaborative Lifecycle Management (CLM) 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 vers une configuration de la version 4.0.

Procédure

  1. 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.
  2. Arrêtez le serveur et sauvegardez les référentiels 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.
    1. 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.
    2. Utilisez l'exemple de travail BLZCREDB de la version 3.0 pour créer des tables dans les nouvelles bases de données.
    3. 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.
    4. Créez des répertoires UNIX System Services distincts (répertoire_travail_uss) pour chaque base de données.
    5. Utilisez des préfixes de schéma de référentiel dotés du même nombre de caractères.
    6. Vérifiez que les nouveaux référentiels de la version 3.0 ont été correctement créés avant de lancer la mise à niveau.
  3. 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 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 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.
  4. 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.
  5. 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.
  6. 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 :
    1. Supprimez les lignes contenant les paramètres suivants :
      oldTomcatHome
      newTomcatHome 
    2. Remplacez la ligne : updateTomcatFiles=yes par updateTomcatFiles=no
    3. 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.
    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.
  7. Désinstallez les applications 3.0 de WebSphere Application Server en effectuant les opérations suivantes :
    1. Connectez-vous à la console de WebSphere Application Server Integrated Solutions à l'adresse https://example.com:9043/ibm/console/logon.jsp
    2. Cliquez sur Applications > Types d'application > Applications d'entreprise WebSphere.
    3. Notez le mappage des rôles de sécurité des applications de la version 3.0 suivantes pour pouvoir les recréer pour les applications équivalentes de la version 4 :
      • jts_war
      • ccm_war
    4. Arrêtez et désinstallez les applications 3.0 suivantes :
      • jts_war
      • ccm_war
      • clmhelp_war
    5. Sauvegardez les modifications apportées à la configuration maître lorsque vous y êtes invité.
  8. Mettez à jour les propriétés personnalisées JAZZ_HOME et log4j.configuration en effectuant les opérations suivantes :
    1. Connectez-vous à la console de WebSphere Application Server Integrated Solutions à l'adresse https://example.com:9043/ibm/console/logon.jsp
    2. Cliquez sur Serveurs > Types de serveur > Serveurs d'applications WebSphere.
    3. Cliquez sur le nom du serveur pour l'ouvrir. Le nom du serveur par défaut est "server1."
    4. Sous Infrastructure du serveur, sélectionnez Gestion des processus et Java> Définition des processus.
    5. Sous Propriétés supplémentaires, sélectionnez Machine virtuelle Java.
    6. Sous Propriétés supplémentaires, sélectionnez Propriétés personnalisées.
    7. Sélectionnez JAZZ_HOME et mettez à jour sa valeur en indiquant file:///<répertoire_configuration_4.0>. Par exemple, file:///etc/jazz40.
    8. 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.
    9. Sauvegardez les modifications apportées à la configuration maître lorsque vous y êtes invité.
    Pour plus d'informations, voir Configuration de WebSphere Application Server.
  9. Arrêtez WebSphere Application Server.
  10. Supprimez les fichiers et les répertoires temporaires de WebSphere et effacez la mémoire cache en effectuant les opérations suivantes :
    1. 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.
    2. Accédez à <racine_profil_WAS>/temp/wscache et accédez à <application>_war, s'il existe.
  11. 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 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 :
    1. Supprimez les lignes contenant les paramètres suivants :
      oldTomcatHome
      newJTSTomcatHome 
      newApplicationTomcatHome
    2. Remplacez la ligne : updateTomcatFiles=yes par updateTomcatFiles=no
    3. Remplacez la ligne : applicationContextRoot=jazz par applicationContextRoot=ccm. Le contexte d'application doit être /ccm sauf si le serveur version 3.0 a été migré à partir de la version 2.x.
    4. 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. 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.
    5. 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.
  12. Copiez les fichiers d'index en effectuant les opérations suivantes :
    1. Copiez les index JFS/text de la version 3.0 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.0 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.
  13. 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.
  14. 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.
  15. 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 existant. 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 
  16. 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.
  17. Démarrez WebSphere Application Server.
  18. Déployez les fichiers war de la version 4 dans WebSphere Application Server en effectuant les opérations suivantes :
    1. Connectez-vous à la console de WebSphere Application Server Integrated Solutions à l'adresse https://example.com:9043/ibm/console/logon.jsp
    2. Ouvrez la page Applications d'entreprise en sélectionnant Applications > Types d'application > Applications d'entreprise WebSphere.
    3. Installez les fichiers .war version 4 suivants :
      • jts.war
      • ccm.war
      • clmhelp.war
      • admin.war
    4. 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 :
      • jts_war
      • ccm_war
  19. Démarrez les applications à partir de la console WebSphere Application Server Integrated Solutions :
    • jts_war
    • ccm_war
    • clmhelp_war
    • admin_war
  20. Réinitialisez le serveur en ouvrant un navigateur et en collant les adresses URL suivantes :
    https://jts_server.mydomain.com:9443/jts/admin#action=com.ibm.team.repository.admin.serverReset
    https://ccm_server.mydomain.com:9443/ccm/admin#action=com.ibm.team.repository.admin.serverReset
    Remarque : Vous devez redémarrer le serveur pour valider sa réinitialisation.
  21. Activez les licences en effectuant les opérations suivantes :
    1. Connectez-vous en tant qu'administrateur à Jazz Team Server 4.0.
    2. 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.
  22. 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.

Commentaires