Repository tools command to migrate Lifecycle Project Administration

Use the mergeLPAJTS command to migrate the Lifecycle Project Administration storage areas, indexes, and registration during an upgrade.

Purpose

Before version 5.0.2, Lifecycle Project Administration was a separate application. In version 5.0.2, the application became part of Jazz® Team Server. As a result, if you upgrade from a previous release to version 5.0.2 or later, you must run the mergeLPAJTS command to migrate the Lifecycle Project Administration storage areas, indexes, and registration. Note that this command is part of the upgrade wrapper script and is entered automatically during the upgrade. However, if you manually upgrade your server by running each repotools command separately, you must also run the mergeLPAJTS command. See the Interactive Upgrade Guide for details.

Parameters

Attribute Description Required Default
oldJTSHome Full path to the Jazz Team Server configuration directory of the previous installation. In a typical installation, this path is JTS_Install_Dir/server/conf. Yes  
oldJTSVersion The version of Jazz Team Server being upgraded. To determine the version number you can run the repotools-jts -version command against the old server. No none
lpaContextRoot The context root of the Lifecycle Project Administration application. No admin
teamserver.properties Path to the teamserver.properties file. No conf/jts/teamserver.properties
newJTSHome Full path to the Jazz Team Server configuration directory of the new installation. No conf
jtsContextRoot Jazz Team Server context root. No jts
applicationContextRoot The Requirements Management context root. No rm
oldApplicationHome Full path to the Requirements Management application configuration directory of the previous installation. In a typical installation, this path is RM_Install_Dir/server/conf. No none
oldapplicationVersion The version of the Requirements Management application being upgraded. To determine the version number you can run the repotools-rm -version command against the old server. No none
onlyRemoveFriend Unregister the old LPA application friend entry in the current repository. This command is only used for the Requirements Management application. No false

Example

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

cd C:\Program Files\IBM\JazzTeamServer\server\
repotools-jts.bat -mergeLPAJTS oldJTSHome=old_JTS_Install_Dir\server\conf

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

cd /opt/IBM/JazzTeamServer/server/
./repotools-jts.sh -mergeLPAJTS oldJTSHome=old_JTS_Install_Dir/server/conf