37.3 Using POA Log Files

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:

37.3.1 Locating 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.

37.3.2 Configuring POA Log Settings and Switches

The following aspects of logging are configurable:

You can configure the log settings in the following ways:

37.3.3 Viewing POA Log Files

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.

37.3.4 Interpreting POA Log File Information

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.