Working With Service Logs

This section describes how to work with service logs by using the configutil command, and Console for searching and viewing logs.

To Send Service Logs to syslog

Step

Run the configutil command with the syslogfacility option:

configutil -o logfile.service.syslogfacility -v value

where service is admin, pop, imap, imta, or http and value is user, mail, daemon, local0 to local7, or none.

Once the value is set, messages are logged to the syslog facility corresponding to the set value and all the other log file service options are ignored. When the option is not set or the value is none, logging uses the Messaging Server log files.

To Set Logging Options Using Console

Steps

1. Open the Messaging Server whose log file options you want to set.

2. Click the Configuration tab, open the Log Files folder in the left pane, and select the log files of a service (such as IMAP, HTTP, or Admin).

3. From the “Levels of detail” drop-down list, choose a logging level.

4. In the “Directory path for log files” field, enter the name of the directory to hold your log files.

5. In the “File size for each log” field, enter your maximum log-file size.

6. In the “Create new log every” field, enter a number for the log-rotation schedule.

7. In the “Number of logs per directory” and the “When a log is older than” fields, enter the maximum number of log files and a maximum age to coordinate with your backup schedule.

8. In the “When total log size exceeds” field, enter the total storage limit you want.

9. In the “When free disk space is less than” field, enter the minimum amount of free disk space you want to reserve.

To Disable HTTP Logging

If your system does not support HTTP message access, that is, Webmail, you can disable HTTP logging by setting the following variables. Do not set these variables if your system requires Webmail support (for example, Messenger Express).

• Run the following configutil commands:

  configutil -o service.http.enable -v no
  configutil -o service.http.enablesslport -v no

To Set the Server Log Level

Step

Run the following configutil command:

configutil -o logfile.service.loglevel -v level

where service is admin, pop, imap, imta, or http and loglevel is Nolog, Critical, Error, Warning, Notice, Information, or Debug.

To Specify a Directory Path for Server Log Files

Step

Run the following configutil command:

configutil -o logfile.service.logdir -v dirpath

To Specify a Maximum File Size for Each Service Log

Step

Run the following configutil command:

configutil -o logfile.service.maxlogfilesize -v size

where size specifies a number of bytes.

To Specify a Service Log Rotation Schedule

Step

Run the following configutil command:

configutil -o logfile.service.rollovertime -v number

where number specifies a number of seconds.

To Specify a Maximum Number of Service Log Files Per Directory

Step

Run the following configutil command:

configutil -o logfile.service.maxlogfiles -v number

where number specifies the maximum number of log files.

To Specify a Storage Limit

Step

Run the following configutil command:

configutil -o logfile.service.maxlogsize -v number

where number specifies a number in bytes.

To Specify the Minimum Amount of Free Disk Space to Reserve

Step

Run the following configutil command:

configutil -o logfile.service.minfreediskspace -v number

where number specifies a number in bytes.

To Specify an Age for Logs at Which They Expire

configutil -o logfile.service.expirytime -v number

where number specifies a number in seconds.

To Specify a Search and View Results

Follow these steps to search for logged events with specific characteristics belonging to a given service:

Steps

1. In Console, open the Messaging Server whose log files you want to inspect.

2. Follow either of these steps to display the Log Files Content tab for a given logged service:

   • Click the Tasks tab, then click “View service logs”, where service is the name of the logged service (such as “IMAP service” or “administration”).

   • Click the Configuration tab, then open the Log Files folder in the left pane and select the log files of a service (such as IMAP or Admin). Then click the Content tab in the right pane.

3. The Content tab for that logged service is displayed.

4. In the Log filename field, select the log file you want to examine.

5. Click the View selected log button to open the Log Viewer window.

6. In the Log Viewer window, specify your desired search parameters (described in the previous section, Search Parameters).

7. Click Update to perform the search and display the results in the Log entry field.