file. The audit log properties turn the audit log on or off and allow you to specify the directory where Data Vault stores the audit log files. The properties also control how the audit logs grow.
Configure the following properties in the SERVER section of the Data Vault
ssa.ini
file:
AUDITLOG=
Enables or disables audit logging. Valid inputs are ON and OFF.
AUDITLOGDIR=
The location of the audit logs that the Data Vault server creates. Enter the file path of the directory where you want to save the audit logs.
For example,
AUDITLOGDIR=C:\ILM-IDV\fas_logs\
AUDITLOGLIMIT_FILESIZE=
Sets the maximum size in bytes for the audit log. When the audit log reaches this size, one of two events occurs. New log information might replace the oldest log entries, keeping the audit log below or at the specified maximum size. Or, if you set AUDITLOGLIMIT_MAXFILES to a value greater than 1, the Data Vault server creates another audit log to store the latest log information. If the Data Vault server creates another audit log, it leaves the previous log intact.
If you set the AUDITLOGLIMIT_FILESIZE parameter to 0, Data Vault uses the AUDITLOGLIMIT_TIME parameter instead. If the AUDITLOGLIMIT_TIME parameter is also missing, Data Vault uses the default value for AUDITLOGLIMIT_FILESIZE to limit the log.
The AUDITLOGLIMIT_FILESIZE parameter takes precedence over the AUDITLOGLIMIT_TIME parameter. If you enter a value for both parameters in the
ssa.ini
file, the Data Vault server limits the audit log by size instead of time period.
Default is 1048576.
This property is optional.
AUDITLOGLIMIT_TIME=
Sets a time limit on the audit log. The audit log time limit determines how long the Data Vault server writes to an audit log. When the time interval between the first and latest message exceeds the time limit, the Data Vault server creates another audit log. The Data Vault server removes previous audit logs based on the maximum files setting, AUDITLOGLIMIT_MAXFILES.
Specify one of the following values for the AUDITLOGLIMIT_TIME parameter:
n
MINUTE or
n
MINUTES
n
HOUR or
n
HOURS
n
DAY or
n
DAYS
n
MONTH or
n
MONTHS
If you do not specify the unit of time, Data Vault uses DAYS.
The AUDITLOGLIMIT_TIME and AUDITLOGLIMIT_FILESIZE parameters are mutually exclusive. Both parameters set limits on the audit log, but AUDITLOGLIMIT_TIME constrains by time, while AUDITLOGLIMIT_FILESIZE constrains by file size. If you configure both parameters in the
ssa.ini
file, the AUDITLOGLIMIT_FILESIZE parameter takes precedence.
This property is optional.
AUDITLOGLIMIT_MAXFILES=
Specifies the maximum number of audit logs that Data Vault retains.
After an audit log reaches its configured size or time limit, the Data Vault server creates another audit log to store the latest messages. Data Vault does not delete the old audit log. Data Vault retains at least two audit logs, the current audit log and the previous one. Data Vault might delete earlier logs based on the value for AUDITLOGLIMIT_MAXFILES.
If you enter a value of 0 for the AUDITLOGLIMIT_MAXFILES parameter, Data Vault sets the maximum number of log files to unlimited. If you enter a value of 1, Data Vault uses the default value instead.