BPMExtractSourceInformation command-line utility

Use the BPMExtractSourceInformation command-line utility to export the service integration bus (SIB) messages and advanced IBM® BPM applications during migration. This command is only needed if you are migrating from IBM BPM Advanced or WebSphere® Process Server.

The BPMExtractSourceInformation command exports the SIB messages and advanced applications from the source deployment manager environment so that they can be imported into the target environment using the BPMMigrate command.

If you are migrating from IBM BPM Advanced or WebSphere Process Server, you must use the BPMExtractSourceInformation command to extract the SIB messages and advanced applications during migration so that you can migrate them to your new environment.

Prerequisites

The following conditions must be met:

Make sure that the deployment environment or stand-alone server is running before you run this command.
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.

Location

The BPMExtractSourceInformation command-line utility is in the install_root_V8.6.0/bin directory.

If you installed the new version of the product on a different computer and copied the migration files to the source environment, the command is found in remote_migration_utility/bin on the source computer.

If the -backupFolder parameter is set, the log file is in snapshot_folder/logs.

If the -backupFolder parameter is not set and you are using the remote migration utility, the log file is in remote_migration_utility/logs/migration.

If the -backupFolder parameter is not set and you are not using the remote migration utility, the log file is in install_root_V8.6.0/logs/migration.

Syntax

install_root_V8.6.0/bin/BPMExtractSourceInformation 
-backupFolder snapshot_folder 
-propertiesFile source_migration_properties_file

Parameters

-backupFolder

Required parameter that specifies the directory where the snapshot is stored.

-propertiesFile

Required parameter that specifies the full path to the source migration properties file with configuration information for the source and target environments.

If you installed the new version of the product on the same computer as the source environment, the sample migration properties file is found in install_root_V8.6.0/util/migration/resources/migration.properties.
If you installed the new version of the product on a different computer and copied the migration files to the source environment, the sample migration properties file is found in remote_migration_utility/util/migration/resources/migration.properties.

Check all the properties in this file and edit them if required.

-help

Optional parameter that provides the command usage.

Examples

BPMExtractSourceInformation -backupFolder /tmp/snapshot -propertiesFile /opt/BPMV8.6.0/util/migration/resources/source_migration.properties

BPMExtractSourceInformation -backupFolder c:\snapshot -propertiesFile "C:\BPM V8.6.0\util\migration\resources\source_migration.properties"