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
- 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
- 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)
- 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 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 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 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.
Optional parameters
- -help
- Provides the command usage.
Examples
- ./BPMManageApplications.sh -autoStart true -source -propertiesFile /opt/BPM85/util/migration/resources/source_migration.properties
- BPMManageApplications.bat -autoStart false -target -propertiesFile "E:\Upgrade Utilities\util\migration\resources\target_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.