Error messages and other information about POA functioning are written to log files as well as displaying on the POA server console. Log files can provide a wealth of information for resolving problems with POA functioning or message flow. This section covers the following subjects to help you get the most from POA log files:
The default location of the POA log files varies by platform:
You can change the location where the POA creates its log files, as described in Configuring POA Log Settings and Switches.
The following aspects of logging are configurable:
Log File Path (‑‑log)
Disk Logging (‑‑logdiskoff)
Logging Level (‑‑loglevel)
Maximum Log File Age (‑‑logdays)
Maximum Log File Size (‑‑logmax)
You can configure the log settings in the following ways:
Using ConsoleOne to establish defaults (see Section 36.1.8, Adjusting the POA Logging Level and Other Log Settings)
Using startup switches to override ConsoleOne settings (see Section 40.0, Using POA Startup Switches)
Using the POA server console to override log settings for the current POA session (see Adjusting POA Log Settings)
Using the POA Web console to override other settings for the current POA session (see Section 37.2.4, Controlling the POA from the POA Web Console)
You can view the contents of the POA log file from the POA server console and POA Web console. See the tasks presented in Section 37.1.1, Monitoring the POA from the POA Server Console:
On Linux, you can use the tail command to monitor a file named poa.currentlog, where poa is the name of the POA eDirectory object. This file is a symbolic link to the current POA log file, so that you do not need to keep track of the exact POA log file name, which includes the log file creation date and an incrementing extension for multiple log files created on the same date.
On startup, the POA records the POA settings currently in effect. Thereafter, it logs events that take place, including errors. To look up error messages that appear in POA log files, see Post Office Agent Error Messages
in GroupWise 2012 Troubleshooting 3: Message Flow and Directory Structure.
Because the POA consists of multiple threads, you might find it useful to retrieve the log file into an editor and sort it on the thread ID that follows the date and time information. Sorting groups all messages together for the same POA thread. You can also use the search capability of the POA Web console to gather information about a specific POA thread. See Viewing and Searching POA Log Files.