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.

   The command line arguments take precedence over the parameters specified in the migration.properties file.

Open topic with navigation