am_upgrade script

Use this script to upgrade the Rhapsody Model Manager application.

Purpose

The am_upgrade script upgrades the Rhapsody Model Manager application version 6.0.5 to version 6.0.6.1. Although the script file is located under the upgrade/am directory, it must be run from the AM_6.0.6.1_install_dir/server directory. Also 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's parameters file, modify the default values, and run an abbreviated form of the command line.

The English and translated versions of the am_params files are located in the AM_6.0.6.1_install_dir/server/upgrade/am/params directory. Open am_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 ended by server/conf.

The script performs the following tasks:
  • Step 0: Runs the -migration_Am_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 Rhapsody Model Manager 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 AM repository database.

Parameters

Attribute Description Required Default
-oldApplicationHome Full path to the old Rhapsody Model Manager application server configuration directory. The path must not contain any spaces. In a typical installation, this path is old_CCM_install_dir/server/conf. Yes none
-applicationContextRoot The AM application context root. Must be valid directory single name without a leading slash. No am
-oldApplicationVersion The AM version that is being upgraded. By default, this is determined by running repotools -version against the old application. It should be a complete version string. For example, 6.0.5. No none
-updateTomcatFiles Whether to update the Apache Tomcat configuration files or migrate to WebSphere Liberty. Set this parameter to no if you are using WebSphere® Application Server and set it to yes if you are using Apache Tomcat. Starting in version 6.0.1, the default value has changed to no to automatically migrate Tomcat configuration files to WebSphere Liberty. No no
-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. If you are using Tomcat, this parameter will be ignored. No yes
-oldTomcatHome Full path to the Tomcat root directory in the old installation. Must be an existing directory. By default, the -oldTomcatHome parameter is derived from the -oldApplicationHome parameter value. No none
-newApplicationHome Path to the Rhapsody Model Manager application configuration directory of the 6.0.6.1 installation. No conf

For example, AM_6.0.6.1_install_dir/server/conf

-newJTSHome Path to the Jazz Team Server configuration directory of the 6.0.6.1 installation. By default, the -newJTSHome parameter value is derived from the -newApplicationHome parameter value. No none
-jtsContextRoot Context root of the 6.0.6.1 Jazz Team Server. Must be valid directory single name without a leading slash. No jts
-newApplicationTomcatHome Path to the Rhapsody Model Manager application Tomcat home directory of the 6.0.6.1 installation. By default, the -newApplicationTomcatHome parameter value is derived from the -newApplicationHome parameter value. This parameter must be provided if upgrading in Apache Tomcat and Tomcat is installed in a separate directory than CLM. No none
-newJTSTomcatHome Path to the Jazz Team Server Tomcat home directory of the 6.0.6.1 installation. By default, the -newJTSTomcatHome parameter value is derived from the -newJTSHome parameter value. No none
-noPrompt Do not prompt before creating or modifying the tables. No none
-noResumePrompt Do not prompt when resuming an upgrade step. No false
-noVerify Do not perform teamserver.properties file verification. No none
-noStepPrompt Do not prompt before executing 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, -noResumePrompt, 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

Example

For Windows operating system Open a command prompt and enter this command:

cd C:\Program Files\IBM\JazzTeamServer_6.0.6.1\Server\
upgrade\am\am_upgrade.bat -oldApplicationHome old_AM_install_dir\server\conf

For Unix operating systems Open a command line and enter this command:

cd /opt/IBM/JazzTeamServer_6.0.6.1/Server/
./upgrade/am/am_upgrade.sh -oldApplicationHome old_AM_install_dir/server/conf

Feedback