BPMMigrate command-line utility

The BPMMigrate command-line utility imports the migration snapshot from your previous version to your new version. The migration snapshot is taken using the BPMExtractSourceInformation command and includes the service integration bus (SIB) messages and advanced IBM® BPM applications. The BPMMigrate command is only needed if you are migrating from IBM BPM Advanced or WebSphere® Process Server.

The BPMMigrate utility is in the BPM_home_8.5/bin directory.

Syntax

BPMMigrate -backupFolder snapshot_folder -propertiesFile target_migration_properties_file

Description

If you are migrating from IBM Business Process Manager Advanced or WebSphere Process Server, the BPMMigrate utility performs the following tasks:
  • Installs your applications in the target environment.
  • Syncs the managed nodes.
  • Runs the command to move the SIB messages from the source environment to the target environment.
  • Runs the command to re-create the scheduler tasks.
  • Updates the WebSphere Adapters.

Required parameters

-backupFolder
Specifies the directory where the information that was extracted by the BPMExtractSourceInformation command is stored.
-propertiesFile
Specifies the full path to the target migration properties file in which you specified the configuration information for the target environment. The sample file is found in BPM_home/util/migration/resources/migration.properties.

You must check all the target properties in this file, and edit them if required.

Optional parameters

-help
Provides the command usage.

Examples

  • For Linux operating systemFor UNIX operating systemBPMMigrate -backupFolder /tmp/snapshot -propertiesFile /opt/BPM85/util/migration/resources/target_migration.properties
  • For Windows operating systemBPMMigrate -backupFolder C:\snapshot -propertiesFile "C:\bpm 85\util\migration\resources\target_migration.properties"

Problem determination

The log file is in snapshot_folder/logs.