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 Business Automation Workflow applications. The BPMMigrate command is only needed if you are migrating from IBM® BPM Advanced.
If you are migrating from IBM Business Process Manager
Advanced, 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
bpm.de.authenticationAlias.#.name=CellAdminAlias
in the BPMConfig properties file. Use the user name and password for that alias.
. In
the target environment, if you do not have access to the administrative
console, you can find
Location
The BPMMigrate command-line utility is in the
install_root_V19.0.0.3
/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/BPMV19.0.0.3/util/migration/resources/target_migration.properties
-
BPMMigrate -backupFolder C:\snapshot -propertiesFile "C:\BPM V19.0.0.3\util\migration\resources\target_migration.properties"