Skip to main content

Installing the command-line tool

Suggest edit
Updated on August 25, 2021

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

  1. 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.
  2. Set the JAVA_HOME environment variable to a valid JDK 6, JDK 7 or JDK 8 directory.
  3. 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.
  • Previous topic Migrating products and applications from the command line
  • Next topic Configuring the source and target systems
Did you find this content helpful? YesNo

Have a question? Get answers now.

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

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us