Référence pour le script relm_upgrade

Le script relm_upgrade est utilisé lors de la mise à jour depuis une ancienne version de Rational Engineering Lifecycle Manager.

Objet

Le processus de mise à niveau complet de Rational Engineering Lifecycle Manager est décrit dans Mise à niveau de Rational Engineering Lifecycle Manager. Il se peut que vous deviez modifier les paramètres dans le script de mise à niveau si vous utilisez des valeurs autres que celles par défaut.

Le script relm_upgrade met à niveau Rational Engineering Lifecycle Manager 1.0, 1.0.0.1, 4.0.3 ou 4.0.4 vers 4.0.6. Bien que le fichier de script se trouve dans le répertoire upgrade/relm, il doit être exécuté depuis le répertoire rép_install_RELM_4.0.6/server. De plus, si votre chemin d'accès comporte des espaces, prenez soin de l'encadrer avec des guillemets.

Au lieu d'exécuter le script et tous ses arguments de ligne de commande, vous pouvez ouvrir le fichier des paramètres du script, modifier les valeurs par défaut et exécuter une forme abrégée de la ligne de commande.

La version anglaise et les versions traduites des fichiers relm_params se trouvent dans le répertoire rép_install_RELM_4.0.6/server/upgrade/relm/params. Ouvrez relm_params ou une version traduite du fichier pour l'éditer, et spécifiez des valeurs pour chaque paramètre. L'un des paramètres devant être définis est le chemin d'accès au répertoire OLD_APPLICATION_HOME. Il doit s'agir d'un répertoire existant qui se termine par server/conf.

Le script effectue les tâches suivantes :
  • Il exécute la commande -migration_relm_updateConfigurationFiles qui met à jour les fichiers de configuration et Tomcat (si updateTomcatFiles n'a pas pour valeur No). Entrez [E] pour exécuter la commande, [S] pour ignorer cette étape ou appuyez sur la touche [Entrée] pour annuler l'exécution du script.
  • Il met à jour les fichiers teamserver.properties en fonction des informations de la version précédente. Une fois que la fusion des fichiers de configuration a réussi, entrez [C] pour continuer. Un éditeur dans lequel vous pouvez vérifier le fichier teamserver.properties de l'application Change and Configuration Management s'ouvre. Vérifiez que la racine d'URI public dénotée par la propriété com.ibm.team.repository.server.webapp.url est correcte. Vérifiez également que les propriétés de base de données sont correctes. Après quoi, enregistrez vos modifications (le cas échéant) et refermez l'éditeur pour poursuivre l'exécution du script.
  • Dans un environnement Tomcat, il fusionne le contenu des fichiers server.xml et web.xml avec la nouvelle version et copie le fichier tomcat-users.xml de l'ancienne version.
  • Il ajoute des tables à la base de données de référentiel Rational Engineering Lifecycle Manager.

Paramètres

Attribut Description Requis Valeur par défaut
oldApplicationHome Chemin d'accès complet à l'ancien répertoire de configuration de Rational Engineering Lifecycle Manager. Ce chemin ne doit contenir aucun espace. Dans une installation classique, il s'agit de ancien_rép_install_relm/server/conf. Oui Aucune
applicationContextRoot Racine de contexte Rational Engineering Lifecycle Manager. Non relm
oldApplicationVersion Version de Rational Engineering Lifecycle Manager mise à niveau. Non 4.0.4
newApplicationHome Chemin vers le répertoire de configuration de l'application Rational Engineering Lifecycle Manager de l'installation 4.0.6. Non rép_installation_relm_4.0.6/server/conf
updateTomcatFiles Nécessité de mettre à jour les fichiers de configuration Tomcat. Associez cette valeur à "no" si vous utilisez WebSphere Application Server. Non yes
oldApplicationTomcatHome Chemin d'accès complet au répertoire de base Tomcat dans l'installation de la version précédente. Par défaut, la valeur du paramètre oldTomcatHome est dérivée de celle du paramètre oldApplicationHome. Non Aucune
newApplicationTomcatHome Chemin vers le répertoire de base Tomcat de l'application Rational Engineering Lifecycle Manager de l'installation 4.0.6. Par défaut, la valeur du paramètre newApplicationTomcatHome est dérivée de celle du paramètre newApplicationHome. Non Aucune
newJTSHome Chemin du répertoire de configuration de Jazz Team Server de l'installation 4.0.6. Par défaut, la valeur du paramètre newJTSHome est dérivée de celle du paramètre newApplicationHome. Non Aucune
jtsContextRoot Racine de contexte de Jazz Team Server 4.0.6. Non jts
noPrompt Ne pas demander confirmation avant la création ou la modification des tables. Non Aucune
noVerify Indique de ne pas vérifier le fichier teamserver.properties. Non Aucune
overwrite Indique s'il convient d'écraser un fichier existant. Non no
noStepPrompt Ne pas demander confirmation avant d'exécuter une étape. Non Aucune
Windows :
cd C:\Program Files\IBM\JazzTeamServer\Server\
upgrade\relm\relm_upgrade.bat -oldApplicationHome ancien_rép_install_relm\server\conf
Linux :
cd opt/IBM/JazzTeamServer/Server/
./upgrade/relm/relm_upgrade.sh -oldApplicationHome ancien_rép_install_relm/server/conf

Commentaires