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
- 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
- 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.