Configuring How BPM Audit Messages are Auto-archived

You can configure how long ActiveMatrix BPM messages are archived in the ec.properties file.

This file is typically stored on the machine where you installed ActiveMatrix BPM, under the folder CONFIG_HOME/bpm/bpm_app_name/configuration/.

In a distributed environment, you can configure the folder in which the node should look for these properties files. This allows you to host the properties files on a shared folder that is accessible to all the machines in the cluster. For example, consider a clustered environment with two machines, machine A and machine B, where ActiveMatrix BPM is installed on machine A. You can share the folder CONFIG_HOME/bpm/bpm_app_name/configuration/ on machine A and mount it as "/mnt/bpm " on machine B.

In the ec.properties files, configure the properties as follows:
Property Default Value Description
autoarchiveEnabled true Whether auto-archive is enabled. If you do not want to auto-archive your messages, change the value to false.
autoarchiveSchedulerEnabled true If set to false, allows autoarchive to run if manually triggered (using triggerAutoArchive, see TIBCO ActiveMatrix BPM Developer's Guide for more information) but, does not ever schedule an autoarchive to run automatically. If you want your archiving to be scheduled automatically, you must set this to true.
autoarchiveStart 02:15 The local server time, in the format hh:mm, that the audit messages are archived. Archiving takes place on a daily basis.
Note: If you amend the time on your system, the first time the archive runs, it runs at the old system time. After that, the archives will run at the new system time.
autoarchiveLogLevel INFO The log level which archive general information should be printed at.
autoarchiveWarnItemsArchived 100000 If a single archive causes more than the specified number of events to be archived, a warning is generated.
autoarchiveWarnAuditSize 5000000 If the size of the ec_event_int table gets bigger than the specified value, a warning is generated. You may want to configure this to be higher, depending on the size of your system. You can disable this property by setting it to -1.
autoarchiveWarnDuration 60 The time, in minutes, that an archive can take before a warning is generated.
autoarchiveCancelDuration 120 The time, in minutes, that an archive can take before it is cancelled.
autoarchiveProcessInstanceAge 30 The age, in days, after which process instance events are archived. (Process instance events are events attached to process instances or case data).
autoarchiveSystemAge 30 The age, in days, after which system events are archived. (System events are events that are not attached to a process instance or a case.)
autoarchiveWarnProcessInstancesToArchive 10000 If the number of archived process instances archived in a single task exceeds the specified value, a warning is generated.
autoarchiveSystemEvents See the ec.properties file for the default list of message ID's. The message ID's which are considered system events.