Repository tools command to update the Jazz Team Server configuration files

Use the migration_jts_updateConfigurationFiles command to update migration configuration files.


The migration_jts_updateConfigurationFiles command can be used to update configuration files from a previous version to new version. This command is used in an environment where the upgrade wrapper script cannot be used. The upgrade wrapper script includes this command and automates some of the manual steps. For information about the upgrade process, see Interactive upgrade guide.
Important: You must shut down the server before you run the command. Also if your paths contain spaces, ensure you enclose them in double quotation marks.


Attribute Description Required Default
oldJTSHome Full path to the Jazz™ Team Server configuration directory in the old installation. For a typical installation, this path is JTS_installation/server/conf. Yes N/A
jtsContextRoot Jazz Team Server context root. No jts
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 new installation. No conf
logFile Path to the log file. No repotools-jts_jts_updateConfogurationFiles.log
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. This parameter must be provided for migrating from Apache Tomcat to WebSphere Liberty and if Apache Tomcat was installed in a different directory than default. No N/A


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

cd C:\Program Files\IBM\JazzTeamServer\server\
repotools-jts.bat -migration_jts_updateConfigurationFiles oldJTSHome="C:\Program Files\IBM\OLD_VERSION_JTS\server\conf"

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

cd opt/IBM/JazzTeamServer/server/
./ -migration_jts_updateConfigurationFiles oldApplicationHome=opt/IBM/OLD_VERSION_JTS/server/conf

video icon Video channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community forums library

support icon Support

IBM Support Community
Deployment wiki