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 agent console, which can only be accessed from the server where the MTA is running.
- Setting Up the MTA Web Console
- Accessing the MTA Web Console
- Monitoring the MTA from the MTA Web Console
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 in ConsoleOne.
-
In ConsoleOne, browse to and right-click the MTA object, then click Properties.
-
Click GroupWise > Network Address to display the Network Address 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.
-
Make a note of the IP address or DNS hostname in the TCP/IP Address field. You will need this information to access the MTA Web console.
The HTTP Port field displays the default port number of 7180.
-
If the default HTTP port number is already in use on the MTA server, specify a unique port number.
-
Make a note of the HTTP port number. You will need this information to access the POA Web console.
-
If you want to use an SSL connection for the MTA Web console, select Enabled in the HTTP SSL drop-down list.
For additional instructions about using SSL connections, see Encryption and Certificates.
-
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.
-
Click GroupWise > Agent Settings to display the Agent Settings age.
-
In the HTTP Settings box:
-
In the HTTP User Name field, specify a unique username.
-
Click Set Password.
-
Type the password twice for verification.
-
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.
-
-
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 could 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.
Accessing the MTA Web Console
To monitor the MTA from your Web browser, view the MTA Web console by supplying the network address and port number as provided in ConsoleOne. For example:
http://123.456.78.90:7100
http://123.456.78.90: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.
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.
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 is 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:
On a Linux server, the following information is displayed:
On a Windows server, the following information is displayed:
Viewing and Searching MTA Log Files
On the MTA Web console menu, click Log Files to display and search MTA log files.
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 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 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 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 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.
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.
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 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.
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.
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
- Controlling the MTA Admin Thread
- Controlling Links to Other Locations
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.
Click the Event Log Settings heading to change the MTA log settings for the current MTA session.
