16.1 Configuring the Workflow Engine Settings

The Workflow Engine settings apply to all the Workflow Engine instances in the cluster. When you modify any of these settings, all Workflow Engine instances that are part of the same cluster will use the modified values.

The following table describes the Workflow Engine settings that you can configure:

Engine Setting


Enable Email Notification

Enables or disables email notifications for the Workflow Engine. Defaults to enabled.

Web Service Activity Timeout (minutes)

Specifies the default Web Service activity timeout. The default value is 50 minutes.

User Activity Timeout (hours, 0 for no timeout)

Specifies the default user activity timeout. The default value is 0 hours, which indicates no timeout.

Completed Process Timeout (day)

Specifies the number of days that a completed process is kept in the workflow database system. The default value is 120 days.

Completed Process Cleanup Interval (hours)

Specifies the time interval at which the Workflow Engine checks for and removes the completed processes from the workflow database. This setting only applies to those processes that have reached the limit specified in the Completed Process Timeout parameter. The default value is 12 hours.

Pending Process Interval (seconds)

User activities that are executed on an engine which the process is not bound to are put into a pending state. This interval specifies how often to check for pending activities in order to continue their execution. The default value is 30 seconds.

Retry Queue Interval (minutes)

Activities that fail because of suspected database connectivity issues are put on a retry queue. This interval specifies how often the engine attempts to retry these activities. The default value is 15 minutes.

Thread Keep Alive Time (seconds)

If the pool is larger than the minimum size, excess threads that have been idle for more than the keep-alive time will be destroyed. The default value is 5 minutes.

Maximum Engine Shutdown Timeout (minutes)

The engine attempts to shutdown gracefully. When shutting down it stops queuing new activities for execution and attempts to complete any activities already queued. This timeout specifies the maximum time that the engine waits for all queued activities and threads executing activities to complete. If this time is exceeded, the engine halts processing of queued activities and attempts to stop all threads executing activities. The default value is 1 minute.

Maximum Thread Pool Size

The maximum number of threads that the engine uses to execute activities. The default value is 20.

Minimum Thread Pool Size

The minimum number of threads that the engine uses to execute activities. When a thread is requested and fewer than the minimum are in the pool, a new thread will be created even if there are idle threads in the pool. The default value is 10.

Initial Thread Pool Size

Number of pre-started threads in the pool when it is created. The default is 5.

Process Cache Load Factor

The load factor specifies how full the cache is allowed to get before increasing its capacity. If the number of entries in the cache exceeds the product of the load factor multiplied by the current capacity, then the capacity is increased. The default value is 0.75.

Process Cache Initial Capacity

The process cache is backed by a hash map. The capacity is the number of buckets in the hash map. The initial capacity is the number of buckets at the time the cache is created. The default value is 700.

Process Cache Maximum Capacity

Before adding a process to the cache, if the number of processes in the cache equals or exceeds the Process Cache Maximum Capacity, the cache attempts to remove the oldest inactive process from the cache. The maximum capacity is a soft limit, so the number of processes in the cache might exceed the Process Cache Maximum Capacity if there are no inactive processes (only active processes) in the cache. The default value is 500.

Notify Consumer Interval (seconds)

Specifies how many seconds the Workflow Engine must wait before sending any pending approval status notification to a consumer application. This setting is applicable when consumer application such as Identity Governance is in maintenance mode or if it fails to receive the notification. The default value is 300 seconds.