Mise à niveau de Rational Engineering Lifecycle Manager

Pour mettre à niveau de votre version de Rational Engineering Lifecycle Manager vers la dernière version, vous allez effectuer une installation côte-à-côte de la nouvelle version.

Avant de commencer

Si vous mettez à jour des produits intégrés avec Rational Engineering Lifecycle Manager, veillez à suivre les recommandations de la rubrique Mise à niveau de la pile de produits Rational Engineering Lifecycle Manager

Procédure

  1. Installez Rational Engineering Lifecycle Manager en suivant les instructions dans Installation de Rational Engineering Lifecycle Manager et de LQE (Lifecycle Query Engine). Cela a pour effet de lancer les installations suivantes :
    • Rational Engineering Lifecycle Manager version 4.0.6
    • Jazz Team Server version 4.0.6
    • Application Configuration Management (Gestion des configurations)
    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.
  2. Si vous utilisez WebSphere Application Server, procédez comme suit.
    1. Sauvegarder le profil WebSphere Application Server. Ouvrez une invite de commande et accédez au dossier bin du répertoire d'installation de WebSphere Application Server. Par exemple, C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\bin. Exécutez la commande suivante. Notez que si la sécurité de WebSphere Application Server est activée, vous devez également fournir le nom et le mot de passe utilisateur :
      backupConfig.bat <chemin d'accès à un nouveau fichier compressé pour créer une sauvegarde de profil> <nom de l'administrateur principal de WAS> <mot de passe de l'administrateur de WAS>
      Par exemple, backupConfig.bat C:\WAS_backup\clm_40_profile.zip -username WAS admin -password WAS admin password.
    2. Désinstallez les applications existantes sur WebSphere Application Server. Pour désinstaller les fichiers WAR d'application, accédez à chaque serveur d'applications et procédez comme suit.
      1. Connectez-vous à WebSphere Application Server Integrated Solutions Console à l'adresse https://hostname:9043/ibm/console/logon.jsp.
      2. Cliquez sur Applications > Types d'applications > Applications d'entreprise WebSphere.
      3. Arrêtez et désinstallez les applications relm.war, vvc.war, lqe.war, SPARQL_Gateway.war
      4. Sauvegardez les modifications apportées à la configuration maître lorsque vous y êtes invité.
    3. Mettez à jour les propriétés personnalisées JAZZ_HOME et log4j.configuration.
      1. Connectez-vous à WebSphere Application Server Integrated Solutions Console à l'adresse https://hostname: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. Dans la section Infrastructure du serveur, cliquez sur Gestion des processus et Java > Définition de processus.
      5. Dans Propriétés supplémentaires, cliquez sur Machine virtuelle Java.
      6. Remplacez le chemin de Lifecycle Query Engine et de SPARQL Gateway par le nouvel emplacement.
      7. Recherchez la zone de texte des arguments JVM génériques et ajoutez la variable d'environnement -Dlqe.config.location=file://drive:\dossier_installation_lqe\server\conf\lqe au processus de démarrage JVM.
      8. Dans Propriétés supplémentaires cliquez sur Propriétés personnalisées.
      9. Cliquez sur JAZZ_HOME et remplacez sa valeur par file:///4.0.6_install_dir/server/conf. Par exemple, file:///C:/PROGRA~2/IBM/JazzTeamServer_4.0.6/server/conf.
      10. Cliquez sur log4j.configuration et remplacez sa valeur par file:///4.0.6_install_dir/server/conf/startup_log4j.properties. Par exemple, file:///C:/PROGRA~2/IBM/JazzTeamServer_4.0.6/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é.
    4. Arrêtez WebSphere Application Server.
    5. Nettoyez les répertoires temporaires WebSphere Application Server. Accédez à chaque serveur d'applications et supprimez le contenu associé à Rational Engineering Lifecycle Manager des répertoires wscache et temp suivants dans le profil. Selon les applications précédemment installées, les répertoires relm_war, lqe_war, sparql et vvc figurent dans le profil et peuvent être supprimés.
      WAS_profile_root\wscache (par exemple: C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\wscache)
      WAS_profile_root\temp (par exemple : C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\temp)
    6. Nettoyez le répertoire des journaux. Accédez à chaque serveur d'applications et supprimez les journaux associés à Rational Engineering Lifecycle Manager du répertoire des journaux dans le profil. Un répertoire type de journaux peut être C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\logs.
  3. Pour migrer la 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 pour DB2 pouvant être utilisé comme référence.
    1. Arrêtez l'ancien serveur Jazz Team Server.
    2. Dans DB2, recherchez les bases de données utilisées par l'installation précédente des applications JTS.
    3. Sauvegardez chaque base de données utilisée par une application JTS.
    4. Cliquez avec le bouton droit de la souris sur chaque base de données et sélectionnez Restaurer > Restauration avec création d'une nouvelle base de données.
    5. Tapez le nom de la base de données et sélectionnez le répertoire qui contient la sauvegarde.
    6. Ouvrez le fichier <rép_install_Jazz>/server/conf/jts/teamserver.properties.
    7. Remplacez le nom de la base de données Jazz par le nom que vous avez entré, comme indiqué dans l'exemple suivant.
      #
      # Configuration de DB2
      #
      
      # Mettez en commentaire les lignes ci-dessus, supprimez les mises en commentaire des trois lignes ci-dessous et personnalisez # l'exemple d'emplacement afin d'utiliser DB2
      #com.ibm.team.repository.db.vendor = DB2
      #com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:fullyMaterializeLobData=false;user=db2admin;password={password};
      #com.ibm.team.repository.db.jdbc.password=db2admin
    8. Répétez les étapes d-g pour chaque base de données à restaurer.
    9. Sauvegardez vos modifications.
  4. Mettez à niveau l'application de gestion de configuration Configuration Management à l'aide du script vvc_upgrade.bat. Ainsi, vous mettez à niveau les fichiers de configuration et les fichiers de base de données et vous régénérez les index de texte. Pour une description détaillée de la mise à niveau de l'application Configuration Management, voir le guide de mise à niveau disponible à l'adresse Guide de mise à niveau interactif pour Configuration Management. Voici un exemple de paramètres pour Linux :
    cd $newRELMHome/server/
    upgrade/vvc/vvc_upgrade.sh -oldApplicationHome oldRELMHome/server/conf
    • Si vous mettez à niveau une topologie d'installation répartie (plusieurs machines), vous devez ajouter le paramètres suivants au script vvc_upgrade : -oldApplicationHome oldRELMHome/server/conf -ignoreJTSVersionCheck.
    • Si vous utilisez WebSphere Application Server, vous devez ajouter un paramètre au script vvc_upgrade pour lui indiquer de ne pas mettre à niveau Tomcat : -oldApplicationHome oldRELMHome/server/conf -ignoreJTSVersionCheck -updateTomcatFiles=no.
    Remarque : L'application Configuration Management peut aussi être installée avec Rhapsody Design Manager. Lorsque vous installez Rational, le système vous propose d'installer l'application Configuration Management, ce qui est utile si vous voulez installer l'installation sur un ordinateur différent de Rhapsody Design Manager. Un seul de ces éléments doit être intégré à Jazz Team Server. Si vous choisissez d'installer le composant sur plusieurs ordinateurs, lors de l'installation et de la mise à niveau, veillez à sélectionner le composant correct.
  5. Mettez à niveau Rational Engineering Lifecycle Manager en exécutant relm_upgrade.sh
    $newRELMHome/server/upgrade/relm/relm_upgrade.sh -oldApplicationHome oldRELMHome/server/conf
    Cette commande exécute trois mises à niveau. La première consiste à mettre à niveau les fichiers de configuration. La seconde effectue la mise à niveau des fichiers de base de données. La troisième régénère les index de texte.
    Remarque : Vous devez définir le paramètre de version précédent dans le script relm_params avant d'exécuter le script de mise à niveau. La description de ce paramètre et des autres paramètres disponibles est disponible dans Référence pour le script relm_upgrade.
  6. Les informations de configuration de Lifecycle Query Engine et du composant SPARQL Gateway doivent être portées vers la nouvelle installation. Vous devez copier manuellement les anciennes versions vers le nouveau serveur Jazz Team Server.
    rm -rf $newRELMHome/server/conf/lqe
    cp -R $oldRELMHome/server/conf/lqe $newRELMHome/server/conf/lqe
    rm -rf $newRELMHome/server/conf/SPARQL_Gateway
    cp -R $oldRELMHome/server/conf/SPARQL_Gateway $newRELMHome/server/conf/SPARQL_Gateway
  7. Editez les propriétés SPARQL Gateway pour supprimer la propriété DBLocation. Dans le fichier suivant, supprimez la ligne DBLocation : $newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway.properties
  8. Si vous utilisez Oracle, vérifiez que le fichier Oracle ojdbc.jar (pilote JDBC) est disponible dans le répertoire suivant : $newRELMHome\JazzTeamServer\server\oracle
  9. Si vous utilisez WebSphere Application Server, déployez les fichiers relm.war, vvc.war, lqe.war et sparql_gateway.war. Redémarrez WebSphere Application Server.
  10. Démarrez le serveur Jazz Team.
  11. Ouvrez la page d'administration LQE https://server:port/lqe/web/admin. Un message indiquant que le moteur LQE est en mode de mise à niveau et est indisponible s'affiche. Cliquez sur Démarrer la mise à niveau. Une fois la mise à niveau terminée, les sources de données seront disponibles.
  12. Vérifiez qu'un fichier credentials.txt contenant la ligne suivante existe : adminUserId, adminPassword, repositoryURL, smartCard, certificateFile. S'il n'existe pas, créez-le. Par exemple, le fichier de données d'identification peut se présenter comme suit :
    adminUserId=yourAdminUserId
    adminPassword=yourAdminPassword 
    repositoryURL=https://yourserver.com:9443/vvc 
    smartCard=<none>
    certificateFile=<none>
  13. Exécutez la commande suivante à partir de votre répertoire rép_install_Configuration_Application/server
    • Linux : ./repotools-vvc.sh -migration_vvc_updateResourcesCommand credentialsFile=credentials.txt
    • Windows : repotools-vvc.bat -migration_vvc_updateResourcesCommand credentialsFile=credentials.txt

Que faire ensuite

Après avoir mis à niveau tous les logiciels nécessaires, il peut être nécessaire que Lifecycle Query Engine réindexe leur contenu. De nouveaux dictionnaires ont été ajoutés à Lifecycle Query Engine dans 4.0.3. Si vous voulez que Rational Engineering Lifecycle Manager utilise les données dans ces dictionnaires, vous devez réindexer l'application.
Tableau 1. Présentation des exigences de réindexation par produit
Produit v1.x vers v4.0.6 v4.0.3 vers v4.0.6 v4.0.4 vers v4.0.6 v4.0.5 vers v4.0.6
Rational Team Concert La réindexation est requise. La réindexation n'est pas requise. La réindexation n'est pas requise. La réindexation n'est pas requise.
Rational Quality Manager La réindexation est requise. La réindexation est recommandée. Une nouvelle propriété appelée oslc:shortld a été ajoutée à toutes les ressources QM. Si vous voulez utiliser cette propriété dans une requête, vous devez procéder à la réindexation. La réindexation n'est pas requise. La réindexation n'est pas requise.
Rhapsody Design Management La réindexation n'est pas requise, mais peut supprimer des entrées d'index en double et améliorer les performances. Réindexez si les nouvelles données doivent être utilisées dans des requêtes. La réindexation n'est pas requise. La réindexation n'est pas requise. La réindexation n'est pas requise.
Rational DOORS Réindexation vivement recommandée pour les données de production. Réindexation conseillée si vous avez créé des requêtes sur l'URI mailto. Réindexation recommandée pour les données de production. Réindexation conseillée si vous avez créé des requêtes sur l'URI mailto. La réindexation n'est pas requise. La réindexation n'est pas requise.
Rational DOORS Next Generation Non applicable Non applicable La réindexation n'est pas requise. La réindexation n'est pas requise.
Rational Engineering Lifecycle Manager La réindexation est requise. La réindexation est requise. La réindexation est requise. La réindexation est requise.
Utilisateurs TRS de Jazz Team Server (jts/trsUsers) La réindexation est requise. La réindexation n'est pas requise. La réindexation n'est pas requise. La réindexation n'est pas requise.

Commentaires