37.2 Using the POA Web Console

The POA Web console enables you to monitor and control the POA from any location where you have access to a Web browser and the Internet. This provides substantially more flexible access than the POA server console, which can only be accessed from the server where the POA is running.

37.2.1 Setting Up the POA Web Console

The default HTTP port for the POA Web console is established during POA installation. You can change the port number and increase security after installation in ConsoleOne.

  1. In ConsoleOne, browse to and right-click the POA object, then click Properties.

  2. Click GroupWise > Network Address to display the Network Address page.

    POA Network Address property page

    If you configured the POA for TCP/IP links during installation, the TCP/IP Address field should display the POA server’s network address. If it does not, follow the instructions in Using TCP/IP Links between the Post Office and the Domain. The POA must be configured for TCP/IP in order to provide the POA Web console.

  3. Make a note of the IP address or DNS hostname in the TCP/IP Address field. You need this information to access the POA Web console.

    The HTTP Port field displays the default port number of 7181.

  4. If the default HTTP port number is already in use on the POA server, specify a unique port number.

  5. Make a note of the HTTP port number. You need this information to access the POA Web console.

  6. If you want to use an SSL connection for the POA Web console, which provides optimum security, select Enabled in the HTTP SSL drop-down list.

    For additional instructions about using SSL connections, see Section 83.2, Server Certificates and SSL Encryption.

  7. Click Apply to save your changes on the Network Address page.

    If you want to limit access to the POA Web console, or if you want to be able to change configuration settings at the POA Web console, you must provide a user name and password.

    IMPORTANT:Some fields in the POA Web console are displayed only when the Web console is password protected.

  8. Click GroupWise > Agent Settings, then scroll down to HTTP Settings.

    Agent Settings property page
  9. In the HTTP Settings box:

    1. In the HTTP User Name field, specify a unique user name.

    2. Click Set Password.

    3. Type the password twice for verification.

    4. Click Set Password.

      Unless you are using an SSL connection, do not use a Novell eDirectory user name and password because the information passes over the non-secure connection between your Web browser and the POA.

      For convenience, use the same user name and password for all agents that you plan to monitor from GroupWise Monitor. This saves you from having to provide the user name and password information as Monitor accesses each agent.

      IMPORTANT:A user name and password are required in order for you to change POA configuration settings in the POA Web console.

  10. Click OK to save the POA Web console settings.

    ConsoleOne then notifies the POA to restart so the new settings can be put into effect.

Corresponding Startup Switches: You can also use the ‑‑httpport, ‑‑httpuser, ‑‑httppassword, and ‑‑httpssl startup switches in the POA startup file to enable and secure the POA Web console. In addition, you can use the ‑‑httprefresh switch to control how often the POA refreshes the information provided to your Web browser.

37.2.2 Accessing the POA Web Console

To monitor the POA from your Web browser, view the URL where the POA is located by supplying the network address and port number as displayed on the Network Address page in ConsoleOne. For example:

http://172.16.5.18:1677
http://172.16.5.18:7181
http://server1:7181
https://server2:1677

When viewing the POA Web console, you can specify either the client/server port or the HTTP port.

POA Web Console

37.2.3 Monitoring the POA from the POA Web Console

The POA Web console provides several pages of information to help you monitor the performance of the POA. The title bar at the top of the POA Web console displays the name of the POA and its post office. Below the title bar appears the POA Web console menu that lists the pages of information available in the POA Web console. Online help throughout the POA Web console helps you interpret the information being displayed and use the links provided.

Monitoring POA Status

When you first access the POA Web console, the Status page is displayed. Online help on the Status page helps you interpret the status information being displayed.

POA Web Console with the Status Page Displayed

Click any hyperlinked status items for additional details. The status information is much the same as that provided at the POA server console, as described in Section 37.1.1, Monitoring the POA from the POA Server Console.

Monitoring and Tracking POA Threads

The POA Status page provides links to detailed POA thread status for the following types of threads:

  • C/S handler threads

  • Message worker threads

  • GWCheck worker threads

  • SOAP threads

  • Calendar Publishing threads

POA Web Console with the C/S Handler Threads Page Displayed

The Thread ID column provides the information you need in order to track a specific thread through one or more POA log files, as described in Viewing and Searching POA Log Files.

Checking the POA Operating System Environment

On the POA Web console menu, click Environment to display information about the operating system where the POA is running.

On a Linux server, the following information is displayed:

POA Web Console Environment Page for a Linux Server

On a Windows server, the following information is displayed:

POA Web Console Environment Page for a Windows Server

Viewing and Searching POA Log Files

On the POA Web console menu, click Log Files to display and search POA log files.

POA Web Console with the Log Files Page Displayed

To view a particular log file, select the log file, then click View Events.

To search all log files for a particular string, type the string in the Events Containing field, select Select All, then click View Events. You can also manually select multiple log files to search.

The results of the search are displayed on a separate page that can be printed.

Listing POA Scheduled Events

On the POA Web console menu, click Scheduled Events to view currently scheduled events and their status information.

POA Web Console with the Scheduled Events Page Displayed

QuickFinder indexing and remote downloadable Address Book generation can be controlled using links from the Configuration page, if the POA Web console is password protected as described in Section 37.2.1, Setting Up the POA Web Console. The Configuration page also displays information about disk check events and database maintenance events. However, scheduled events must be created and modified using ConsoleOne.

Checking Link Status to the MTA

On the POA Web console menu, click MTP Status to view status information about the link between the POA for the post office and MTA for the domain.

POA Web Console with the MTP Status Page Displayed

If the POA Web console is password protected as described in Section 37.2.1, Setting Up the POA Web Console, the Outbound TCP/IP link displays the MTA Web console where you can get status information about the MTA. The Hold link displays the contents of the MTA input queue, so you can find out if messages are waiting for processing by the MTA.

Taking Performance Snapshots

To help you assess the efficiency of the POA, you can configure the POA to gather statistics about CPU utilization, disk reads and writes, thread usage, message processing, and so on.

  1. Make sure that the POA Web console is password protected, as described in Section 37.2.1, Setting Up the POA Web Console.

  2. In the POA Web console, on the Configuration page, click Performance Snapshots under the Performance Settings heading.

    Performance Snapshots page
  3. Select Start, then click Submit.

    Performance Snapshots page

    The POA takes a snapshot every 60 seconds.

  4. Refresh your browser window to display data as it is collected.

  5. Specify the interval at which you want to write data to a file on disk for permanent storage.

    Performance data is saved to the mmddsnap.nnn file, where mmdd represents the current month and date and nnn starts with 001 and increments each time you enable performance snapshots to start gathering data. The performance data file is stored in the post_office\oftemp directory in comma-separated value (CSV) format, so that you can bring the data into a spreadsheet program for analysis.

  6. When you have gathered sufficient performance data, select Stop, then click Submit.

    Because gathering performance data uses POA resources, you should turn the feature off when you have gathered sufficient data. It is turned off automatically when you restart the POA.

  7. When you are finished using performance data files, delete them to conserve disk space.

    The POA does not automatically clean up old performance data files.

Monitoring SOAP Events

To help you work with third-party listener applications such as the Data Synchronizer Connector for GroupWise, the POA Web console lists SOAP notifications and SOAP events so that you can monitor the SOAP event traffic through the POA. These options are available if the POA Web console is password protected, as described in Section 37.2.1, Setting Up the POA Web Console.

Listing SOAP Notifications

The SOAP Notification List page shows the third-party listener applications that are notified by the POA when SOAP events occur.

  1. On the Configuration page, click SOAP Notification List.

    SOAP Notification LIst page

    The columns provide the following information:

    User: Displays the name of the GroupWise user that is performing the event.

    Key: Displays the ID of the event configuration created by the third-party application. The event configuration describes the events that are being tracked for the user, such as creation, deletion, or modification of records.

    IP Address: Displays the IP address of the POA where the event took place.

    Port: Displays the port number used for communication between the POA and the listener application.

    Date/Time: Displays the date and time when the event took place. An asterisk (*) after the date and time indicates that the user has pending notifications. After the notifications have been sent, the asterisk is removed.

Listing SOAP Event Configurations

The Event Configuration List page displays the event configurations that are registered to receive GroupWise events from the POA. An event configuration is listed when an external application such as the Novell Data Synchronizer Connector for GroupWise communicates with the POA and provides information about a specific type of event that it wants to receive.

For example, the Data Synchronizer Connector for Mobility works through the GroupWise Connector to synchronize GroupWise data to mobile devices. Whenever a user connects a mobile device to GroupWise through the Mobility Connector, an event configuration is created for that user and his or her mobile device. If the user has multiple mobile devices, there is an event configuration for each of the user's mobile devices.

  1. On the Configuration page, click Event Configuration List.

    Event Configuration List page

    The columns provide the following information:

    UserID: Displays the name of the GroupWise user associated with the event configuration.

    Key: Displays the ID of the event configuration created by the external application. For example, the GroupWise Connector uses a GroupWise trusted application key.

    IP Address: Displays the IP address of the external application that the POA notifies when events take place.

    Port: Displays the port number used for communication between the POA and the external application.

    Events: Displays the number of events that have transferred from the POA to the external application.

  2. To manage the event configuration for a specific user, click the user name.

    Event Configuration page

    The Event Configuration page helps you manage an event configuration and the associated events that are stored in a user's database for an external application such as the Data Synchronizer Connector for GroupWise.

  3. Select Add to Notification List, then click Submit to cause the POA to notify the external application whenever a new GroupWise event needs to be picked up.

  4. Select Show Events, then click Submit to display the currently stored events for the event configuration.

    If the list is long, the external application might not be running.

  5. Select Delete Events, then click Submit to delete any stored events for the event configuration.

    Use this option only when a backlog of events needs to be cleared, such as when a problem occurred with the external application.

  6. Click Delete Event Configuration, then click Submit to delete the displayed event configuration.

    Use this option when the POA no longer needs to send events for the user associated with the event configuration. For example, if there was a problem removing a user from the GroupWise Connector, use this option to remove any residual events associated with the user.

37.2.4 Controlling the POA from the POA Web Console

At the POA Web console, you can change some POA configuration settings for the current POA session. You can also stop and start some specific POA threads.

IMPORTANT:In order to control the POA from the POA Web console, you must set up authentication for the POA Web console, as described in Section 37.2.1, Setting Up the POA Web Console.

Changing POA Configuration Settings

On the POA Web console menu, click Configuration. Online help on the Configuration page helps you interpret the configuration information being displayed.

POA Web Console with the Configuration Page Displayed

If the POA Web console is password protected as described in Section 37.2.1, Setting Up the POA Web Console, you can click hyperlinked configuration items to change settings for the current agent session. The settings that can be modified are much the same as those that can be changed at the POA server console, as described in Section 37.1.2, Controlling the POA from the POA Server Console.

Controlling the POA Admin Thread

On the Configuration page, click Admin Task Processing.

POA Web Console with the Admin Task Status Page Displayed

Modify the functioning of the POA admin thread as needed, then click Submit. The changes remain in effect for the current POA session.

Controlling the POA MTP Threads

On the Configuration page, click Message Transfer Protocol.

POA Web Console with the Message Transfer Protocol Settings Page Displayed

On this page, you can restart MTA processing between the POA and the MTA. On the MTP status page, you can restart the send and receive threads separately.

Disconnecting a User Session from the POA

In Online mode, the GroupWise Windows client establishes an active session with the POA. If you disable a user, as described in Section 14.9, Disabling and Enabling GroupWise Accounts while the user is logged in, it does not terminate the user’s live session with the POA. Instead of needing to restart the POA to terminate the user’s live session, you can disconnect the user in the POA Web console after disabling the user in ConsoleOne.

On the Status page in the POA Web console, click C/S Users, then click Disconnect User for the user that you have already disabled in ConsoleOne.

POA Web Console with Disconnect User Link

IMPORTANT:When you disable the user in ConsoleOne, the POA must receive the disable event and process it before the user can be disconnected in the POA Web console. If you are running the POA server console, you can see the disable event occur in the Log Message box. When you click Disconnect User successfully, the user is no longer listed in the POA Web console. If the user does not disappear from the list after you click Disconnect User, wait for the POA to process the disable event, then click Disconnect User again. A disconnected user receives an error message stating that GroupWise will exit.