42.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.

42.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 71.0, Encryption and Certificates.

  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 username 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 username.

    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 username and password because the information passes over the insecure connection between your Web browser and the MTA.

      For convenience, use the same username and password for all agents that you plan to monitor from GroupWise Monitor. This saves you from having to provide the username 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.

42.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.

Figure 42-3 MTA Web Console

42.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 bar at the top of the MTA Web console displays the name of the MTA and its domain. Below this 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.

Figure 42-4 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 NetWare server, the following information is displayed:

Figure 42-5 MTA Web Console with the Environment Page Displayed for a NetWare Server

On a Linux server, the following information is displayed:

Figure 42-6 MTA Web Console with the Environment Page Displayed for a Linux Server

On a Windows server, the following information is displayed:

Figure 42-7 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.

Figure 42-8 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:

Message Logging (MLG): The message logging threads write information into the message log file if message logging has been turned on. See Section 41.4.2, Enabling MTA Message Logging.

Event Logging (LOG): The event logging thread writes information into the event log files that you can search on this page. See Section 42.3, Using MTA Log Files.

Dispatcher (DIS): The dispatcher thread starts other MTA threads as needed to meet the demands being put on the MTA at any given time.

Message Transfer (MTP): The message transfer threads communicate with other MTAs and with POAs in the local domain to transfer messages to domains and post offices to which the local MTA is linked by way of TCP/IP. See Using TCP/IP Links between Domains and Using TCP/IP Links between a Domain and its Post Offices.

Router (RTR): The router threads process messages in the routing queue and prepare them for transfer to the next hop in the link path to their destinations. See Section 43.3, Optimizing the Routing Queue.

Admin (ADM): The admin thread updates the domain database (wpdomain.db) whenever administrative information changes. See MTA Admin Thread Status Box.

Scanner (SCA): The scanner threads check for incoming messages when UNC or mapped links are in use. See Section 43.2.3, Adjusting the Number of MTA Scanner Threads for the Domain and Post Offices.

The results of the search are displayed on a separate page which 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.

Figure 42-9 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.

Figure 42-10 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 41.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.

Figure 42-11 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.

42.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.

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.

Figure 42-12 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.

Figure 42-13 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.

Figure 42-14 MTA Web Console with the Links Page Displayed

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