Contents Dochome
Sun Java(TM) System Directory Server Online Help

> # Audit Log Tab of Logs Configuration

> Use this tab to configure the disk usage and file rotation policies for your audit logs. The audit log contains detailed information about changes made to each database as well as to the overall server configuration. Go to the log icon under the top-level Status tab to view the contents of the audit log.

> Enable logging. Select this checkbox to configure the server to keep an audit log; clear this checkbox to disable audit logging. By default, audit logging is not enabled in the server.

> Log File. Specifies the full path and name of the current audit log file. To change the file, enter a new name or click Browse to select a file. By default, the audit log file is:

> serverRoot/slapd-serverID/logs/audit

> Old log files are stored in the same path with the same name and an extension containing the date the file was created, in the format filename.YYYYMMDD-hhmmss. The server also maintains a file with the same name and the .rotationinfo extension to record the creation dates of all audit log files.

> ## Creation Policy

> These options allow you to specify how often the server starts a new audit log file.

> Maximum number of logs. The number of audit log files to keep. When the number of audit log files reaches this value, the server deletes the oldest audit log file whenever it creates a new audit log file. The default value is 2.

> File size for each log. The maximum file size (in megabytes) for the active audit log file. Once a file reaches the size you specify, the server closes the file and starts a new one. The default value is 100 megabytes.

> Unlimited size. Select this checkbox to rotate logs only according to the frequency defined in the next field. When this checkbox is selected, the deletion policy for total log size is deselected automatically because log rotation is not based on file size. You will be asked for confirmation when selecting unlimited audit log size because of the risk of filling up your disk.

> Create a new log every. Defines how often you want the server to start a new audit log. The server closes a log file when it reaches the maximum file size or when the specified time period has elapsed, whichever comes first. The default value is every 1 week.

> ## Deletion Policy

> These options allow you to configure the server to automatically delete unneeded audit log files, as a safeguard against filling up your disk.

> When total log exceeds. Select this checkbox and enter a number to define a rotation policy based on file size. The server will delete the oldest audit log file once the cumulated size of all audit log files reaches this amount (in megabytes). The default value is 100 megabytes. This checkbox is automatically deselected when you choose a log creation policy with unlimited file size.

> When free disk space is less than. The server will delete the oldest audit log file if the available disk space is less than this amount (in megabytes). The default value is 5 megabytes.

> When a file is older than. The server will delete any audit log file when it becomes older than the age you specify. The default age limit is 1 month.

> Save. Click save to apply the new audit log rotation policies.

> Contents Dochome

> Copyright 2004 Sun Microsystems, Inc. All rights reserved.