BPMManageApplications command-line utility

The BPMManageApplications command is used to make sure that no new events or processes are entering the system during migration when you are migrating from IBM® BPM Advanced or WebSphere® Process Server.

When used with the -autoStart false option, this command disables the automatic starting of all applications and schedulers in the deployment environment. When used with the -autoStart true option, this command enables the automatic starting of all applications and schedulers. The command takes effect when the server restarts.

The BPMManageApplications 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 BPMManageApplications command, depending upon the task that you want to accomplish. This command is required only when you are migrating from IBM BPM Advanced or WebSphere Process Server.

To disable the automatic starting of applications and schedulers:

BPMManageApplications -autoStart false -source|-target -propertiesFile migration_properties_file

To enable the automatic starting of applications and schedulers:

BPMManageApplications -autoStart true -source|-target -propertiesFile migration_properties_file

You must restart the server after running this command.

Description

The BPMManageApplications command is used with the -autoStart false option at the following stages of migration to make sure that no new events or processes are entering the system:

Before you take a snapshot of the source environment
Before you run the migration command (BPMMigrate) in the target environment (to make sure that no new events are coming into the source databases)

The BPMManageApplications command is used with the -autoStart true option at the following stages of migration to re-enable schedulers and applications:

After you apply all configuration updates in the target environment
If migration fails, to restore the source environment

Required parameters

-autoStart false

Stops the scheduler daemon and all applications that are deployed on the server, and disables the automatic starting of all applications and schedulers in the deployment environment.

-autoStart true

Enables the automatic starting of all applications and schedulers.

-source|-target

Specifies whether the command will disable or enable the source environment or the target environment.

-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

./BPMManageApplications.sh -autoStart true -source -propertiesFile /opt/BPM85/util/migration/resources/migration.properties
BPMManageApplications.bat -autoStart false -target -propertiesFile "E:\Upgrade Utilities\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.