setBPMDefaultVirtualHost command

Use the setBPMDefaultVirtualHost command to set the IBM BPM default virtual host. For both stand-alone and network deployment (ND) environments, it is not necessary to restart the server or cluster after running the setBPMDefaultVirtualHost command if you also run the clearBPMEndpointServiceCache command. In ND environments, you must wait until node synchronization has completed before you run the clearBPMEndpointServiceCache command.

The setBPMDefaultVirtualHost command is run using the AdminTask object of the wsadmin scripting client.

Prerequisites

The following conditions must be met:

To set a virtual host as the default virtual host, you must explicitly set the port parameter of the virtual host (even when using the default port number for the transport protocol). You can set the port parameter of the virtual host by using the setBPMVirtualHost command, as described in the topic setBPMVirtualHost command.
The command must be run on the deployment manager node.
If the deployment manager is stopped, use the wsadmin -conntype none option to run the command in disconnected mode.
If the deployment manager is running, you must connect with a user ID that has WebSphere Application Server configurator privileges. Do not use the wsadmin -conntype none option.

Location

Start the wsadmin scripting client from the deployment_manager_profile/bin directory. The setBPMDefaultVirtualHost command does not write to a log file, but the wsadmin scripting client always writes a profile_root/logs/wsadmin.traceout log file where you will find exception stack traces and other information.

Syntax

setBPMDefaultVirtualHost
-de deployment_environment_name
-name virtual_host_name

Parameters

-de deployment_environment_name: A required parameter that specifies the name of the current deployment environment.
-name virtual_host_name: An optional parameter that specifies the name of an existing IBM BPM virtual host. If the -name parameter is omitted, the IBM BPM default virtual host property will be unset.

Examples

Note: The examples are for illustrative purposes only. They include variable values and are not meant to be reused as snippets of code.

The following Jython example uses the setBPMDefaultVirtualHost command to set the IBM BPM default virtual host:

wsadmin -user admin -password admin -lang jython
wsadmin>AdminTask.setBPMDefaultVirtualHost(['-de', 'De1', '-name', 'myVirtualHost'])
wsadmin>AdminConfig.save()