BPMMigrate command-line utility

Use the BPMMigrate command-line utility to import 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.

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

Prerequisites

The following conditions must be met:

The user name and password are taken from the migration.properties file. The user name must have various WebSphere privileges. The WebSphere primary administrative user has them all. In the source environment, you can find the primary administrative user name in the administrative console by going to Users and Groups > Administrative user roles. In the target environment, if you do not have access to the administrative console, you can find bpm.de.authenticationAlias.#.name=CellAdminAlias in the BPMConfig properties file. Use the user name and password for that alias.

Location

The BPMMigrate command-line utility is in the install_root_8.5/bin directory.

The log file is in snapshot_folder/logs.

Syntax

BPMMigrate 
-backupFolder snapshot_folder 
-propertiesFile target_migration_properties_file

Parameters

-backupFolder: Required parameter that specifies the directory where the information that was extracted by the BPMExtractSourceInformation command is stored.
-propertiesFile: Required parameter that 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 install_root/util/migration/resources/migration.properties.
You must check all the target properties in this file and edit them if required.
-help: Optional parameter that provides the command usage.

Examples

BPMMigrate -backupFolder /tmp/snapshot -propertiesFile /opt/BPM85/util/migration/resources/target_migration.properties

BPMMigrate -backupFolder C:\snapshot -propertiesFile "C:\bpm 85\util\migration\resources\target_migration.properties"