BPMExtractSourceInformation command-line utility

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

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, 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_V19.0.0.3/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_V19.0.0.3/logs/migration.

Syntax

install_root_V19.0.0.3/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_V19.0.0.3/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

  • For UNIX operating systemFor Linux operating system 
    BPMExtractSourceInformation -backupFolder /tmp/snapshot -propertiesFile /opt/BPMV19.0.0.3/util/migration/resources/source_migration.properties
  • For Windows operating system 
    BPMExtractSourceInformation -backupFolder c:\snapshot -propertiesFile "C:\BPM V19.0.0.3\util\migration\resources\source_migration.properties"