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
- Si vous mettez à jour des produits intégrés avec Rational Engineering Lifecycle Manager, suivez la séquence dans
Liste de contrôle pour la mise à niveau de la pile de produits Rational Engineering Lifecycle Manager.
- Si vous mettez à niveau à partir de la version 4.x, vous devez vous procurer de nouvelles licences pour les applications version 5.x. En effet, ces dernières ne fonctionnent pas avec les
licences des versions 4.x. Toutefois, les applications version 4.x peuvent être utilisées avec les licences des applications version 5.x. Pour plus d'informations sur les licences, voir Gestion des licences.
- Si vous effectuez une mise à niveau à partir de la version 4.x, retirez la source de données Rational Engineering Lifecycle Manager de
Lifecycle
Query Engine.
- Ouvrez la page d'administration de Lifecycle
Query Engine :
https://nom_hôte_lqe:port/lqe/web.
- Cliquez sur . Sélectionnez la source de données
Rational Engineering Lifecycle Manager.
- Dans le panneau Sources de données, cliquez sur Supprimer
puis sauvegagrdez.
Procédure
- 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.
- Configurez votre serveur application.
- Assurez-vous que votre ancien serveur est bien en cours d'exécution.
- Sauvegardez le profil WebSphere Application Server.
- Ouvrez une invite de commande et accédez au répertoire bin du répertoire d'installation de WebSphere Application Server.
- 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.
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>
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.
- Désinstallez les applications existantes sur WebSphere Application Server.
- Démarrez le serveur.
- Connectez-vous à la console de WebSphere Application Server Integrated Solutions à l'adresse
https://nom-hôte:9043/ibm/console/logon.jsp
- Cliquez sur .
- Arrêtez et désinstallez les applications suivantes : relm.war, relmhelp.war, vvc.war, lqe.war, SPARQL_Gateway.war.
- Sauvegardez les modifications apportées à la configuration maître lorsque vous y êtes invité.
- Mettez à jour les propriétés personnalisées JAZZ_HOME et log4j.configuration.
- Connectez-vous à la console de WebSphere Application Server Integrated Solutions à l'adresse
https://nom-hôte:9043/ibm/console/logon.jsp.
- Cliquez sur .
- Cliquez sur le nom du serveur pour l'ouvrir. Le serveur par défaut s'appelle server1.
- Sous Infrastructure du serveur, cliquez sur .
- Sous Propriétés supplémentaires, cliquez sur Machine virtuelle Java.
- Remplacez par le nouvel emplacement le chemin de Lifecycle
Query Engine et de
Jazz
Reporting Service.
- 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
- Sous Propriétés supplémentaires, cliquez sur Propriétés personnalisées.
- 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.
- 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.
- 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.
- Sauvegardez les modifications apportées à la configuration maître lorsque vous y êtes invité.
- Spécifiez la bibliothèque partagée Jazz
Reporting Service.
- Dans la console d'administration, accédez à .
- Dans la liste, cliquez sur Bibliothèque partagée JRS.
- 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
- 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.
- Arrêtez WebSphere Application Server.
Exécutez la commande stopServer.sh
Exécutez la commande stopServer.bat
- 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.

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)

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)
- 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 :
opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs
C:\IBM\WebSphere\AppServer\profiles\AppSrv01\logs
- Démarrez votre serveur d'applications WebSphere.
Exécutez la commande startServer.sh
Exécutez la commande startServer.bat
- Migrez ou sauvegardez votre base de données.
Assurez-vous que pilote Oracle JDBC ojdbc.jar est disponible dans le répertoire
$newRELMHome/JazzTeamServer/server/oracle.
- 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
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.
- 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
- 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
- Déployez les fichiers relm.war, relmhelp.war, vvc.war, lqe.war et SPARQL_Gateway.war.
- Dans la console d'administration de WebSphere Application Server, sélectionnez .
- Sur la page Applications d'entreprise, cliquez sur Installer.
- Dans Chemin de la nouvelle application, sélectionnez $newRELMHome/server/webapps/relm.war et cliquez sur
Ouvrir.
- Sélectionnez Raccourci et cliquez sur Suivant.
- 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.
- Un message vous indique que relm.war a été installé avec succès. Cliquez sur Sauvegarde dans la configuration principale.
- 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.
- 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.
- Mettez en place
votre serveur d'applications WebSphere
pour Lifecycle
Query Engine
et déployez le fichier lqe.war.
- 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.
- Ajoutez la référence de la bibliothèque Jazz
Reporting Service.
- Accédez à et cliquez sur
SPARQL_Gateway_war dans la liste des applications.
- Dans la section Référence, cliquez sur Références de bibliothèque partagée.
- Cochez la case en regard de SPARQL_Gateway_war et cliquez sur Bibliothèques partagées de référence.
- Sélectionnez Bibliothèque partagée JRS et cliquez sur la flèche droite.
- Cliquez sur OK. Cliquez à nouveau sur OK pour enregistrer vos modifications dans la configuration principale.
- Assurez-vous que l'ordre de chargement des classes de Jazz
Reporting Service soit correctement
configuré.
- Accédez à et cliquez sur
SPARQL_Gateway_war dans la liste des applications.
- Dans la section Propriétés détaillées, cliquez sur Chargement des classes et détection des mises à jour.
- Dans la section Ordre des chargeurs de classes, sélectionnez Classes chargées avec le chargeur de classes local en premier (parent en dernier).
- Cliquez sur OK et sur Sauvegarde dans la configuration principale.
- Redémarrez WebSphere Application Server.
- 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.
- Mettez à niveau l'application de gestion des configurations.
- 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>
- Exécutez la commande repotools-vvc depuis votre répertoire rép_install_application_configuration/server.
./repotools-vvc.sh -vvc_online_migrationCommand
credentialsFile=credentials.txt fromVersion=<version_précédente>
logPort=52000 logLevel=DEBUG
repotools-vvc.bat -vvc_online_migrationCommand
credentialsFile=credentials.txt fromVersion=<version_précédente>
logPort=52000 logLevel=DEBUG
- 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.
- Redémarrez votre serveur d'applications.
Exécutez stopServer.sh puis startServer.sh
Exécutez stopServer.bat puis startServer.bat
- 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).