This section describes how to work with service logs by using the configutil command, and Console for searching and viewing logs.
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.
Open the Messaging Server whose log file options you want to set.
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).
From the “Levels of detail” drop-down list, choose a logging level.
In the “Directory path for log files” field, enter the name of the directory to hold your log files.
In the “File size for each log” field, enter your maximum log-file size.
In the “Create new log every” field, enter a number for the log-rotation schedule.
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.
In the “When total log size exceeds” field, enter the total storage limit you want.
In the “When free disk space is less than” field, enter the minimum amount of free disk space you want to reserve.
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
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.
Run the following configutil command:
configutil -o logfile.service.logdir -v dirpath |
Run the following configutil command:
configutil -o logfile.service.maxlogfilesize -v size |
where size specifies a number of bytes.
Run the following configutil command:
configutil -o logfile.service.rollovertime -v number |
where number specifies a number of seconds.
Run the following configutil command:
configutil -o logfile.service.maxlogfiles -v number |
where number specifies the maximum number of log files.
Run the following configutil command:
configutil -o logfile.service.maxlogsize -v number |
where number specifies a number in bytes.
Run the following configutil command:
configutil -o logfile.service.minfreediskspace -v number |
where number specifies a number in bytes.
configutil -o logfile.service.expirytime -v number |
where number specifies a number in seconds.
Follow these steps to search for logged events with specific characteristics belonging to a given service:
In Console, open the Messaging Server whose log files you want to inspect.
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.
The Content tab for that logged service is displayed.
In the Log filename field, select the log file you want to examine.
Click the View selected log button to open the Log Viewer window.
In the Log Viewer window, specify your desired search parameters (described in the previous section, Search Parameters).
Click Update to perform the search and display the results in the Log entry field.