BPMExtractDBConfiguration command-line utility

The BPMExtractDBConfiguration command extracts the data source information from the migration source environment, which is the previously deployed version. You can then use this data source information when you create a deployment environment for a new version of IBM® Business Process Manager that will use the databases from the previous version.

If you configured any additional data sources in the previous version, they will be extracted also, which can help you create these data sources again in the new version.

The BPMExtractDBConfiguration command is in the BPM_home_8.5/bin directory.

Syntax

BPMExtractDBConfiguration -output output_properties_file -propertiesFile migration_properties_file

Description

The BPMExtractDBConfiguration command is used during migration to capture the configuration information from the databases in the source environment. This information can then be used when you create the new deployment environment, which can point to the existing databases.

Required parameters

-output

Specifies the file name, including the full path, for the database configuration information. The properties are extracted into this file as name-value pairs. Make sure that the file does not already exist.

Tip: If you are running this command more than once because you have more than one deployment environment, remember to specify different output file names.

-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

-help: Provides the command usage.

Examples

BPMExtractDBConfiguration -output /tmp/db_config -propertiesFile /tmp/remoteUtil/util/migration/resources/migration.properties
BPMExtractDBConfiguration -output /tmp/db_config -propertiesFile "C:\bpm 85\util\migration\resources\migration.properties"

Problem determination

If you use the remote migration utility to run the command in the source environment, the log file is in remote_migration_utility/logs/migration.

Otherwise, the log file is in BPM_home_8.5/logs/migration in the target environment.