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.