37.1 Using the POA Server Console

The following topics help you monitor and control the POA from the POA server console:

37.1.1 Monitoring the POA from the POA Server Console

The POA server console provides information, status, and message statistics about the POA to help you assess its current functioning.

POA Server Console

Linux:

You must use the ‑‑show startup switch in order to display the Linux POA server console. See Starting the Linux Agents with a User Interface in Installing GroupWise Agents in the GroupWise 2012 Installation Guide.

Windows:

You can suppress the Windows POA server console by running the POA as a service. See Starting the Windows GroupWise Agents in Installing GroupWise Agents in the GroupWise 2012 Installation Guide.

The POA server console consists of several components:

You can minimize the POA server console, but do not close it unless you want to stop the POA.

POA Information Box

The POA Information box identifies the POA whose POA server console you are viewing, which is especially helpful when multiple POAs are running on the same server.

PostOffice.Domain: Displays the name of the post office serviced by this POA, and what domain it is linked to.

Description: Displays the description provided in the Description field in the POA Identification page in ConsoleOne. When you run multiple POAs on the same server, the description should uniquely identify each one. If multiple administrators work at the server where the POA runs, the description could include a note about who to contact before stopping the POA.

Up Time: Displays the length of time the POA has been running.

POA Web Console The Status page also displays this information.

POA Status Box

The POA Status box displays the current status of the POA and its backlog. The information displayed varies depending on whether the POA is processing client/server connections, message files, both, or neither.

Processing: Displays a rotating bar when the POA is running. If the bar is not rotating, the POA has stopped. For assistance, see Post Office Agent Problems in GroupWise 2012 Troubleshooting 2: Solutions to Common Problems.

Busy: Displays the number of POA threads currently in use (busy) for client/server connections, message files, or both, depending on POA configuration. In a typical POA configuration, the number to the left of the colon is the number of busy client/server threads and the number to the right of the colon is the number of busy message handler threads. You can change the total number of threads available. See Section 38.1.2, Adjusting the Number of Connections for Client/Server Processing and Section 38.2.1, Adjusting the Number of POA Threads for Message File Processing.

User Connections (for client/server processing): Displays the number of active application (“virtual”) TCP/IP connections between the POA and the GroupWise clients run by GroupWise users. You can change the maximum number of user connections. See Section 38.1.2, Adjusting the Number of Connections for Client/Server Processing.

Physical Connections (for client/server processing): Displays the number of active physical TCP/IP connections between the post office and the GroupWise clients run by GroupWise users. You can change the maximum number of physical connections. See Section 38.1.2, Adjusting the Number of Connections for Client/Server Processing.

Priority Queues (for message file processing): Displays the number of messages waiting in the high priority message queues. You can control the number of threads processing message files. See Section 38.2.1, Adjusting the Number of POA Threads for Message File Processing.

Normal Queues (for message file processing): Displays the number of messages waiting in the normal priority message queues. You can control the number of threads processing message files. See Section 38.2.1, Adjusting the Number of POA Threads for Message File Processing.

File Queues (for message file processing): Displays the total number of messages waiting in all message queues, when client/server information and message file information are displayed together.

The number of messages displayed as waiting in message queues is not an exact count. For example, if the POA detects numerous messages to process in the priority 4 queue (normal messages), it does not scan and count messages in lower priority queues. Therefore, actual counts of message files waiting in queues could be higher than the counts displayed in the Status box.

For information about the various message queues in the post office, see Post Office Directory in GroupWise 2012 Troubleshooting 3: Message Flow and Directory Structure.

POA Web Console: The Status page also displays the status information listed above. In addition, you can display detailed information about specific queue contents.

POA Statistics Box

The POA Statistics box displays statistics showing the current workload of the POA. The information displayed varies depending on whether the POA is processing client/server connections, message files, both, or neither.

C/S Requests (for client/server processing): Displays the number of active client/server requests between GroupWise clients and the POA.

Requests Pending (for client/server processing): Displays the number of client/server requests from GroupWise clients the POA has not yet been able to respond to. If the number is large, see POA Statistics Box Shows Requests Pending in Post Office Agent Problems in GroupWise 2012 Troubleshooting 2: Solutions to Common Problems.

Users Timed Out (for client/server processing): Displays the number of GroupWise clients no longer communicating with the POA. If the number is large, see POA Statistics Box Shows Users Timed Out in Post Office Agent Problems in GroupWise 2012 Troubleshooting 3: Message Flow and Directory Structure.

Message Files (for message file processing): Displays the total number of messages processed by the POA. This includes user messages, status messages, and service requests processed by the POA.

Undeliverable (for message file processing): Displays the number of messages that could not be delivered because the user was not found in that post office or because of other similar problems. Senders of undeliverable messages are notified. For assistance, see Message Has Undeliverable Status in Strategies for Message Delivery Problems in GroupWise 2012 Troubleshooting 2: Solutions to Common Problems.

Problem Messages (for message file processing): Displays the number of invalid message files that have problems not related to user error. It also displays requests the POA cannot process because of error conditions. For assistance, see Message Is Dropped in the problem Directory in Strategies for Message Delivery Problems in GroupWise 2012 Troubleshooting 2: Solutions to Common Problems.

Users Delivered: Displays the number of user messages delivered to recipients in the post office. A message with six recipients in the local post office is counted six times.

Statuses: Displays the number of status messages delivered to recipients in the post office.

Rules Executed: Displays the number of users’ rules executed by the POA.

POA Web Console: The Status page also displays this information. In addition, you can display detailed information about client/server connections and message file processing.

POA Log Message Box

The POA Log Message box displays the same information that is being written to the POA log file. The amount of information displayed in the POA Log Message box depends on the current log settings for the POA. See Section 37.3, Using POA Log Files. The information scrolls up automatically.

Windows Note: To stop the automatic scrolling, click Log, then deselect Auto Scroll. You can then use the scroll bar to browse through the contents of the log message box.

POA Web Console: You can view and search POA log files on the Log Files page.

Informational Messages

When you first start the POA, you typically see informational messages that list current agent settings, current number of threads, TCP/IP options (client/server), and scheduled events. As the POA runs, it continues to provide status and delivery information in the POA Log Message box.

Error Messages

If the POA encounters a problem processing a message, it displays an error message in the POA Log Message box. See Post Office Agent Error Messages in GroupWise 2012 Troubleshooting 1: Error Messages.

POA Admin Thread Status Box

The POA admin thread updates the post office database (wphost.db) when users and/or user information are added, modified, or removed, and repairs it when damage is detected.

To display the POA Admin Thread Status box from the POA server console, click Configuration > Admin Status.

Admin Status Dialog Box

The following tasks pertain specifically to the POA admin thread:

POA Web Console: You can display POA admin thread status on the Configuration page. Under the General Settings heading, click Admin Task Processing. If the POA Web console is password protected as described in Section 37.2.1, Setting Up the POA Web Console, you can change the admin settings for the current POA session.

37.1.2 Controlling the POA from the POA Server Console

You can perform the following tasks to monitor and control the POA from the POA server console at the server where the POA is running:

Stopping the POA

You might need to stop and restart the POA for the following reasons:

  • Updating the agent software

  • Troubleshooting message flow problems

  • Backing up GroupWise databases

  • Rebuilding GroupWise databases

To stop the POA from the POA server console:

  1. Click File > Exit > Yes.

    Linux:

    If the Linux POA does not respond to Exit, follow the instructions in Stopping the Linux POA When It Is Running As a Daemon.

    Windows:

    If the Windows POA does not respond to Exit, you can close the POA server console to stop the POA or use the Task Manager to terminate the POA task.

  2. Restart the POA, as described in the following sections in the GroupWise 2012 Installation Guide:

Stopping the Linux POA When It Is Running As a Daemon

To stop the Linux POA when it is running in the background as a daemon and you started it using the grpwise script:

  1. Make sure you are logged in as root.

  2. Enter the following command:

    rcgrpwise stop

  3. Use the following command to verify that the POA has stopped.

    rcgrpwise status

To stop the Linux POA when it is running in the background as a daemon and you started it manually (not using the grpwise script):

  1. Make sure you are logged in as root.

  2. Determine the process IDs (PIDs) of the POA:

    ps -eaf | grep gwpoa

    The PIDs for all gwpoa processes are listed.

    You can also obtain this information from the Environment page of the POA Web console.

  3. Kill the first POA process listed:

    Syntax: kill PID

    Example: kill 1483

    It might take a few seconds for all POA processes to terminate.

  4. Use the ps command to verify that the POA has stopped.

    ps -eaf | grep gwpoa

  5. (Conditional) If the initial kill command does not stop the POA, use the following command:

    Syntax: kill -9 PID

    Example: kill -9 1483

Suspending/Resuming the POA Admin Thread

You can cause the POA to stop accessing the post office database (wphost.db) without stopping the POA completely. For example, you could suspend the POA admin thread while backing up the post office database.

To suspend the POA admin thread:

  1. At the POA server console, click Configuration > Admin Status.

  2. Click Suspend.

The POA admin thread no longer accesses the post office database until you resume processing.

To resume the POA admin thread:

  1. At the POA server console, click Configuration > Admin Status.

  2. Click Resume.

POA Web Console: If the POA Web console is password protected as described in Section 37.2.1, Setting Up the POA Web Console, you can suspend and resume the POA admin thread from the Configuration page. Under the General Settings heading, click Admin Task Processing > Suspend or Resume > Submit.

Displaying the POA Software Date

It is important to keep the POA software up-to-date. You can display the date of the POA software from the POA server console.

  1. At the server where the POA is running, display the POA server console.

  2. Click Help > About POA.

POA Web Console: You can check the POA software date on the Environment page.

Displaying Current POA Settings

You can list the current configuration settings of the POA at the POA server console.

  1. At the server where the POA is running, display the POA server console.

  2. Click Configuration > Agent Settings.

    The configuration information displays in the log message box and is written to the log file.

    If information you need scrolls out of the log message box, you can scroll back to it. See Browsing the Current POA Log File.

For information about POA configuration settings, see Section 36.0, Configuring the POA and Section 40.0, Using POA Startup Switches.

POA Web Console: You can check the current POA settings on the Configuration page.

Displaying Detailed Statistics about POA Functioning

The POA server console displays essential information about the functioning of the POA. More detailed information is also available.

  1. At the server where the POA is running, display the POA server console.

  2. Click Statistics > Misc. Statistics.

  3. Review the Detailed Statistics dialog box. The following statistics are displayed and written to the log file for the current POA up time:

    • Databases rebuilt

    • Users deleted

    • Users moved

    • Moved messages processed

    • Statuses processed

POA Web Console: You can display statistics on the Status page.

Displaying Client/Server Information

When the POA and the GroupWise clients communicate in client/server mode, you can display statistics to indicate the performance level of the TCP/IP communication.

  1. At the server where the POA is running, display the POA server console.

  2. Click Statistics > Client/Server.

  3. In the menu, click the type of statistics to display.

    The selected type of statistics for the current POA up time are listed in the message log box and are written to the POA log file.

    If information you need scrolls out of the log message box, you can scroll back to it. See Browsing the Current POA Log File.

    All Statistics: Lists the information for General Statistics, Throughput, Physical Connections, and Application Connections, as described below.

    General Statistics: Lists the DNS address and IP address of the server, along with the TCP port for the POA, the number of messages received, sent, and aborted, and the number of physical and application connections active and allowed.

    Show Throughput: Lists the total number of messages processed by the POA for all users. Statistics are provided for the current elapsed time and as a per second average.

    Clear Throughput: Resets the current elapsed time to zero.

    Physical Connections: Lists the currently active physical connections. Physical connections are active TCP connections created whenever GroupWise users do something that requires communication and closed when the specific activities have been completed. By listing the physical connections, you can see what users are actively using GroupWise and how much throughput each user is generating. Users’ IP addresses are also listed.

    Application Connections: Lists the currently active application connections. Every user that starts GroupWise has an application connection for as long as GroupWise is running, even if GroupWise is not actively in use at the moment. By listing the application connections, you can see what users have started GroupWise and how much throughput each user is generating. Users’ IP addresses are also listed.

    Show Redirection List: Lists all POAs in your GroupWise system and indicates whether each is configured for TCP/IP. The list includes the IP address of each POA and the IP address of its proxy server outside the firewall, if applicable. This redirection information is obtained from the post office database (wphost.db).

    Check Redirection List: Attempts to contact each POA in your GroupWise system and reports the results. If a POA is listed as “Connection Failed,” see Post Office Agent Problems in GroupWise 2012 Troubleshooting 2: Solutions to Common Problems.

POA Web Console: You can display client/server information on the Configuration page. You can list client/server users from the Status page using the C/S Users and Remote/Caching Users links.

Listing Message Queue Activity

The POA uses eight queues to process message files. You can view the activity in each of these queues. For more information about message queues, see Post Office Directory in GroupWise 2012 Troubleshooting 3: Message Flow and Directory Structure.

  1. At the server where the POA is running, display the POA server console.

  2. Click Actions > View MF Queues.

  3. View the queue activity in the message log box. Use the scroll bar if necessary to scroll through the information.

    If information you need scrolls out of the log message box, you can scroll back to it. See Browsing the Current POA Log File.

    The information is also written to the POA log file.

You can check queue activity on the Status page. Under the Thread Status heading, click the type of thread to view queue activity for.

Displaying Message Transfer Status

When the POA links to the MTA by way of TCP/IP, you can view the status of the TCP/IP link from the POA server console.

  1. At the server where the POA is running, display the POA server console.

  2. Click Configuration > Message Transfer Status.

  3. View the following information about the TCP/IP link:

    Outbound TCP/IP Address: Displays the TCP/IP address and port where the MTA listens for messages from the POA.

    Inbound TCP/IP Address: Displays the TCP/IP address and port where the POA listens for messages from the MTA.

    Hold Directory: Displays the path to the directory where the POA stores messages if the TCP/IP link to the MTA is closed.

    Current Status: Lists the current status of the TCP/IP link.

    • Open: The POA and the MTA are successfully communicating by way of TCP/IP.

    • Closed: The POA is unable to contact the MTA by way of TCP/IP

    • Unavailable: The POA is not yet configured for TCP/IP communication with the MTA.

    • Unknown: The POA is unable to contact the MTA in any way.

    Messages Written: Displays the number of messages the POA has sent.

    Message Read: Displays the number of messages the POA has received.

    Last Closure Reason: Provides an explanation for why the post office was last closed. For assistance resolving closure problems, see Post Office Agent Error Messages in GroupWise 2012 Troubleshooting 1: Error Messages.

POA Web Console: You can display message transfer status on the MTP Status page.

Restarting the MTP Thread

When the POA links to the MTA by way of TCP/IP, you can restart the Message Transfer Protocol (MTP) thread that provides the link between the POA and the MTA.

  1. At the server where the POA is running, display the POA server console.

  2. Click Actions > Restart MTP.

POA Web Console: If the POA Web console is password protected as described in Section 37.2.1, Setting Up the POA Web Console, you can restart the MTA thread from the Configuration page. Click Message Transfer Protocol > Restart MTP > Submit. In addition, you can control the send and receive threads separately on the MTP Status page. In the Send or Receive column, click the current status, then click Stop/Start MTP Send/Receive > Submit.

Displaying POA Admin Thread Status

Status information for the POA admin thread is displayed in a separate dialog box, rather than on the main POA server console.

  1. At the server where the POA is running, display the POA server console.

  2. Click Configuration > Admin Status.

    The following admin status information is displayed:

    Admin Message Box

    The Admin Message box provides the following information about the workload of the POA admin thread:

    Completed: Number of administrative messages successfully processed.

    Errors: Number of administrative messages not processed because of errors.

    In Queue: Number of administrative messages waiting in the queue to be processed.

    Send Admin Mail: Select this option to send a message to the administrator whenever a critical error occurs. See Section 37.7, Notifying the GroupWise Administrator.

    Admin Database Box

    The Admin Database box provides the following information about the post office database (wphost.db):

    Status: Displays one of the following statuses:

    • Normal: The POA admin thread is able to access the post office database normally.

    • Recovering: The POA admin thread is recovering the post office database.

    • DB Error: The POA admin thread has detected a critical database error. The post office database cannot be recovered. Rebuild the post office database in ConsoleOne. See Section 26.3, Rebuilding Domain or Post Office Databases.

      The POA admin thread does not process any more administrative messages until the database status has returned to Normal.

    • Unknown: The POA admin thread cannot determine the status of the post office database. Exit the POA, then restart it, checking for errors on startup.

    DB Sort Language: Displays the language code for the language that determines the sort order of lists displayed in ConsoleOne and the GroupWise Address Book.

    Recovery Count: Displays the number of recoveries performed on the post office database by this POA for the current POA session.

    Admin Thread Box

    The Admin Thread box displays the following information:

    Status: Displays one of the following statuses:

    • Running: The POA admin thread is active.

    • Suspended: The POA admin thread is not processing administrative messages.

    • Starting: The POA admin thread is initializing.

    • Terminated: The POA admin thread is not running.

POA Web Console: You can display POA admin thread status from the Configuration page. Under the General Settings heading, click Admin Task Processing.

Recovering the Post Office Database Automatically or Immediately

The POA admin thread can recover the post office database (wphost.db) when it detects a problem.

To enable or disable automatic post office database recovery:

  1. At the server where the POA is running, display the POA server console.

  2. Click Configuration > Admin Status > Automatic Recovery to toggle this feature on or off for the current POA session.

To change the setting permanently, see Section 36.1.2, Configuring the POA in ConsoleOne.

To recover the post office database immediately:

  1. At the server where the POA is running, display the POA server console.

  2. Click Configuration > Admin Status > Perform DB Recovery.

For additional database repair procedures, see Section 26.0, Maintaining Domain and Post Office Databases.

POA Web Console: If the POA Web console is password protected as described in Section 37.2.1, Setting Up the POA Web Console, you can recover the post office database from the Configuration page. Under the General Settings heading, click Admin Task Processing. Select Automatic Recovery or Perform DB Recovery as needed.

Recovering User and Message Databases Automatically

The POA can automatically recover user databases (userxxx.db) and message databases (msgnnn.db) when it detects a problem because databases can be open during the recover process. This procedure is a “recover” rather than a “rebuild,” because a “rebuild” requires that all users and agents are out of the database being rebuilt. See Section 27.0, Maintaining User/Resource and Message Databases.

To enable/disable automatic message and user database recovery:

  1. At the server where the POA is running, display the POA server console.

  2. Click Actions > Auto Rebuild to toggle this feature on or off for the current POA session.

To change the setting permanently, see Section 36.1.2, Configuring the POA in ConsoleOne.

POA Web Console: You can see whether automatic message and user database recovery is enabled on the Configuration page under the Performance Settings heading.

Updating QuickFinder Indexes

GroupWise uses QuickFinder technology to index messages and documents stored in post offices. You can start indexing from the POA server console. For example, if you just imported a large number of documents, you could start indexing immediately, rather than waiting for the next scheduled indexing cycle.

To update QuickFinder indexes for the post office:

  1. At the server where the POA is running, display the POA server console.

  2. Click Actions > QuickFinder > Update Indexes.

To avoid overloading the POA with indexing processing, a maximum of 1000 items are indexed per database. If a very large number of messages are received regularly, or if a user with a very large mailbox is moved to a different post office (requiring the user’s messages to be added into the new post office indexes), you might need to repeat this action multiple times in order to get all messages indexed. If too many repetitions are required to complete the indexing task, see Section 39.6, Customizing Indexing for assistance.

You can set up indexing to occur at regular intervals. See Section 39.1, Regulating Indexing.

If the indexing load on the POA is heavy, you can set up a separate POA just for indexing. See Section 39.5, Configuring a Dedicated Indexing POA (Windows Only).

POA Web Console: If the POA Web console is password protected as described in Section 37.2.1, Setting Up the POA Web Console, you can update QuickFinder indexes from the Configuration page. Under the General Settings heading, click QuickFinder Indexing.

Compressing QuickFinder Indexes

QuickFinder indexes are automatically compressed at midnight each night to conserve disk space. You can start compression at any other time from the POA server console. For example, if you just imported and indexed a large number of documents and are running low on disk space, you could compress the indexes immediately, rather than waiting for it to happen at midnight.

To compress QuickFinder indexes for the post office:

  1. At the server where the POA is running, display the POA server console.

  2. Click Actions > QuickFinder > Compress Indexes.

POA Web Console: If the POA Web console is password protected as described in Section 37.2.1, Setting Up the POA Web Console, you can compress QuickFinder indexes from the Configuration page. Under the General Settings heading, click QuickFinder Indexing.

Regenerating QuickFinder Indexes

If QuickFinder indexes become damaged, you can easily delete and re-create them.

To re-create QuickFinder indexes for the post office:

  1. At the server where the POA is running, display the POA server console.

  2. Click Actions > QuickFinder > Delete and Regenerate Indexes.

    You can also press Ctrl+Q.

POA Web Console: If the POA Web console is password protected as described in Section 37.2.1, Setting Up the POA Web Console, you can re-create QuickFinder indexes from the Configuration page. Under the General Settings heading, click QuickFinder Indexing.

Browsing the Current POA Log File

In the log message box, the POA displays the same information being written to the POA log file. The amount of information depends on the current log settings for the POA.

The information automatically scrolls up the screen as additional information is written. You can stop the automatic scrolling so you can manually scroll back through earlier information.

To browse the current POA log file and control scrolling:

  1. At the server where the POA is running, display the POA server console.

  2. Click Log > Auto Scroll to toggle automatic scrolling on or off.

For explanations of messages in the POA log file, see Post Office Agent Error Messages in GroupWise 2012 Troubleshooting 1: Error Messages.

See also Section 37.3, Using POA Log Files.

POA Web Console: You can browse and search POA log files on the Log Files page.

Viewing a Selected POA Log File

Reviewing log files is an important way to monitor the functioning of the POA.

  1. At the server where the POA is running, display the POA server console.

  2. Click Log > View Log.

    The following information is provided:

    Log Files: Lists the current POA log files, ordered from the oldest log file at the top to the newest log file at the bottom. The current log file is marked with an asterisk (*).

    Date/Time: Displays the date and time of each POA log file.

    Space Used: Displays the amount of disk space currently occupied by that POA’s log files. You can control the amount of space consumed by POA log files during the current POA session. You can also control the default amount of disk space for POA log files in the POA Log Settings page in ConsoleOne or in the POA startup file. See Section 37.3.2, Configuring POA Log Settings and Switches.

    Log File Directory: Displays the full path of the directory where the POA writes its log files. See Section 37.3.2, Configuring POA Log Settings and Switches.

  3. In the log file list, select the POA log file you want to view.

    Windows Note: For the Windows POA, you can select the viewer to use by providing the full path to the viewer program. The default viewer is Notepad.

  4. Click View.

For explanations of messages in the POA log file, see Post Office Agent Error Messages in GroupWise 2012 Troubleshooting 1: Error Messages.

See also Section 37.3, Using POA Log Files.

POA Web Console: You can view and search POA log files on the Log Files page.

Cycling the POA Log File

You can have the POA start a new log file as needed.

  1. At the server where the POA is running, display the POA server console.

  2. Click Log > Cycle Log.

Adjusting POA Log Settings

Default log settings are established when you start the POA. However, you can adjust the POA log settings for the current session from the POA server console. This overrides any settings provided in ConsoleOne or in the POA startup file. The modified settings remain in effect until you restart the POA, at which time the log settings specified in ConsoleOne or the startup file take effect again.

  1. At the server where the POA is running, display the POA server console.

  2. Click Log > Log Settings.

  3. Adjust the values as needed for the current POA session.

    See Section 37.3, Using POA Log Files.

POA Web Console: If the POA Web console is password protected as described in Section 37.2.1, Setting Up the POA Web Console, you can adjust POA log settings from the Configuration page. Click the Log Settings heading.

Editing the POA Startup File

You can change the configuration of the POA by editing the POA startup file from the POA server console.

  1. At the server where the POA is running, display the POA server console.

  2. Click Configuration > Edit Startup File.

  3. Make the necessary changes, then save and exit the startup file.

  4. Stop and restart the POA.

Accessing Online Help for the POA

Click Help on the menu bar for information about the POA server console. Click the Help button in any dialog box for additional information.