IBM BPM, V8.0.1, All platforms > Install IBM BPM > IBM BPM Advanced: Process Server > Install IBM BPM Advanced: Process Server > On Windows > Network deployment environment > Configure profiles and create an ND environment > Create an ND environment > Use the administrative console > Configure components > Configure optional components > Configure Business Process Choreographer > Configure Business Process Choreographer Explorer
Use the clientconfig.jacl script file to configure Business Process Choreographer Explorer or Business Process Archive Explorer
This describes how to configure a Business Process Choreographer Explorer or Business Process Archive Explorer and all the necessary resources on a server or cluster. You can also use the script to change configuration settings for an existing instance, including changing the maxListEntries. You can either run this script interactively or in batch mode.
Purpose
This script can be used for several different purposes.
- To configure a Business Process Choreographer Explorer instance that connects to a particular Business Process Choreographer configuration, and works with the templates and instances in that configuration's runtime (BPEDB) database.
- To configure a Business Process Archive Explorer instance that connects to a particular Business Process Archive Manager configuration, and works with the completed instances in that configuration's archive (BPARCDB) database. This requires the same planning and parameters that are required for a Business Process Choreographer Explorer instance, except that the script is invoked with the -operationMode ARCHIVE option, the -explorerHost parameter has no effect, and the instance connects to a Business Process Archive Manager configuration.
- To change configuration settings for an instance of either type.
Location
The clientconfig.jacl script file is located in the Business Process Choreographer config directory:-
smpe_root/ProcessChoreographer/config
-
INSTALL_ROOT/ProcessChoreographer/config
-
INSTALL_ROOT\ProcessChoreographer\config
Running the script in a stand-alone server environment
The configuration script is run using the wsadmin command. In a stand-alone server environment:
- Include the -conntype NONE option only if the application server is not running.
- If WebSphere administrative security is enabled, and your user ID does not have configurator or administrator authority, include the wsadmin -user and -password options to specify a user ID that has configurator or administrator authority.
- If you are not working with the default profile, use the wsadmin -profileName profile option to specify the profile.
Running the script in an ND environment
The configuration script is run using the wsadmin command. In an ND environment:
- Run the script on the dmgr node.
- Include the -conntype NONE option only if the dmgr is not running.
- If WebSphere administrative security is enabled, and your user ID does not have configurator or administrator authority, include the wsadmin -user and -password options to specify a user ID that has configurator or administrator authority.
- If you are not working with the default profile, use the wsadmin -profileName profile option to specify the profile.
Configure a Business Process Choreographer Explorer or Business Process Archive Explorer non-interactively
Change your current directory to INSTALL_ROOT and enter the command:
bin/wsadmin.sh -f ProcessChoreographer/config/clientconfig.jacl parameters
-
bin/wsadmin.sh -f ProcessChoreographer/config/clientconfig.jacl parameters
-
bin\wsadmin.bat -f ProcessChoreographer/config/clientconfig.jacl parameters
Where parameters are:
( [-node nodeName][-server serverName] | [-cluster clusterName] )
[-operationMode { RUNTIME | ARCHIVE }]
[-contextRootExplorer explorerContextRoot]
[-explorerHost explorerURL]
[-hostName explorerVirtualHostname]
[-precompileJSPs { yes | no }]
( ( [-remoteNode nodeName][-remoteServer serverName] )
| [-remoteCluster clusterName] )
[-maxListEntries maximum]
[-promptMode { ASK | USE_DEFAULT | FAIL_IF_MISSING }]
-restAPIBFM restAPIURL
-restAPIHTM restAPIURL
If you run the script in batch mode, you must include all required parameters. If you run the script interactively, any required parameters that are not provided on the command line are prompted for.