Runtime migration tools reference

Use the runtime migration tools to migrate topology configuration, applications, and databases to IBM BPM V8.0.1.

The runtime migration tools required to perform a version-to-version migration fall into the following categories:


IBM BPM migration command-line utilities

The IBM BPM migration command-line utilities are located in the directory, except for BPMMigrate, which is located in the directory.

BPMConfigureProcessServer

the BPMConfigureProcessServercommand, you can configure a server or a cluster with Process Server, Performance Data Warehouse, and Process Portal.

For more information about the BPMConfigureProcessServer command, see the BPMConfigureProcessServer topic.

BPMCreateDatabaseUpgradeUtilities (deprecated)

The BPMCreateDatabaseUpgradeUtilities command creates an archive file that contains all of the commands and their prerequisites that need to be invoked on the database system where the database upgrade is to be performed.

For more information about the BPMCreateDatabaseUpgradeUtilities command, see the BPMCreateDatabaseUpgradeUtilities command-line utility topic.

BPMCreateRemoteMigrationUtilities

The BPMCreateRemoteMigrationUtilities command creates an archive file containing all the commands and their prerequisites that need to be invoked on the system containing the source profile to be migrated.

For more information about the BPMCreateRemoteMigrationUtilities command, see the BPMCreateRemoteMigrationUtilities command-line utility topic.

BPMCreateTargetProfile

The BPMCreateTargetProfile command creates a target migration profile using some of the base configuration information that was backed up using the BPMSnapshotSourceProfile command.

For more information about the BPMCreateTargetProfile command, see the BPMCreateTargetProfile command-line utility topic.

BPMGenerateUpgradeSchemaScripts

The BPMGenerateUpgradeSchemaScripts command generates SQL scripts and upgradeSchema scripts for a database that must be upgraded manually during a version-to-version migration or a refresh pack upgrade.

For more information about the BPMGenerateUpgradeSchemaScripts command, see the BPMGenerateUpgradeSchemaScripts command-line utility topic.

BPMMigrateProfile

The BPMMigrateProfile command migrates a source profile from the snapshot directory to a target profile.

For more information about the BPMMigrateProfile command, see the BPMMigrateProfile command-line utility topic.

BPMMigrationStatus

The BPMMigrationStatus command displays the status of the migrations that have been executed on the system.

For more information about the BPMMigrationStatus command, see the BPMMigrationStatus command-line utility topic.

BPMQueryDeploymentConfiguration

The BPMQueryDeploymentConfiguration command extracts the deployment configuration from the source profile and generates an XML file. This information is needed specifically for updating WebSphere Adapters during runtime migration.

For more information about the BPMQueryDeploymentConfiguration command, see the BPMQueryDeploymentConfiguration command-line utility topic.

BPMSnapshotSourceProfile

The BPMSnapshotSourceProfile command copies the configuration files in the source profile to a snapshot directory that will serve as the source of the profile migration.

For more information about the BPMSnapshotSourceProfile command, see the BPMSnapshotSourceProfile command–line utility topic.

installBRManager

The installBRManager command migrates the Business Process Rules Manager.

For more information about the installBRManager command, see the installBRManager command-line utility topic.

migrateBSpaceData (Business Space)

Use the migrateBSpaceData command-line utility to migrate the Business Space data.

For more information about the migrateBSpaceData command, see the migrateBSpaceData command-line utility topic.

upgradeSchema (Common Database)

Use the upgradeSchema command-line utility to upgrade the database schema.

For more information about the upgradeSchema command, see the upgradeSchema topic.


WebSphere Application Server migration command-line utilities

backupConfig

The backupConfig command is a simple utility to back up the configuration of your node to a file.

For more information about the backupConfig command, see backupConfig command in the WebSphere Application Server information center.

convertScriptCompatibility

The convertScriptCompatibility command is used by administrators to convert their configurations from a mode that supports compatibility with earlier versions of WebSphere Application Server Version 5.1.x or Version 6.0.x administration scripts to a mode that is fully in the Version 7.0 configuration model.

For more information about the convertScriptCompatibility command, see convertScriptCompatibility command in the WebSphere Application Server information center.

migrationDisablementReversal

If you need to roll back a deployment cell or managed node, use the wsadmin command to run the migrationDisablementReversal.jacl script.

For more information about the migrationDisablementReversal.jacl script, see Rolling back a ND cell in the WebSphere Application Server information center.

restoreConfig

Use the restoreConfig command to restore the configuration of your node after backing up the configuration using the backupConfig command.

For more information about the restoreConfig command, see restoreConfig command in the WebSphere Application Server information center.

startManager

Use the startManager command to manipulate a dmgr with scripting.

For more information about the startManager command, see startManager command in the WebSphere Application Server information center.

startNode

The startNode command reads the configuration file for the node agent process and constructs a launch command.

For more information about the startNode command, see startNode command in the WebSphere Application Server information center.

startServer

The startServer command reads the configuration file for the specified server process and starts that server process.

For more information about the startServer command, see startServer command in the WebSphere Application Server information center.

stopManager

The stopManager command reads the configuration file for the ND manager process.

For more information about the stopManager command, see stopManager command in the WebSphere Application Server information center.

stopNode

The stopNode command reads the configuration file for the ND node agent process and sends a Java Management Extensions (JMX) command telling the node agent to shut down.

For more information about the stopNode command, see stopNode command in the WebSphere Application Server information center.

stopServer

The stopServer command reads the configuration file for the specified server process. This command sends a Java management extensions (JMX) command to the server telling it to shut down.

For more information about the stopServer command, see stopServer command in the WebSphere Application Server information center.

syncNode

The syncNode command forces a configuration synchronization to occur between the node and the dmgr for the cell in which the node is configured.

The node agent server runs a configuration synchronization service that keeps the node configuration synchronized with the master cell configuration.

If the node agent is unable to run because of a problem in the node configuration, you can use the syncNode command to perform a synchronization when the node agent is not running in order to force the node configuration back in sync with the cell configuration.

If the node agent is running and you want to run the syncNode command, first stop the node agent.

For more information on the syncNode command, see syncNode command in the WebSphere Application Server information center.

Migrating your IBM BPM Advanced V7.5.x or WebSphere Process Server V7.x or V6.2.x runtime