Installing the command-line tool

Updated on May 11, 2022

Install the command-line tool from the productmigration.zip file, which is in the ResourceKit folder on the Pega Platform distribution media.

Copy and extract the productmigration.zip file. The extracted folder structure contains:
- logs folder: Logs of the command-line tool. The rolling file appender creates one file per day, and the latest log file has no time stamp on its name.
- productMigrationResources/lib folder: The JAR files that are required to run the tool.
- migration.properties file: The configuration file that you can use to set properties for invoking each of the available parameters.
- prlog4j2.xml file: The log4j configuration file that you can use to configure logging for the tool.
- productMigration.bat file: The Windows bat file that you can use to invoke the tool.
- productMigration.sh file: The bash script that you can use to run the tool on Linux or UNIX.
- ProductMigration-Readme.txt file: A text file that describes the available parameters.
Set the JAVA_HOME environment variable to a valid JDK 6, JDK 7 or JDK 8 directory.
Based on your environment, run the productMigration.bat or productMigration.sh file to use the actions described in the Command-line tool actions topic. You can invoke the tool by performing one of the following actions:
- Specify the parameters in the migration.properties file.
- Use the command line arguments.
- Specify some parameters in the migration.properties file and others from the command line.
Note: The command line arguments take precedence over the parameters specified in the migration.properties file.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Visit the Support Center