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
- 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.
- Arrêtez votre ancien serveur Tomcat.
- 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,
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.
- 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émarrez votre serveur Apache Tomcat.
- 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 Tomcat.
- 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).