This script file configures the human task container.
Purpose
This script file configures all the resources
that are required by the Human Task Manager.
This file is
in the folder install_root/ProcessChoreographer.
Attention: If
you run the bpeconfig.jacl script, you need not run the taskconfig.jacl script,
because the bpeconfig.jacl script calls the taskconfig.jacl script.
Running the script interactively
To run
taskconfig.jacl in
an interactive dialog session:
On UNIX and Linux systems, enter the command:
install_root/bin/wsadmin.sh
-f install_root/ProcessChoreographer/taskconfig.jacl
[-conntype none]
[-username userName]
[-password password]
On
Windows systems, enter the command:
install_root\bin\wsadmin.bat
-f install_root\ProcessChoreographer\taskconfig.jacl
[-conntype none]
[-username userName]
[-password password]
In a standalone server environment:
- Include the option conntype none only if the deployment
manager is not running.
- If global security is enabled, include the options username and password.
In a Network Deployment environment:
- Run the taskconfig.jacl script on the deployment manager node.
- Include the option conntype none only if the deployment
manager is not running.
- If the deployment manager is running, do not use the option conntype
none.
- If global security is enabled, include the options username and password.
Configuring the human task container noninteractively
If
you provide the necessary parameters on the command line, you will not be
prompted for them. To configure a business process container that uses the
default messaging JMS provider with a Cloudscape database type, enter the
following:
On UNIX and Linux systems, if your current directory is install_root/ProcessChoreographer,
enter the command:
../bin/wsadmin.sh -conntype none -f taskconfig.jacl
-adminHTMUsers userList
-adminHTMGroups groupList
-monitorHTMUsers userList
-monitorHTMGroups groupList
-jmsHTMRunAsUser userID
-jmsHTMRunAsPwd password
-mqType MQSeries
-mqUser mqm
-mqPwd mqm
-mqHome /usr/mqm
-mailServerName hostName
-mailUser userID
-mailPwd password
Parameters
- adminHTMUsers userList
- Where userList is the list of names of users, from
the WebSphere registry, to which to map the HTMSystemAdminstrator Java 2 Enterprise
Edition (J2EE) role. The separator character is |. This property is needed
to install the task container. This parameter has no default value. This parameter
has no default value. Either or both adminHTMUsers or adminHTMGroups must
be set.
- adminHTMGroups groupList
- Where groupList is the list of names of groups, from
the WebSphere registry, to which to map the HTMSystemAdminstrator J2EE role.
The separator character is |. This property isneeded to install the task container.
This parameter has no default value. Either or both monitorHTMUsers or adminHTMGroups
must be set.
- monitorHTMUsers userList
- Where userList is the list of names of users, from
the WebSphere registry, to which to map the HTMSystemMonitor J2EE role. The
separator character is |. This property is needed to install the task container.
This parameter has no default value. Either or both monitorHTMUsers or monitorHTMGroups
must be set.
- monitorHTMGroups groupList
- Where groupList is the list of names of groups, from
the WebSphere registry, to which to map the HTMSystemMonitor J2EE role. The
separator character is |. This property is needed to install the task container.
This parameter has no default value. Either or both monitorHTMUsers or monitorHTMGroups
must be set.
- jmsHTMRunAsUser userID
- Where userID is the run-as user
ID for the task container message-driven bean. This property is needed to
install the task container. This parameter has no default value. It must be
set.
- msHTMRunAsPwd password
- Where password is the password for the task container
message-driven bean. This property is needed to install the task container.
This parameter has no default value. It must be set.
- mqType JMSProviderType
- Where JMSProviderType is the type of Java Message Service
(JMS) provider to use for process choreographer. It is needed to create the
queue manager and the queues, and to create the listener ports and the queue
connection factories.
Where JMSProviderType is one of
the following values:
- WPM
- For default messaging
- MQSeries
- For WebSphere MQ
- mqUser userID
- Where userID is the user ID to access WebSphere MQ.
It is needed to create the queue manager and the queues, when using the "MQSeries"
JMS provider on non-Windows platforms, and to create the listener ports and
the queue connection factories, when using the JMS provider for WPM.
Default
values for userID:
- Windows platforms
- currently_logged-on_user
- Other platforms
- mqm
- mqPwd password
- Where password is the password to access WebSphere
MQ. It is needed to create the queue manager and the queues, when using the
"MQSeries" JMS provider on non-Windows platforms, and for creating the listener
ports and the queue connection factories, when using the JMS provider for
WPM. This parameter has no default value.
- mqHome installationDirectory
- Where installationDirectory is the installation directory
of WebSphere MQ. It is needed to create the queue manager and the queues (Windows
only) and for creating the listener ports and the queue connection factories.
Default
values for installationDirectory:
- Windows platforms
- current_drive\Program Files\IBM\WebSphere
MQ
- AIX platform
- /usr/mqm
- iSeries platform
- /QIBM/ProdData/mqm
- SunOS platform
- /opt/mqm
- qmNameGet getQueueManagerName
- Where getQueueManagerName is the name of the queue
manager for GET requests. It is used with only the JMS provider designated MQSeries.
It is needed to create the queue manager and the queues, and to create the
listener ports and the queue connection factories. It must not contain the - character.
Default
value for getQueueManagerName: BPC_nodeName_serverName
- qmNamePut putQueueManagerName
- Where putQueueManagerName is the queue manager name
for PUT requests. It is used only when the mqClusterName parameter has been
set. It is needed to create the queue manager and the queues, and to create
the listener ports and the queue connection factories. It must not contain
the - character, and it must not be the same as used for
the qmNameGet parameter.
Default value for putQueueManagerName:BPCC_nodeName_serverName
- mailServerName mailServerName
- Where mailServerName is the host name of the mail server
to be used to send notification mails.
- mailUser mailUserID
- Where mailUserID is the user ID to access the mail
server. It is needed to create the mail session for the human task manager
to send notification mails.
Default: Empty: no authentication is required
to access the mail server.
- mailPwd mailPassword
- Where mailPassword is the password to access the mail
server. It is needed to create the mail session for the Human Task Manager
to send notification mails.
- profile profileName
- Where profileName is the name of a user-defined profile.
Specify this option if you are not configuring the default profile.
Installing the SchedulerCalendars
system application
The task container requires the SchedulerCalendars
system application. This application is not installed automatically on federated
nodes and cannot be installed automatically during the installation of Business
Process Choreographer. Therefore, whenever you configure the human task container
in a Network Deployment (ND) environment, either by running the bpeconfig.jacl
or taskconfig.jacl script or by running the administrative console wizard,
install the SchedulerCalendars system application as described in Installing the WebSphere SchedulerCalendars application on
federated nodes.