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



Access Log Tab of Logs Configuration

Use this tab to configure the disk usage and file rotation policies for your access logs. The access log contains detailed information about client connections to the directory. Go to the log icon under the top-level Status tab to view the contents of the access log.

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

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

serverRoot/slapd-serverID/logs/access

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 access log files.

Creation Policy

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

Maximum number of logs. The number of access log files to keep. When the number of access log files reaches this value, the server will delete the oldest access log file whenever it creates a new access log file. The default value is 10.

File size for each log. The maximum file size (in megabytes) for the active access 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 access 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 access 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 day.

Deletion Policy

These options allow you to configure the server to automatically delete unneeded access 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 access log file once the cumulated size of all access log files reaches this amount (in megabytes). The default value is 500 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 access 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 access 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 access log rotation policies.


Contents      Dochome     
Copyright 2005 Sun Microsystems, Inc. All rights reserved.