IWS Event Files Purging and Retention Configuration

Products

• Automation Analytics & Intelligence

Issue/Introduction

IWS event data files (after being processed) are not being purged on the IWS connector host. This can lead to unnecessary storage consumption if retention settings are not aligned with operational requirements.

Environment

AAI 24.4

Cause

The retention period for event and definition files is governed by specific configuration parameters within the AAI environment. If these parameters are set to a high value, files will remain on the host until the retention threshold is reached.

Resolution

Event data files are purged based on specific retention parameters. By default, both event and definition file retention is set to 7 days. These settings can be adjusted using the ConfigTool.

Configuration Steps

1. Launch the ConfigTool.
2. Navigate to the Parameters tab.
3. Locate the section for less commonly configured parameters.
4. Modify the following parameters as needed:
   • IWS.eventRetention: Controls how long processed event data files are kept.
   • IWS.definitionRetention: Controls how long definition files are kept.
     
     

Parameter Rules

• Minimum Value: 1 hour
• Maximum Value: 31 days
• Unit: Values must be specified in hours.

 

How Purging Works

The system runs an event loop that periodically checks the file age against these configured parameters. Any file older than the specified value is automatically purged from the host.