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



Error Log Tab of Logs Configuration

Use this tab to configure the disk usage and file rotation policies for your error logs. The error log contains detailed messages about errors and events the server experiences during normal operations. Go to the log icon under the top-level Status tab to view the contents of the error log.

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

Log Level. Specifies the kinds of error and event messages the server should store in the error log. By default, no options are selected. Selecting any option will cause the error log to grow very rapidly because additional information is written for every request the server receives. You should not change this option unless requested to do so by Sun ONE Customer Support.

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

serverRoot/slapd-serverID/logs/errors

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

Creation Policy

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

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

File size for each log. The maximum file size (in megabytes) for the active error 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 error 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 error 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 error 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 error log file once the cumulated size of all error 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 error 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 error 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 error log rotation policies.


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