relm_upgrade script

Use the relm_upgrade script to update your IBM® Engineering Lifecycle Optimization - Engineering Insights version.

Purpose

The relm_upgrade script upgrades all releases of Engineering Insights (ENI) version 6 and later to version 7.0. Although the script file is located under the upgrade/relm directory, it must be run from the RELM_7.0_install_dir/server directory. If your path contains spaces, ensure that you enclose the path name in double quotation marks. Enter [E] to execute the command, [S] to skip a step, or hit [Enter] to cancel the script execution.

As an alternative to running the script and all its command-line arguments, you can open the script parameters file, modify the default values, and run an abbreviated form of the script.

The English and translated versions of the relm_params files are in the RELM_7.0_install_dir/server/upgrade/relm/params directory. Open relm_params or a translated version of it for editing and specify values for each parameter. One of the parameters that must be set is the path to the OLD_APPLICATION_HOME directory. This must be an existing directory that is ended by server/conf.

The script performs the following steps:
  • Step 0: Runs the -migration_relm_updateConfigurationFiles command that updates the server configuration files. After the configuration files are merged successfully, enter [C] to continue. An editor opens in which you can verify the Jazz™ Team Server and the Engineering Insights application teamserver.properties files. Verify that the Public URI root denoted by the com.ibm.team.repository.server.webapp.url property is correct. Also verify that the database properties are correct. When done, save your changes, if any, and close the editor to continue the script execution.
  • Step 1: Adds tables to the ENI repository database.

Parameters

Attribute Description Required Default
oldApplicationHome Full path to the old Engineering Insights configuration directory. The path must not contain any spaces. In a typical installation, this path is old_RELM_install_dir/server/conf. Yes none
applicationContextRoot Engineering Insights context root. No relm
oldApplicationVersion The Engineering Insights version that is being upgraded. No By default, the version of the Rational® Engineering Lifecycle Manager to be upgraded is detected automatically.
newApplicationHome Path to the Engineering Insights application configuration directory of the 7.0 installation. No RELM_7.0_install_dir/server/conf
updateAppServerFiles By default, this option is set to yes to update the Tomcat configuration files when migrating to Liberty. Set this parameter to no if you are using WebSphere® Application Server. No yes
newJTSHome Path to the Jazz Team Server configuration directory of the 7.0 installation. By default, the newJTSHome parameter value is derived from the newApplicationHome parameter value. No none
jtsContextRoot Context root of the 7.0 Jazz Team Server. No jts
noPrompt Do not prompt before you create or modify the tables. No none
noVerify Do not perform teamserver.properties file verification. No none
overwrite Whether to overwrite any existing file. No no
noStepPrompt Do not prompt before you execute a step. No false
noEditor The -noEditor parameter eliminates opening an editor during the execution of the upgrade script to review or modify the teamserver.properties file. The -noEditor parameter in conjunction with -noStepPrompt, -noVerify, and -noPrompt parameters can be used for a fully automated upgrade script without any user interactions. If you need to review or modify the teamserver.properties file during the upgrade, such as in a WebSphere Application Server environment where the index location might be relative to the profile directory, do not use this parameter. No false
Windows:
cd C:\Program Files\IBM\JazzTeamServer_7.0\Server\
upgrade\relm\relm_upgrade.bat -oldApplicationHome old_RELM_install_dir\server\conf
Linux:
cd /opt/IBM/JazzTeamServer_7.0/Server/
./upgrade/relm/relm_upgrade.sh -oldApplicationHome old_RELM_install_dir/server/conf

video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki