Repository tools command to update the Data Collection Component application configuration files

Use the migration_dcc_updateConfigurationFiles command to update migration configuration files.


The migration_dcc_updateConfigurationFiles command can be used to update configuration files from previous version to a 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 and to generate an upgrade guide, 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
oldApplicationHome Full path to the Data Collection Component home directory in the previous installation. For a typical installation, this path is OLD_DCC_INSTALL_DIR/server/conf. Yes N/A
applicationContextRoot Data Collection Component context root. Yes dcc
updateAppServerFiles By default, this option is set to yes to update the Tomcat configuration files when migrating to IBM® WebSphere® Liberty. No yes
newApplicationHome Full path to the application home directory in the new version installation. No conf
newJTSHome Path to the Jazz® Team Server configuration directory of the new version installation. By default, the newJTSHome parameter value is derived from the newApplicationHome parameter value. No none
jtsContextRoot The new version Jazz Team Server context root. No jts
ignoreJTSVersionCheck Do not attempt to verify that the application version is compatible with the Jazz Team Server version located at newJTSHome. This argument should only be used in a distributed deployment where the Jazz Team Server is on a separate system that is inaccessible from the application system. No N/A
logFile Path to the log file. No repotools-dcc_migration_dcc_updateConfigurationFiles.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 IBM WebSphere Liberty and if Apache Tomcat was installed in a different directory than default. No N/A


This is a graphical icon for Windows.
cd C:\Program Files\IBM\JazzTeamServer\server
repotools-dcc.bat -migration_dcc_updateConfigurationFiles applicationContextRoot=dcc oldApplicationHome="C:\Program Files\IBM\OLD_VERSION_DCC\server\conf"
This is a graphical icon for Linux.
cd /opt/IBM/JazzTeamServer/server
./ -migration_dcc_updateConfigurationFiles applicationContextRoot=dcc oldApplicationHome=/opt/IBM/OLD_VERSION_DCC/server/conf