BPMExtractSourceInformation command-line utility

The BPMExtractSourceInformation command is used to check for migration readiness and to take a snapshot of the source environment during migration.

When used with the -precheck option, this command makes sure that your source environment is in the correct state for migration. This check is necessary only if you are migrating from IBM® BPM Advanced or WebSphere® Process Server.

When used with the -backupFolder option, this command extracts the configuration information, customizations, performance options, applications, LTPA keys, and service integration bus (SIB) messages from the source deployment manager environment.

The BPMExtractSourceInformation command is in the BPM_home_8.5/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 file is found in remote_migration_utility/bin on the source computer.

Syntax

There are two ways to run the BPMExtractSourceInformation command, depending upon the task that you want to accomplish.

To check that the source environment is in the correct state for migration (for migrating from IBM BPM Advanced or WebSphere Process Server):

BPM_home_8.5/bin/BPMExtractSourceInformation -precheck -propertiesFile migration_properties_file

To take a snapshot of the source environment:

BPM_home_8.5/bin/BPMExtractSourceInformation -backupFolder snapshot_folder -propertiesFile migration_properties_file

Description

The BPMExtractSourceInformation command must be used with the -precheck option before migrating from IBM BPM Advanced or WebSphere Process Server. This command performs the following checks:

Whether any existing SIB message is in a transaction
Whether too many SIB messages are stuck in a queue
Whether any failed events are not processed

The BPMExtractSourceInformation command is used to take a snapshot of the source environment before migration. This command extracts the configuration information, customizations, performance options, applications, LTPA keys, and service integration bus (SIB) messages so that you can apply the same changes to your new environment.

Required parameters

-propertiesFile

Specifies the full path to the migration properties file in which you specify the 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 file is found in BPM_home_8.5/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 file is found in remote_migration_utility/util/migration/resources/migration.properties.

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

Optional parameters

-precheck: Checks for migration readiness.
-backupFolder: Specifies the directory where the snapshot will be stored.
-help: Provides the command usage.

Examples

BPMExtractSourceInformation -precheck -propertiesFile /opt/BPM85/util/migration/resources/migration.properties
BPMExtractSourceInformation -backupFolder /tmp/snapshot -propertiesFile /opt/BPM85/util/migration/resources/migration.properties
BPMExtractSourceInformation -precheck -propertiesFile "C:\bpm 85\util\migration\resources\migration.properties"
BPMExtractSourceInformation -backupFolder c:\snapshot -propertiesFile "C:\bpm 85\util\migration\resources\migration.properties"

Problem determination

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 BPM_home_8.5/logs/migration.