Mettre à niveau Rational Engineering Lifecycle Manager fonctionnant avec Apache Tomcat

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 existantes 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. Arrêtez votre ancien serveur Tomcat.
  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
    Conseil : L'application Configuration Management peut aussi être installée avec Rhapsody Design Manager. Lorsque vous installez Rational Engineering Lifecycle Manager, le système propose d'installer l'application de gestion des configurations, ce qui est utile si vous voulez installer l'application sur un serveur différent de celui de 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émarrez votre serveur Apache Tomcat.
  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 Tomcat.
  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