43.2 Using the MTA Web Console

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

43.2.1 Setting Up the MTA Web Console

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

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

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

    MTA Network Address property page

    If you configured the MTA for TCP/IP links during installation, the TCP/IP Address field should display the MTA server’s network address. If it does not, follow the instructions in Using TCP/IP Links between Domains. The MTA must be configured for TCP/IP in order to provide the MTA 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 MTA Web console.

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

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

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

  6. If you want to use an SSL connection for the MTA 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 MTA Web console, you can provide a user name and password.

  8. Click GroupWise > Agent Settings to display the Agent Settings page.

    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 an eDirectory user name and password because the information passes over the non-secure connection between your Web browser and the MTA.

      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.

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

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

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

43.2.2 Accessing the MTA Web Console

To monitor the MTA from your Web browser, view the URL where the MTA is located by supplying the network address and port number as provided in ConsoleOne. For example:

http://172.16.5.18:7100
http://172.16.5.18:7180
http://server1:7100
https://server2:7180

When viewing the MTA Web console, you can specify either the message transfer port or the HTTP port.

MTA Web Console

43.2.3 Monitoring the MTA from the MTA Web Console

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

Monitoring MTA Status

When you first access the MTA Web console, the Status page is displayed. Online help throughout the MTA Web console helps you interpret the information being displayed and use the links provided.

MTA Web Console with the Status Page Displayed

Click the Router link to display details about the MTA routing queue (gwinprog). You can quickly determine how many messages are awaiting processing, how large they are, and how long they have been waiting in the routing queue.

Click a closed location to display its holding queue to see how many messages are waiting for transfer.

Checking the MTA Operating System Environment

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

On a Linux server, the following information is displayed:

MTA Web Console with the Environment Page Displayed for a Linux Server

On a Windows server, the following information is displayed:

MTA Web Console with the Environment Page Displayed for a Windows Server

Viewing and Searching MTA Log Files

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

MTA Web Console with the Event Log Filter 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.

In the Message Type list, you can select one or more types of MTA processing to search for:

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

Monitoring the Routing Queue

On the MTA Web console menu, click Status, then click Router to display the contents of the routing queue. Typically, no message files are waiting unless the MTA is down or backlogged.

MTA Web Console with the Router Queue Page Displayed

You can click any queue to view the message files it contains.

Monitoring Links

On the MTA Web console menu, click Links to monitor the direct links between the MTA and other locations.

MTA Web Console with the Links Page Displayed

Click a location to view its holding queue. Click View Link Configuration to determine the address of each location and access the agent Web consoles of other domains and of post offices that belong to the local domain. Click View TCP/IP Connections to view incoming and outgoing TCP/IP links. Click View Gateways to restrict the list to just gateways.

Tracking Messages

Before you can track messages at the MTA Web console, you must enable message logging for MTAs throughout your system. See Section 42.4.2, Enabling MTA Message Logging. When you enable MTA message logging, the MTA stores data about GroupWise message traffic as it processes messages. The stored data is then available for use from the MTA Web console.

To track a specific message, have the sender check the Sent Item Properties for the message in the GroupWise client. The Mail Envelope Properties field displays the message ID of the message; for example, 3AD5EDEB.31D : 3 : 12763. To track all messages sent by a particular user, make a note of the user’s GroupWise user ID.

On the MTA Web console menu, click Message Tracking.

MTA Web Console with the Message Tracking Page Displayed

Fill in one of the fields, depending on what you want to track, then click Submit. The results of the search are displayed on a separate page which can be printed.

43.2.4 Controlling the MTA from the MTA Web Console

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

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

Changing MTA Configuration Settings

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

MTA Web Console with the Configuration Page Displayed

Click the Event Log Settings heading to change the MTA log settings for the current MTA session.

Controlling the MTA Admin Thread

On the Configuration page, click Admin Task Processing.

MTA Web Console with the Admin Task Status Page Displayed

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

Controlling Links to Other Locations

On the MTA Web console menu, click Links.

MTA Web Console with the Links Page Displayed

Select one or more locations, then click Suspend or Resume as needed.