moveBPCExplorer command

Use the moveBPCExplorer command to move the Business Process Choreographer Explorer from one deployment target to another deployment target.

You can use this command to move the Business Process Choreographer Explorer from one cluster (such as an application cluster) to another cluster (such as a support cluster). Or, you can use this command to move the Business Process Choreographer Explorer from one server to another server.

One reason for moving the Business Process Choreographer Explorer might be to more evenly distribute processing load. For example, if you have installed everything on a single cluster and you now want to have a separate cluster for your support applications to reduce the load on your application cluster, you could move the Business Process Choreographer Explorer from an application cluster to a support cluster.

Attention: After you have moved the Business Process Choreographer Explorer to the new deployment target, you must complete the node synchronization operation and ensure that changes are saved to the configuration. If you start the server or the application that you have moved before node synchronization, you receive an error indicating that Business Process Choreographer Explorer cannot be started.

Moving Business Process Choreographer Explorer might result in a change of the URL under which the Business Process Choreographer Explorer can be accessed. Make sure that you adjust your web browser to use the correct Business Process Choreographer Explorer URL. The value of the URL depends on how the virtual host and context root are configured for your installation. If you are using a web server, make sure that you update and propagate the plug-in configuration for your web server. For information about virtual hosts settings and mapping virtual hosts for web modules, see the WebSphere Application Server information center.

After using the command, save your changes to the master configuration using one of the following commands:

For Jython:
```
AdminConfig.save()
```
For Jacl:
```
$AdminConfig save
```

Required parameters

fromClusterName name_of_cluster

The name of the cluster on which Business Process Choreographer Explorer is currently installed.

Do not specify this parameter if the fromNodeName or fromServerName parameters are specified

fromNodeName name_of_node

The name of the node on which Business Process Choreographer Explorer is currently installed.

If you specify this parameter, then you must also specify the fromServerName parameter. Do not specify this parameter if you have specified the fromClusterName parameter.

fromServerName name_of_server

The name of the server on which Business Process Choreographer Explorer is currently installed.

If you specify this parameter, then you must also specify the fromNodeName parameter. Do not specify this parameter if you have specified the fromClusterName parameter.

toClusterName name_of_cluster

The name of the cluster onto which you are moving Business Process Choreographer Explorer.

Do not specify this parameter if you have specified the toNodeName or toServerName parameters.

toNodeName name_of_node

The name of the node onto which you are moving Business Process Choreographer Explorer.

If you specify this parameter, then you must also specify the toServerName parameter.

Do not specify this parameter if you have specified the toClusterName parameters.

toServerName name_of_server

The name of the server onto which you are moving Business Process Choreographer Explorer.

If you specify this parameter, then you must also specify thetoNodeName parameter. Do not specify this parameter if you have specified the toClusterName parameter.

Optional parameters

applicationName name_of_application: The name of the specific Business Process Choreographer Explorer application that you are moving.
If you do not specify this parameter, all Business Process Choreographer Explorer applications on the deployment target are moved.

Examples

The following examples show how to use moveBPCExplorer.

The examples show how to move Business Process Choreographer Explorer from server to server or from cluster to cluster. However, it is also possible to move Business Process Choreographer Explorer from a server to a cluster, or from a cluster to a server.

Jython example:

The example uses moveBPCExplorer to move the Business Process Choreographer Explorer from Server1, to Server2.

AdminTask.moveBPCExplorer('[-fromServerName Server1 -toServerName Server2 -fromNodeName Node1 
-toNodeName Node2 -applicationName BPCExplorer_Node1_Server1]')

Jacl example:
The example uses moveBPCExplorer to move the Business Process Choreographer Explorer from an application cluster (Cluster1), to a support cluster (Cluster2) in a multi-clustered environment.
```
$AdminTask moveBPCExplorer { -fromClusterName Cluster1 -toClusterName Cluster2 
-applicationName BPCExplorer_Cluster1}
```