BPMManageApplications command-line utility

Use the BPMManageApplications command-line utility to make sure that no new events or processes are entering the system during migration when you are migrating from IBM® BPM Advanced.

The BPMManageApplications command-line utility 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)
When used with the -autoStart false option, this command disables the automatic starting of all applications and schedulers in the deployment environment.
The BPMManageApplications command-line utility 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
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.

Prerequisites

The following conditions must be met:
  • 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. In the target environment, if you do not have access to the administrative console, you can find bpm.de.authenticationAlias.#.name=CellAdminAlias in the BPMConfig properties file. Use the user name and password for that alias.

Location

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

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 install_root_V19.0.0.3/logs/migration in the target environment.

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

Parameters

-autoStart false
Required parameter that 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
Required parameter that enables the automatic starting of all applications and schedulers.
-source|-target
Required parameter that specifies whether the command will disable or enable the source environment or the target environment.
-propertiesFile
Required parameter that specifies the full path to the migration properties file in which you specify the configuration information for the source or target environment.
  • If you installed the new version of the product on the same computer as the source environment, the sample 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 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.

-help
Optional parameter that provides the command usage.

Examples

  • For UNIX operating systemFor Linux operating system 
    ./BPMManageApplications.sh -autoStart true -source -propertiesFile /opt/BPMV19.0.0.3/util/migration/resources/source_migration.properties
  • For Windows operating system 
    BPMManageApplications.bat -autoStart false -target -propertiesFile "E:\Upgrade Utilities\util\migration\resources\target_migration.properties"