Audit Trail Persistence Modes

Stardust provides an audit-trail persistence mode concept which allows to execute process instances with varying approaches regarding persistence. A general configuration option is provided allowing to explicitly turning on the feature of transient processes, which is turned off per default. Process definitions can be flagged as transient candidates. Certain conditions in the model design lead to a switch from a transient processing to a normal processing.

Provided Persistence Modes

The following persistence modes are provided:

Persistence Mode Key Properties
Transient The process and potentially all its sub-processes will be executed transiently and audit trail data will only be kept in an in-memory cache for the time until the process instance completes. Upon completion of the process hierarchy, all audit trail data will be discarded for this process instance and no audit trail will be persisted to the database. Refer to chapter Transient Processes for details.
Deferred The process and all its sub-processes will be executed transiently and audit trail data will only be kept in an in-memory cache for the time until the process instance completes. Upon process completion the data will be stored to the audit trail data base. Refer to section Deferred for details.
Immediate The audit trail will be persisted to the audit trail database directly and synchronously along with activity thread processing. Refer to section Immediate for details.

Refer to the following sections for details on the different persistence modes.

Transient

Transient processes keep instances of the process in-memory only during the course of execution. No audit trail is persisted at all during or after the execution of the process instance. The corresponding objects are created during process execution and are available in the context of the activity threads running for that process instance. Refer to chapter Transient Processes for details on transient processes.

Deferred

All execution aspects of persistence mode Deferred are identical to the case Transient described in chapter Transient Processes with one exception:

When a process hierarchy executed in persistence mode Deferred is completed, the audit trail data kept in the transient cache for that process hierarchy will not be discarded but will be persisted to the audit trail database. The audit trail data will only be kept in an in-memory cache for the time until the process instance completes. Upon process completion the data will be stored to the audit trail data base.

Immediate

In audit trail persistence mode Immediate, the audit trail data are synchronously inserted or updated in the database as the activity threads belonging to the process instance in question create or modify activities, data values and related objects during process execution. This is the default mode.

All database operations are performed synchronously and in transactional isolation as an activity thread progresses. When an activity thread terminates, all database changes are persisted.

Configuration Options

The persistence mode can be set via one of the following options:

Defining the Persistence Mode for Processes in the Modeler

The property page of process definitions in the Stardust modeler provides you with a checkbox to choose one of the persistence modes described in section Persistence Modes. For details on the modeler settings refer to section Audit Trail Persistence of chapter Working with Process Definitions.

Global server-side Property

The global server-side property Carnot.Engine.Tuning.SupportTransientProcesses is provided to determine whether transient processing is available at all and how the corresponding model properties are handled. The following four values are possible: