BPMQueryDeploymentConfiguration command-line utility

Edit online

Draft comment:
This topic only applies to BAW, and is located in the BAW repository. Last updated on 2025-03-13 12:15

Use the BPMQueryDeploymentConfiguration command-line utility to extract the deployment configuration from the source profile and generate an XML file. This information is needed specifically for updating WebSphere® Adapters during runtime migration.

This command extracts the deployment configuration from the source profile and generates an XML file that contains information about:

Applications that embed WebSphere Adapters
WebSphere Adapters configured at node or cluster scope

The BPMQueryDeploymentConfiguration command extracts the deployment configuration from the source profile represented by the source_install_root and source_profile_name parameters into an ApplicationMigrationInformation.xml file. This file is created in the directory specified by the snapshot_directory parameter.

In the ApplicationMigrationInformation.xml file:

The entries between <applications> and </applications> represent applications that embed WebSphere Adapters.
The entries between <clusters> and </clusters> represent WebSphere Adapters configured at specific cluster scope.
The entries between <nodes> and </nodes> represent WebSphere Adapters configured at specific node scope.

Edit the generated XML file to mark which WebSphere Adapter instances to update to version 8.0 during runtime migration.

Edit the value in <update> from false to true to update a specific WebSphere Adapter instance to version 8.0. Additionally, copy the version 8.0 RAR file of the WebSphere Adapter being marked for update into the following directory: target_install_root/installableApps.

Note: Set the <update> to true for any application that embeds WebSphere Adapters version 6.0.2 or previous versions of WebSphere Adapter for SAP. Set the <update> to true for any WebSphere Adapters version 6.0.2 or previous versions of WebSphere Adapter for SAP deployed at node or cluster scope.

Important: If the WebSphere Adapter deployed at node level is used to configure the WebSphere Adapter at cluster scope, the update of the WebSphere Adapter has to be applied in a consistent manner. If the WebSphere Adapter at cluster scope needs to be updated to version 8.0, the corresponding instance of WebSphere Adapter defined at each individual node scope for nodes which are participating in the cluster must be updated as well. Failure to perform the WebSphere Adapter update in a consistent manner for participating nodes and cluster level can lead to failures of applications using WebSphere Adapter instance. For more information on mapping of a cluster-scoped WebSphere Adapter to a node scope WebSphere Adapter, refer to Installing a resource adapter archive External link opens a new window or tab

in the WebSphere Application Server documentation.

Prerequisites

Before invoking the BPMQueryDeploymentConfiguration command, stop all servers and node agents associated with the profile that is being extracted.

Location

The BPMQueryDeploymentConfiguration command-line utility is in the target_install_root/bin directory.

Errors are logged in the snapshot directory in a file whose name begins with BPMQueryDeploymentConfiguration and ends with .error.

Syntax

BPMQueryDeploymentConfiguration 
source_install_root 
source_profile_name 
snapshot_directory

Parameters

source_install_root: Specifies the directory where the source version of IBM® Business Automation Workflow file is installed.
source_profile_name: Specifies the name of the IBM Business Automation Workflow source profile.
snapshot_directory: Specifies the directory where the ApplicationMigrationInformation.xml file is created. The file is created in the following directory: snapshot_directory/profiles/source_profile_name.
-help: Provides the command usage.

Examples

The following example extracts the deployment configuration for profile 1 in the BPM620 source installation root directory to the directory /MigrationSnapshots/ProcServer620/profiles/profile1:

BPMQueryDeploymentConfiguration.sh /opt/ibm/WebSphere/ProcServer620 profile1 /MigrationSnapshots/ProcServer620

BPMQueryDeploymentConfiguration.bat "C:\Program Files\IBM\WebSphere\ProcServer620" profile1 c:\MigrationSnapshots\ProcServer620