Event Management Overview › Event Management Architecture › Event Management Components › Event Store › Configure the Event Store Parameters

Configure the Event Store Parameters

You can configure the Event Store parameters per connector that are based on your requirements. For example, you can configure the archive retention interval that is based on your corporate archiving policy. You can also control how to archive the Event Store XML files and configure when archived files are purged.

Follow these steps:

1. Open the SOI_HOME\jsw\conf folder.
2. Locate and open the SAM-IntegrationServices.conf file in a text editor.
3. Add any of the following properties to the file, and save the file:

   Note: Any properties that you do not add continue to use the default values defined in this section.

   ESTORE_ARCHIVE_RETENTION

   Specifies the number of days you want to keep the Event Store XML files in the EventStore folder before they are zipped and moved to the archive folder. If the disk volume on the system moves below 20 percent, the Event Store ignores this value and archives all current files.

   If your system uses enough disk space to activate this automatic archival, ensure that you enable searching of archived Event Store files. By default, Event Management does not search archived files.

   Default: 1

   ESTORE_FREE_DISK_SPACE

   Defines the threshold of free disk space percentage below which the Event Store automatically archives all files. For example, if you set this value to 10, the Event Store archives all files (regardless of the archive retention settings) when the free disk space on the system is below 10%.

   Important! If an automatic archive occurs and it does not cause the available disk space to move above the defined threshold, another automatic archive occurs the next time the Event Store polls for available disk space. The second automatic archive overwrites the initial one, purging the events from the first archive.

   Default: 20

   ESTORE_FREE_DISK_LIMIT

   Defines the threshold of free disk space in GB below which the Event Store automatically archives all files.

   Combined with the ESTORE_FREE_DISK_SPACE property, archiving is done only if both the percentage of free disk space and the total amount of free disk space are below the respective property values. For example, on a large disk, 20% is still enough capacity for Event Store to continue writing the event data. On the other hand, on a small disk a 20% restriction allows writing of event data even after reaching the ESTORE_FREE_DISK_LIMIT value.

   Default: 10

   ESTORE_PURGE_INTERVAL

   Specifies the number of days you want to keep the Event Store archived zip files in the archive folder before purging them from the system. Set this property to -1 to retain all archived files indefinitely.

   Default: 30

   ESTORE_ROLLOVER_FILESIZE

   Specifies the Event Store XML file size in MB. When the file size increases beyond the specified limit, the file is rolled over to another Event Store XML file.

   Note: We recommended that you do not increase the file size beyond 25 MB. You can encounter some issues while querying such large files.

   Default: 10

   ESTORE_MERGE_TIME_INTERVAL

   Specifies the time interval in seconds after which the size of the Event Store XML file is verified. The file is verified to see whether it has reached its specified limit and the file is ready to be rolled over to another file.

   Default: 7

   The Event Store parameters are configured.

4. Repeat Steps 1-3 for all connector configuration files that require the updated Event Store settings.
5. Restart the CA SAM Integration Services service.

   The changes take effect.

More information:

Archiving Event Store XML Files