Installing the command-line tool

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.