Oracle® Fusion Middleware Administrator's Guide for Oracle SOA Suite and Oracle Business Process Management Suite 11g Release 1 (11.1.1.4.0) Part Number E10226-05 |
|
|
View PDF |
The properties you configure are used by the BPMN process service engine during processing of BPMN service components.
This chapter includes the following topics:
Section 40.1, "Configuring BPMN Process Service Engine Properties"
Section 40.2, "Integrating Oracle BPM with Oracle Business Activity Monitoring"
To configure BPMN process service engine properties:
Access this page through one of the following options:
From the SOA Infrastructure Menu... | From the SOA Folder in the Navigator... |
---|---|
|
|
The BPMN Service Engine Properties page displays properties for setting audit trail and large document thresholds, setting dispatcher thread properties, validating payload schema, and setting the audit trail level.
Make changes to the service engine properties that are appropriate to your environment.
Click Apply.
If you want to configure advanced BPMN properties in the System MBean Browser, click More BPMN Configuration Properties. Properties that display include the following. Descriptions are provided for each property.
AuditDetailThreshold—The maximum size (in bytes) an audit trail details string can be before it is stored separately from the audit trail
AuditLevel—Controls the amount of audit events logged by a process; currently supported logging levels are: "off": absolutely no logging performed whatsoever; may result in a slight performance boost for processing instances
BpelcClasspath—The extra classpath need to be included when compiling BPMN generated java sources.
ConfigMBean—If true, it indicates that this MBean is a Config MBean.
CubeInstanceExpiration—The expiration time in hours of performance data. This parameter is disabled by default. You can enable it.
CubeTimerMaxErrorCount—Maximum allowed number of consecutive errors during cube timer processing. Once number of errors reaches "CubeTimerMaxErrorCount", the cube timer skips processing
CubeTimerMaxSkipOnErrorCount—Specifies the number of times the timer skips processing once the number of errors reaches "CubeTimerMaxErrorCount"
Note:
Once the cube timer errors out consecutively for "CubeTimerMaxErrorCout" times, the cube timer skips the timeout processing for "CubeTimerMaxSkipOnErrorCount" times. It then resumes the normal timeout processing. The time for which the cube timer skips processing can be calculated as CubeTimerMaxErrorCount * CubeUpdateFrequency.If the lockout time needs to be less, you must either reduce the time to a lesser value or change the number of times to skip timeout processing.
CubeUpdateFrequency—Frequency in seconds at which cube action calculates the workload
CubeWorkloadExpiration—The expiration time for workload records. It is set to 48 hours by default, which means that if a workload record's age is more than 48 hours, it is purged.
DisableActions—Comma delimited list of disabled measurement actions (e.g. "CubeCommand, BAMCommand"). Also see PublishMaxTrackBackCount.
DisableProcessTracking—If set to "true" the audit will disable process tracking. The default value "false".
DisableSensors—If set to "true" the engine will disable all calls to sensors. The default value "false".
DispatcherEngineThreads—The total number of threads that will be allocated to process engine dispatcher messages
DispatcherInvokeThreads—The total number of threads that will be allocated to process invocation dispatcher messages
DispatcherMaxRequestDepth—Maximum number of internal messages the engine will process. If this number is exceeded, new messages won't be dispatched. The default value is 600.
DispatcherSystemThreads—The total number of threads that will be allocated to process system dispatcher messages
eventProvider—If true, it indicates that this MBean is an event provider as defined by JSR-77.
eventTypes—All the event's types emitted by this MBean.
ExpirationMaxRetry—The maximum number of times a failed expiration call (wait/onAlarm) will be retried before failing
ExpirationRetryDelay—The delay between the expiration retries. The default value is 120 seconds.
InstanceKeyBlockSize—The size of the block of instance ids to allocate from the dehydration store during each fetch
LargeDocumentThreshold—The maximum size (in bytes) a BPMN variable can be before it is stored in a separate location from the rest of the instance scope data
MaximumNumberOfInvokeMessagesInCache—specify the number of invoke messages that can be kept in the in-memory cache, once the engine hits this limit, it would push the message to dispatcher in-memory cache, instead it would save the message in the db and these saved messages can be recovered using recovery job, you can use value -1 to disable
objectName—The MBean's unique JMX name
OneWayDeliveryPolicy—Changes whether the one-way invocation messages are delivered
PeopleQueryTimeout—specify quartz cron expression People Query. People Query in Logical People Group is re-evaluated based on this cron expression
PublishMaxTrackBackCount—Maximum number of records traversed from last audit record, checked for measurement and action enabled and published if so
QualityOfService—flag to enable or disable coherence cache for BPMN service engine. use CacheEnabled for enabling coherence.
ReadOnly—If true, it indicates that this MBean is a read only MBean.
RestartNeeded—Indicates whether a restart is needed.
StatsLastN—The size of the "most recently processed" request list
SystemMBean—If true, it indicates that this MBean is a System MBean.
ValidateXML—If set to "true" the engine will apply schema validation for incoming and outgoing XML documents. The default value "false".
Version—version of the config file
WFOracleUcmUrl—Specify URL for Oracle UCM repository administration server
When a BPMN composite application is deployed, the following BAM data objects are generated automatically:
Data object for the following business indicator:
TEMPLATE_BI_Partition_Composite_Process
Once this is imported, you should rename it to:
BI_DEFAULT_
Compositename
_
ProcessName
This is created in target folder. If the data object already exists, only new columns are added, assuming old columns match data types. Otherwise, an error is thrown.
COMPONENT, INTERVAL, COUNTER data objects if they aren't present in the target folder
The target BAM server is specified by JNDI name parameter.
Note:
Data objects can be created only automatically at deployment. You cannot create them manually.To configure Oracle BPM for use with Oracle Business Activity Monitoring, you perform these tasks:
You must configure the BAM Adapter to use either SOAP or RMI for communicating with BAM.
To configure the BAM adapter on Oracle BPM server:
In the Oracle WebLogic Server console, under Domain Structure, click Deployments.
Click OracleBAMAdapter, then click Configuration, then click Outbound Connection Pools.
Expand oracle.bam.adapter.adc.soap.SOAPConnectionFactory.
Click either eis/bam/soap
or eis/bam/rmi
.
The JNDI name used to configure the BAM adapter is used. For example, if you configureD the BAM adapter to use SOAP, then the default JNDI name is eis/bam/soap
. Similarly, if you configure the BAM adapter to use RMI, then the default JNDI name is eis/bam/rmi
.
Modify properties to match the BAM Server. (Remember to press Enter after text entry).
Click Save.
Select the location for the deployment plan—for example, bam/Plan.xml
, then complete the dialogs.
Return to Deployments.
Select OracleBAMAdapter.
Click Update and complete the dialogs.
For more information about integrating Oracle Business Activity Monitoring with Oracle SOA Suite composite applications, see Oracle Fusion Middleware Developer's Guide for Oracle SOA Suite.
To do this, you use the Oracle Fusion Middleware Control console.
To enable BAM on the Oracle BPM server:
In the Oracle Fusion Middleware Control console, under WebLogic Domain, select your domain and server.
Go to System MBean Browser.
Select oracle.as.soainfra.config, then Server, then BPMNConfig, then bpmn.
Go to Disable Actions. If you find BAMAction there, then clear the field.
Click Apply.