Mettre à niveau Rational Engineering Lifecycle Manager fonctionnant avec WebSphere Application Server

Pour mettre à niveau Rational Engineering Lifecycle Manager, installez la nouvelle version du produit, mettez à jour les fichiers de configuration, ajoutez ou mettez à jour les tables dans les référentiels existants et faites migrer vos données vers la version 5.0.1.

Avant de commencer

Procédure

  1. Installez Rational Engineering Lifecycle Manager.
    Cette étape installe :
    • Rational Engineering Lifecycle Manager 5.0.1
    • Jazz Team Server 5.0.1
    • L'application de gestion des configurations (Configuration Management) 5.0.1
    Important :
    • Sélectionnez un groupe de packages et un répertoire différents de ceux de l'installation d'origine.
    • Sélectionnez la même racine de contexte que celle de l'installation précédente.

      Si vous effectuez une mise à niveau à partir de Rational Engineering Lifecycle Manager version 5.0 ou antérieure, votre racine de contexte Jazz Reporting Service ou SPARQL Gateway existante est SPARQL_Gateway et le nom de fichier de votre application est SPARQL_Gateway.war. Lorsque vous installez Rational Engineering Lifecycle Manager 5.0.1, sélectionnez l'option de racine de contexte personnalisée et entrez SPARQL_Gateway dans la zone Valeurs de racine de contexte d'application.

  2. Configurez votre serveur application.
    1. Assurez-vous que votre ancien serveur est bien en cours d'exécution.
    2. Sauvegardez le profil WebSphere Application Server.
      1. Ouvrez une invite de commande et accédez au répertoire bin du répertoire d'installation de WebSphere Application Server.
      2. Exécutez la commande ci-dessous. Si la sécurité de WebSphere Application Server est activée, spécifiez le nom d'utilisateur et le mot de passe.
        Conseil : Le chemin de répertoire du fichier compressé doit exister avant le démarrage du processus de sauvegarde.
        • Linux
          backupConfig.sh <Chemin_d'un_nouveau_fichier_compressé_pour_créer_une_sauvegarde_du_profil> -username <nom_de_l'administrateur_principal_WAS> -password <mot-de-passe-de-l'administrateur_WAS>
          Par exemple :
          backupConfig.sh /root/WAS_backup/relm_50_profile.zip -username <admin_WAS> -password <mot_de_passe_admin_WAS>
        • Windows
          backupConfig.bat <Chemin_d'un_nouveau_fichier_compressé_pour_créer_une_sauvegarde_du_profil> -username <nom_de_l'administrateur_principal_WAS> -password <mot-de-passe-de-l'administrateur_WAS>
          Par exemple :
          backupConfig.bat C:\WAS_backup\relm_50_profile.zip -username <admin_WAS> -password <mot_de_passe_WAS>
      La commande arrête le serveur avant de démarrer le processus de sauvegarde.
    3. Désinstallez les applications existantes sur WebSphere Application Server.
      1. Démarrez le serveur.
      2. Connectez-vous à la console de WebSphere Application Server Integrated Solutions à l'adresse https://nom-hôte:9043/ibm/console/logon.jsp
      3. Cliquez sur Applications > Types d'application > Applications d'entreprise WebSphere.
      4. Arrêtez et désinstallez les applications suivantes : relm.war, relmhelp.war, vvc.war, lqe.war, SPARQL_Gateway.war.
      5. Sauvegardez les modifications apportées à la configuration maître lorsque vous y êtes invité.
    4. Mettez à jour les propriétés personnalisées JAZZ_HOME et log4j.configuration.
      1. Connectez-vous à la console de WebSphere Application Server Integrated Solutions à l'adresse https://nom-hôte: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 serveur par défaut s'appelle server1.
      4. Sous Infrastructure du serveur, cliquez sur Gestion des processus et Java > Définition des processus.
      5. Sous Propriétés supplémentaires, cliquez sur Machine virtuelle Java.
      6. Remplacez par le nouvel emplacement le chemin de Lifecycle Query Engine et de Jazz Reporting Service.
      7. Recherchez la zone de texte Arguments JVM génériques et ajoutez cette variable d'environnement au processus de démarrage JVM :

        -Dlqe.config.location=file://drive:/répertoire-d'installation-lqe/server/conf/lqe

      8. Sous Propriétés supplémentaires, cliquez sur Propriétés personnalisées.
      9. Cliquez sur JAZZ_HOME et remplacez sa valeur par file:///<répertoire-d'installation-nouvelle-version>/server/conf.

        Par exemple, file:///C:/PROGRA~2/IBM/JazzTeamServer_5.0.1/server/conf.

      10. Cliquez sur log4j.configuration et remplacez sa valeur par file:///<répertoire-d'installation-nouvelle-version>/server/conf/startup_log4j.properties.

        Par exemple, file:///C:/PROGRA~2/IBM/JazzTeamServer_5.0.1/server/conf/startup.log4j.properties.

      11. Si vous vous connectez à une base de données Oracle, vérifiez que ORACLE_JDBC_DRIVER_FILE pointe vers le fichier de pilote JDBC correct.
      12. Sauvegardez les modifications apportées à la configuration maître lorsque vous y êtes invité.
    5. Spécifiez la bibliothèque partagée Jazz Reporting Service.
      1. Dans la console d'administration, accédez à Environnement > Bibliothèques partagées.
      2. Dans la liste, cliquez sur Bibliothèque partagée JRS.
      3. Dans le chemin d'accès aux classes, remplacez l'emplacement d'installation existant de Jazz Reporting Service par le nouveau.

        Par exemple : rép_installation_5.0.1/server/conf/SPARQL_Gateway/SharedLibrary

      4. Sous Chargement des classes, assurez-vous que l'option d'utilisation d'un chargeur de classes isolé pour la bibliothèque partagée est sélectionnée. Cliquez sur Appliquer et Sauvegarder.
    6. Arrêtez WebSphere Application Server.
      • Linux Exécutez la commande stopServer.sh
      • Windows Exécutez la commande stopServer.bat
    7. Nettoyez les répertoires temp de WebSphere Application Server.

      Supprimez le contenu associé à Rational Engineering Lifecycle Manager des répertoires wscache et temp du profil. En fonction des applications précédemment installées, les répertoires suivants peuvent figurer dans le profil et peuvent être supprimés : relm_war, lqe_war, sparql, ainsi que des données associées à l'application de gestion des configurations.

      • Linux
        racine_profil_WAS/wscache (par exemple : opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp/wscache)
        racine_profil_WAS/temp (par exemple : opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp)
      • Windows
        racine_profil_WAS\wscache (par exemple : C:\IBM\WebSphere\AppServer\profiles\AppSrv01\wscache)
        racine_profil_WAS\temp (par exemple : C:\IBM\WebSphere\AppServer\profiles\AppSrv01\temp)
    8. Nettoyez les répertoires des journaux WebSphere Application Server.
      Sur chaque serveur d'applications, supprimez les journaux concernant Rational Engineering Lifecycle Manager du répertoire des journaux dans le profil. Voici un exemple typique de répertoire des journaux :
      • Linux opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs
      • Windows C:\IBM\WebSphere\AppServer\profiles\AppSrv01\logs
    9. Démarrez votre serveur d'applications WebSphere.
      • Linux Exécutez la commande startServer.sh
      • Windows Exécutez la commande startServer.bat
  3. Migrez ou sauvegardez votre base de données.
    Option Description
    Derby Supprimez les bases de données Derby installées avec la mise à niveau et remplacez-les par les fichiers Derby de l'installation d'origine.
    rm -rf $newRELMHome/server/conf/jts/derby/repositoryDB
    rm -rf $newRELMHome/server/conf/jts/indices
    rm -rf $newRELMHome/server/conf/relm/derby/repositoryDB
    rm -rf $newRELMHome/server/conf/vvc/derby/repositoryDB
    cp -R $oldRELMHome/server/conf/jts/derby/repositoryDB $newRELMHome/server/conf/jts/derby
    cp -R $oldRELMHome/server/conf/jts/indices $newRELMHome/server/conf/jts
    cp -R $oldRELMHome/server/conf/relm/derby/repositoryDB $newRELMHome/server/conf/relm/derby
    cp -R $oldRELMHome/server/conf/relm/indices $newRELMHome/server/conf/relm
    cp -R $oldRELMHome/server/conf/vvc/derby/repositoryDB $newRELMHome/server/conf/vvc/derby
    cp -R $oldRELMHome/server/conf/vvc/indices $newRELMHome/server/conf/vvc
    DB2 ou Oracle Pour obtenir des instructions complètes, consultez la documentation fournie par le fournisseur de votre base de données.
    Voici un exemple de processus de sauvegarde de données pour DB2 pouvant être utilisé comme référence.
    1. Assurez-vous que votre ancien serveur Jazz Team Server est bien arrêté.
    2. Dans DB2, localisez les bases de données utilisées par l'installation précédente des applications Jazz Team Server.
    3. Sauvegardez chaque base de données utilisée par une application Jazz Team Server.
    4. Sauvegardez vos modifications.
    Pour plus d'informations concernant la sauvegarde et la restauration de la base de données, lisez la documentation pour la solution Rational pour la gestion collaborative du cycle de vie (en anglais).
    SQL Server

    Voici un exemple de processus de sauvegarde de données pour SQL Server pouvant être utilisé comme référence.

    • Assurez-vous de disposer du nom d'utilisateur et du mot de passe corrects.
    • Assurez-vous que vous avez sauvegardé la base de données avant de lancer la mise à niveau.
    • Assurez-vous que le pilote Java Database Connectivity (JDBC) est installé et que vous utilisez sqljdbc4.jar. En version 5.0.1, l'environnement d'exécution Java (JRE) version 5.0 n'est plus pris en charge. Seules les versions JRE 6.0 et 7.0 sont prises en charge.
    • Assurez-vous que le service SQL est démarré.
    Pour obtenir des instructions complètes, consultez la documentation fournie par le fournisseur de votre base de données.
    Oracle Assurez-vous que pilote Oracle JDBC ojdbc.jar est disponible dans le répertoire $newRELMHome/JazzTeamServer/server/oracle.
  4. Mettez à niveau l'application de gestion des configurations.

    Exécutez le script vvc_upgrade pour mettre à niveau les fichiers de configuration et les fichiers de base de données et pour reconstruire les index texte.

    Voici un exemple de paramètres :
    cd $newRELMHome/server/
    upgrade/vvc/vvc_upgrade.sh -oldApplicationHome oldRELMHome/server/conf
    • Si vous mettez à niveau une topologie d'installation répartie (plusieurs serveurs), utilisez le paramètre suivant avec le script vvc_upgrade :
      -oldApplicationHome oldRELMHome/server/conf -ignoreJTSVersionCheck
    • Pour ignorer la mise à niveau de Tomcat, ajoutez le paramètre suivant au script vvc_upgrade :
      -oldApplicationHome oldRELMHome/server/conf -ignoreJTSVersionCheck -updateTomcatFiles=no
    Conseil : L'application Configuration Management peut aussi être installée avec Rhapsody Design Manager. Lorsque vous installez Rational Engineering Lifecycle Manager, sélectionnez l'application de gestion des configurations si vous voulez installer ce composant sur une autre machine que celle qui héberge votre système Rhapsody Design Manager. Une seule application de gestion des configurations doit être intégrée avec Rational Engineering Lifecycle Manager. Si vous choisissez d'installer le composant sur plusieurs serveurs, veillez à sélectionner le bon composant lors de l'installation et de la mise à niveau.
  5. Mettez à niveau Rational Engineering Lifecycle Manager.
    Exécutez la commande relm_upgrade.sh pour mettre à niveau les fichiers de configuration et les fichiers de base de données et pour reconstruire les index texte.
    $newRELMHome/server/upgrade/relm/relm_upgrade.sh -oldApplicationHome
    oldRELMHome/server/conf
  6. Portez les informations de configuration de Lifecycle Query Engine ainsi que les informations de configuration existantes de Jazz Reporting Service ou de SPARQL Gateway dans la nouvelle version du produit.
    Copiez le contenu du répertoire SPARQL_Gateway de l'ancienne installation dans le répertoire SPARQL_Gateway.
    cp -R $oldRELMHome/server/conf/SPARQL_Gateway/* $newRELMHome/server/conf/SPARQL_Gateway
    Si vous effectuez une mise à niveau depuis la version 5.0 vers la version 5.0.1, passez à l'étape 7.
    Si vous effectuez une mise à niveau depuis la version 4.x vers la version 5.0.1, utilisez un éditeur de texte pour ajouter les propriétés suivantes au fichier $newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway.properties.
    • support.query.editing=false
    • support.db.derby=false
    • support.dwse=false
    • query.results.limit=3000
    • query.results.cache.timeout=300
    • user.account.cache.timeout=480
    Supprimez app.properties de SPARQL_Gateway
    rm $newRELMHome/server/conf/SPARQL_Gateway/app.properties
    Renommez SPARQL_Gateway.properties en app.properties.
    mv $newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway.properties $newRELMHome/server/conf/SPARQL_Gateway/app.properties
    Renommez SPARQL_Gateway_runtime.properties en app_runtime.properties. (Par défaut, le fichier SPARQL_Gateway_runtime.properties n'existe pas, mais vous pouvez le créer si vous avez besoin de configurer le paramètre de délai de connexion.)
    mv $newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway_runtime.properties $newRELMHome/server/conf/SPARQL_Gateway/app_runtime.properties
  7. Déployez les fichiers relm.war, relmhelp.war, vvc.war, lqe.war et SPARQL_Gateway.war.
    1. Dans la console d'administration de WebSphere Application Server, sélectionnez Applications > Types d'application > Applications d'entreprise WebSphere.
    2. Sur la page Applications d'entreprise, cliquez sur Installer.
    3. Dans Chemin de la nouvelle application, sélectionnez $newRELMHome/server/webapps/relm.war et cliquez sur Ouvrir.
    4. Sélectionnez Raccourci et cliquez sur Suivant.
    5. Acceptez les valeurs par défaut et cliquez sur Suivant dans l'assistant de configuration. Sur la page Mappage des racines de contexte des modules Web, entrez la racine de contexte /relm. Cliquez ensuite sur Terminer.
    6. Un message vous indique que relm.war a été installé avec succès. Cliquez sur Sauvegarde dans la configuration principale.
    7. Installez la documentation de Rational Engineering Lifecycle Manager, relmhelp.war. Utilisez les étapes a à f ci-dessus. Utilisez $newRELMHome/server/webapps/relmhelp.war comme chemin, et /relmhelp comme racine de contexte.
    8. Installez l'application Configuration Management, vvc.war. Utilisez les étapes a à f ci-dessus. Utilisez $newRELMHome/server/webapps/vvc.war comme chemin, et /vvc comme racine de contexte.
    9. Mettez en place votre serveur d'applications WebSphere pour Lifecycle Query Engine et déployez le fichier lqe.war.
    10. Installez l'application Jazz Reporting Service, SPARQL_Gateway.war. Utilisez les étapes a à f ci-dessus. Utilisez $newRELMHome/server/webapps/SPARQL_Gateway.war comme chemin, et SPARQL_Gateway comme racine de contexte.
    11. Ajoutez la référence de la bibliothèque Jazz Reporting Service.
      1. Accédez à Applications > Types d'applications > Applications d'entreprise WebSphere et cliquez sur SPARQL_Gateway_war dans la liste des applications.
      2. Dans la section Référence, cliquez sur Références de bibliothèque partagée.
      3. Cochez la case en regard de SPARQL_Gateway_war et cliquez sur Bibliothèques partagées de référence.
      4. Sélectionnez Bibliothèque partagée JRS et cliquez sur la flèche droite.
      5. Cliquez sur OK. Cliquez à nouveau sur OK pour enregistrer vos modifications dans la configuration principale.
    12. Assurez-vous que l'ordre de chargement des classes de Jazz Reporting Service soit correctement configuré.
      1. Accédez à Applications > Types d'applications > Applications d'entreprise WebSphere et cliquez sur SPARQL_Gateway_war dans la liste des applications.
      2. Dans la section Propriétés détaillées, cliquez sur Chargement des classes et détection des mises à jour.
      3. Dans la section Ordre des chargeurs de classes, sélectionnez Classes chargées avec le chargeur de classes local en premier (parent en dernier).
      4. Cliquez sur OK et sur Sauvegarde dans la configuration principale.
    13. Redémarrez WebSphere Application Server.
  8. Si vous effectuez une mise à niveau à partir de la version 4.x, mettez à niveau Lifecycle Query Engine.

    Ouvrez la page d'administration de Lifecycle Query Engine : https://nom_hôte_relm:port/lqe/web/admin. Un message vous indique que la mise à niveau de Lifecycle Query Engine est en cours et que l'application est indisponible. Cliquez sur Démarrer la mise à niveau. Une fois le processus de mise à niveau terminé, les sources de données sont disponibles.

  9. Mettez à niveau l'application de gestion des configurations.
    1. Vérifiez qu'un fichier credentials.txt contenant les éléments suivants existe : adminUserId, adminPassword, repositoryURL, smartCard, certificateFile .

      Si le fichier n'existe pas, créez-le. En voici un exemple :

      adminUserId=yourAdminUserId
      adminPassword=yourAdminPassword 
      repositoryURL=https://yourserver.com:9443/vvc 
      smartCard=<none>
      certificateFile=<none>
    2. Exécutez la commande repotools-vvc depuis votre répertoire rép_install_application_configuration/server.
      • Linux./repotools-vvc.sh -vvc_online_migrationCommand credentialsFile=credentials.txt fromVersion=<version_précédente> logPort=52000 logLevel=DEBUG
      • Windowsrepotools-vvc.bat -vvc_online_migrationCommand credentialsFile=credentials.txt fromVersion=<version_précédente> logPort=52000 logLevel=DEBUG
    3. Redémarrez Jazz Team Server.
    La commande repotools de l'application Configuration Management envoie une demande à l'application Configuration Management en cours d'exécution et attend une réponse. Si la commande repotools-vvc s'arrête immédiatement suite à une erreur d'autorisation, vérifiez que le serveur est en cours d'exécution et que l'ID et le mot de passe utilisateur figurant dans le fichier de données d'identification sont corrects.
  10. Redémarrez votre serveur d'applications.
    • Linux Exécutez stopServer.sh puis startServer.sh
    • Windows Exécutez stopServer.bat puis startServer.bat
  11. Redémarrez votre serveur Rational Engineering Lifecycle Manager afin que les données qui ont migré soient automatiquement mises au format requis dans la nouvelle version d'application. Ce processus est appelé mise à niveau en ligne. Connectez-vous si vous voulez voir la page d'état de la mise à niveau.

Résultats

Une fois la mise à niveau en ligne réussie, le navigateur web est actualisé et affiche la page d'accueil de Rational Engineering Lifecycle Manager. En cas d'échec d'une étape de mise à niveau, examinez le fichier relm.log pour en déterminer la cause. Si de nombreux produits sont définis dans Rational Engineering Lifecycle Manager, l'exécution de la mise à niveau en ligne prend un certain temps (plusieurs heures).

Que faire ensuite


Commentaires