Novell Doc: GroupWise 8 Administration Guide - Using the Internet Agent Server Console

49.1 Using the Internet Agent Server Console

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

Figure 49-1 Internet Agent Console

NetWare	The Internet Agent console always displays on the NetWare server console.
Linux:	You must use the --show startup switch in order to display the Linux Internet Agent server console.
Windows:	If the Internet Agent is running as a Windows service under the Local System User, it is displayed on the desktop only if the Allow Service to Interact with Desktop option was selected during installation or has been configured on the Internet Agent service’s General property page.

Refer to the following sections for information about the specific sections and functionality included in the console:

49.1.1 Description

The description section of the console identifies the Internet Agent and displays how long its has been running.

Figure 49-2 Internet Agent Server Console

Domain.Gateway: Displays the domain and Internet Agent names.

Up Time: Displays the total length of time the Internet Agent has been running. If the Internet Agent terminates unexpectedly (such as in a power outage), the Up Time display does not reset to 0 (zero). It shows the total time elapsed since the Internet Agent was last loaded after a proper termination.

Description: Displays any descriptive information provided on the Internet Agent object’s Identification page (Internet Agent object > GroupWise > Identification).

49.1.2 Status

The Status section of the console provides a quick look at the Internet Agent’s current message processing activity, network connectivity, and information logging level.

Figure 49-3 Internet Agent Server Console

Processing: Displays a rotating bar if the Internet Agent is running. If there is no bar, or if the bar is stationary for more than one minute, the Internet Agent is not running.

GroupWise: Displays whether the Internet Agent’s network connection is OPEN or CLOSED. This network connection is the Internet Agent’s only link to GroupWise. The status indicates whether or not the Internet Agent can write to the wpcsin directory and access the wpcsout directory. The Internet Agent does a scan each cycle to see if these directories exist. If the status is CLOSED, the Internet Agent attempts to reattach to the network.

It is normal for this field to display the word CLOSED for a minute or so after you start the Internet Agent. However, if the connection remains CLOSED, look for the wpcsin and wpcsout directories. If they are not created yet, start the Message Transfer Agent (MTA).

Other Link: This field does not apply to the Internet Agent. It always says OPEN.

Program: Displays the processing cycle. You can use the Gateway Time Settings page (Internet Agent object > GroupWise > Gateway Time Settings) to adjust the processing cycle.

Log Level: Displays the logging level the Internet Agent is currently using. The logging level determines how much data is displayed on the message portion of this screen and written to the log file. You can use the console menu options to override the default setting for the current session. For information, see Section 49.1.4, Logging

49.1.3 Statistics

The Statistics section of the console can display five different sets of information:

Message Statistics

The Message Statistics section of the console, shown below, is the default statistics section displayed by the Internet Agent console.

Figure 49-4 Internet Agent Server Console

Message Statistics shows the number of inbound and outbound messages processed by the Internet Agent. The Out and In columns display the cumulative message totals and the 10 Minutes column display snap shot totals for the last ten minutes. You change the time interval of the 10 Minutes column in ConsoleOne. For instructions, see Section 50.2.3, Increasing Polling Time.

Normal: Displays the number of inbound and outbound messages processed by the Internet Agent.

Status: Displays the number of inbound and outbound status messages processed by the Internet Agent. The amount of status message traffic depends on the Outbound Status level (Internet Agent object > GroupWise > Optional Gateway Settings). If the Outbound Status level is set to Full, more status messages are generated. If the Outbound Status level is set to Undelivered, fewer status messages are generated.

Passthrough: Displays the number of inbound and outbound passthrough messages the Internet Agent has processed.

Convert Errors: Outbound messages are converted from GroupWise format to MIME or RFC-822 format. Inbound messages are converted to GroupWise format. This field displays the number of inbound and outbound messages that the Internet Agent could not convert.

Communication: Displays the number of communication errors encountered by the Internet Agent.

Total Bytes: Displays the total number of bytes of inbound and outbound messages processed by the Internet Agent.

SMTP Service Statistics

The SMTP Service Statistics section, shown below, includes only the information for messages processed by the Internet Agent’s SMTP daemon.

NetWare:	Press F10-Options, then F9-Stats to switch to the SMTP Service Statistics.
Linux and Windows:	Click Statistics > SMTP Service.

Figure 49-5 SMTP Service Statistics Section of the Internet Agent Server Console

Messages Sent: Displays the total number of SMTP messages sent by the Internet Agent during its current up time.

Send Threads: The first number displays the number of threads currently being used to send SMTP messages. The second number displays the number of threads still available to the Internet Agent for sending SMTP messages. This is the total number of assigned send threads (by default, 8) minus the currently used threads. You can change the total number of assigned SMTP send threads in ConsoleOne (Internet Agent object > SMTP/MIME > Settings). For more information, see Section 46.1.1, Configuring Basic SMTP/MIME Settings.

Messages Received: Displays the total number of SMTP messages received by the Internet Agent during its current up time.

Receive Threads: The first number is the number of threads currently being used to receive SMTP messages. The second number is the number of threads still available to the Internet Agent for receiving SMTP messages. This is the total number of assigned receive threads (by default, 16) minus the currently used threads. You can change the total number of assigned SMTP receive threads in ConsoleOne (Internet Agent object > SMTP/MIME > Settings). For more information, see Section 46.1.1, Configuring Basic SMTP/MIME Settings.

MX Lookup Errors: To resolve hostnames to IP addresses, the Internet Agent performs MX record lookups in DNS. This field displays the number of MX record lookups that failed.

Unknown Hosts: Displays the number of SMTP hosts that the Internet Agent could not establish a connection with because the hostname could not be resolved to an IP address.

TCP/IP Read Errors: Displays the number of TCP read errors encountered by the Internet Agent. A TCP read error occurs if the Internet Agent connects successfully to another SMTP host but is unable to process a TCP read command during the message transfer.

TCP/IP Write Errors: Displays the number of TCP write errors encountered by the Internet Agent. A TCP write error occurs if the Internet Agent connects successfully to another SMTP host but is unable to process a TCP write command during the message transfer.

Hosts Down: Displays the number of SMTP hosts that the Internet Agent could not establish a connection with in order to send or receive messages. The Internet Agent was able to resolve the hostname to an IP address, but the connection could not be established.

Connections Denied: Displays the number of connections denied by the Internet Agent. A connection is denied if the host is blocked through:

A Class of Service (Internet Agent object > Access Control > Settings). For more information, see Section 47.1, Controlling User Access to the Internet.
A blacklist (Internet Agent object > Access Control > Blacklists). For more information, see Section 47.2, Blocking Unwanted E-Mail from the Internet.
The Reject Mail if Sender’s Identity Cannot Be Verified setting (Internet Agent object > SMTP/MIME > Security Settings), if it is enabled and the sender’s identity cannot be verified. For more information, see Section 47.2.4, Mailbomb (Spam) Protection.

Message Size Denied: Displays the number of SMTP messages that the Internet Agent did not send or receive because they exceeded the maximum message size. You can change the maximum message size in ConsoleOne (Internet Agent object > Access Control > Settings > edit class of service > SMTP Incoming tab or SMTP Outgoing tab). For more information, see Section 47.1, Controlling User Access to the Internet.

Relaying Denied: Displays the number of relay messages denied by the Internet Agent. A relay message is denied for the following reasons:

The Internet Agent is not enabled as a relay host (Internet Agent object > Access Control > SMTP Relay Settings). For more information, see Section 46.1.8, Enabling SMTP Relaying.
The relay message could not be authenticated.

POP Service Statistics

The POP Service Statistics section, shown below, provides information about the POP activity handled by the Internet Agent.

NetWare:	Press F10-Options, then F9-Stats to switch to the POP Service Statistics.
Linux and Windows:	Click Statistics > POP Service.

Figure 49-6 POP Service Statistics Section of the Internet Agent Server Console

Total Sessions: Displays the total number of POP3 sessions processed by the Internet Agent during its current up time.

Active Sessions: Displays the number of currently active POP3 sessions.

Idle Sessions: Displays the number of threads still available to the Internet Agent for POP3 sessions. This is the total number of assigned POP3 threads (by default, 10) minus the active sessions. You can change the total number of assigned POP3 threads in ConsoleOne (Internet Agent object > POP3/IMAP4 > Settings). For more information, see Section 46.2, Configuring POP3/IMAP4 Services.

Messages Sent: Displays the total number of GroupWise mailbox messages retrieved through POP3 sessions.

Normal Threads: Displays the number of POP threads that are busy and the number that are available.

Secure Threads: Displays the number of POP SSL threads that are busy and the number that are available.

Unknown Users: Displays the number of user logins that failed because the user does not exist in the GroupWise system.

Authentication Errors: Displays the number of GroupWise user logins that failed because the user supplied an incorrect password.

Retrieve Errors: Displays the number of errors generated because the Internet Agent could not transfer messages to the POP3 client.

Conversion Errors: Displays the number of errors generated because the Internet Agent could not convert retrieved GroupWise messages to MIME format.

TCP/IP Read Errors: Displays the number of TCP read errors encountered by the Internet Agent. A TCP read error occurs if the Internet Agent successfully opens a POP3 session but is unable to process a TCP read command during the session.

TCP/IP Write Errors: Displays the number of TCP write errors encountered by the Internet Agent. A TCP write error occurs if the Internet Agent successfully opens a POP3 session but is unable to process a TCP write command during the session.

Denied Access Count: Displays the number of POP3 sessions that were denied because the user does not have POP3 access. POP3 access is controlled through the user’s Class of Service assignment (Internet Agent object > Access Control > Settings). For more information, see Section 47.1, Controlling User Access to the Internet.

Store Login Errors: Displays the number of GroupWise user logins that failed because the users’ GroupWise mailboxes were unavailable (for example, the post office is down or the Internet Agent link to the post office is down).

IMAP Service Statistics

The IMAP Service Statistics section, shown below, provides information about the IMAP activity handled by the Internet Agent.

NetWare:	Press F10-Options, then F9-Stats to switch to the IMAP Service Statistics.
Linux and Windows:	Click Statistics > IMAP Service.

Figure 49-7 IMAP Service Statistics Section of the Internet Agent Server Console

Total Sessions: Displays the total number of IMAP4 sessions processed by the Internet Agent during its current up time.

Active Sessions: Displays the number of currently active IMAP4 sessions.

Sessions Available: Displays the number of threads still available to the Internet Agent for IMAP4 sessions. This is the total number of assigned IMAP4 threads (by default, 10) minus the active sessions. You can change the total number of assigned IMAP4 threads in ConsoleOne (Internet Agent object > POP3/IMAP4 > Settings). For more information, see Section 46.2, Configuring POP3/IMAP4 Services.

Messages Sent: Displays the total number of GroupWise mailbox messages retrieved through IMAP4 sessions.

Normal Threads: Displays the number of IMAP threads that are busy and the number that are available.

Secure Threads: Displays the number of IMAP SSL threads that are busy and the number that are available.

Unknown Users: Displays the number of user logins that failed because the user does not exist in the GroupWise system.

Authentication Errors: Displays the number of GroupWise user logins that failed because the user supplied an incorrect password.

Retrieve Errors: Displays the number of errors generated because the Internet Agent could not transfer messages to the IMAP4 client.

Conversion Errors: Displays the number of errors generated because the Internet Agent could not convert retrieved GroupWise messages to MIME format.

TCP/IP Read Errors: Displays the number of TCP read errors encountered by the Internet Agent. A TCP read error occurs if the Internet Agent successfully opens a IMAP4 session but is unable to process a TCP read command during the session.

TCP/IP Write Errors: Displays the number of TCP write errors encountered by the Internet Agent. A TCP write error occurs if the Internet Agent successfully opens an IMAP4 session but is unable to process a TCP write command during the session.

Denied Access Count: Displays the number of IMAP4 sessions that were denied because the user does not have IMAP4 access. IMAP4 access is controlled through the user’s Class of Service assignment (Internet Agent object > Access Control > Settings). For more information, see Section 47.1, Controlling User Access to the Internet.

LDAP Service Statistics

The LDAP Service Statistics section, shown below, provides information about the LDAP activity handled by the Internet Agent.

NetWare:	Press F10-Options, then F9-Stats to switch to the LDAP Service Statistics.
Linux:	Click Statistics > LDAP Service.

Figure 49-8 LDAP Service Statistics Section of the Internet Agent Server Console

Public Sessions: Displays the total number of LDAP sessions handled by the Internet Agent.

Authenticated Sessions: This field is not used.

Sessions Active: Displays the total number of LDAP sessions currently being processed by the Internet Agent.

Sessions Available: Displays the number of threads still available to the Internet Agent for LDAP sessions. This is the total number of assigned LDAP threads (by default, 10) minus the active sessions. You can change the total number of assigned LDAP threads in ConsoleOne (Internet Agent object > LDAP > Settings). For more information, see Section 46.3, Configuring LDAP Services.

Search Requests: Displays the total number of LDAP queries against the GroupWise Address Book.

Entries Returned: Displays the total number of Address Book entries returned for the search requests. For example, a single search request might return 25 entries.

49.1.4 Logging

The Logging section of the console, shown below, displays Internet Agent activity. The number and detail of these messages depend on the logging level you select. See Section 49.6, Using Internet Agent Log Files for more information.

Figure 49-9 Internet Agent Server Console

49.1.5 Menu Functions

The following sections explain the menu options available in the Internet Agent console:

NetWare Internet Agent Console

The menu functions on the NetWare Internet Agent console provide you with the following options.

F6-Restart: Select this option to restart the Internet Agent. The Internet Agent rereads all of its configuration files (gwia.cfg, blocked.txt, gwauth.cfg, route.cfg, and so forth).

F7-Exit: Select this option to terminate the Internet Agent and return to the system prompt.

F8-Info: Select this option to display the Internet Agent configuration information in the Logging section of the console and in the log file.

F9-Browse Log File: Select this option to browse the log file. The following browse options are displayed:

F1-Cancel Browse: Select this option to exit browse mode and to return to the console.
Up-arrow, Down-arrow: Press the Up-arrow and Down-arrow keys to scroll one line at a time.
PgUp, PgDn: Press the PageUp and PageDown keys to scroll one screen at a time.
Ctrl+PgUp: Press Ctrl+PageUp to move to the top of the log file.
Ctrl+PgDn: Press Ctrl+PageUp to move to the bottom of the log file.

F-10 Options: Select this option to display the options menu. The following options are displayed:

F1-Exit Options: Select this option to return to the main Internet Agent console screen.
F2-Log Level: Select this option to toggle between log levels. This option overrides the default log level set in the Log Settings page (Internet Agent object > GroupWise > Log Settings) or the /loglevel switch in the startup file for the current session.
F6-Colors: Select this option to scroll through the several color options. This option is useful if the Internet Agent station has a monochrome monitor. You can also use this option to help you quickly identify an Internet Agent if more than one is running.
F8-Zero Stats: Select this option to reset the values in the Statistics section of the screen.
F9-Stats: Select this option to scroll through the SMTP service statistics, POP service statistics, IMAP service statistics, LDAP service statistics, and message transfer status.

Linux and Windows Internet Agent Console

The menu functions on the Linux and Windows Internet Agent console provide you with the following options.

File > Restart (F6): Select this option to restart the Internet Agent. The Internet Agent rereads all of its configuration files (gwia.cfg, blocked.txt, gwauth.cfg, route.cfg and so forth).

File > Exit (F7): Select this option to terminate the Internet Agent and return to the system prompt.

Configuration > Agent Settings (F5): Select this option to display the Internet Agent configuration information.

Configuration > Message Transfer Status: Select this option to display the status of the TCP/IP link between the Internet Agent and the MTA for the domain.

Configuration > Edit Startup File: Select this option to open the gwia.cfg file in the default text editor.

Log > Cycle Log: Select this option to close the current log file and start a new one.

Log > View Log: Select this option to view the log files.

Log > Log Settings: Select this option to set the logging level, turn on or off disk logging, and configure the maximum log file size and disk space. These changes apply only to the current session.

Statistics > Message: Select this option to display the Message statistics. For information about the Message statistics, see Message Statistics.

Statistics > SMTP Service: Select this option to display the SMTP Service statistics. For information about the SMTP Service statistics, see SMTP Service Statistics.

Statistics > POP Service: Select this option to display the POP Service statistics. For information about the POP Service statistics, see POP Service Statistics.

Statistics > IMAP Service: Select this option to display the IMAP Service statistics. For information about the IMAP Service statistics, see IMAP Service Statistics.

Statistics > LDAP Service: Select this option to display the LDAP Service statistics. For information about the LDAP Service statistics, see LDAP Service Statistics.

Statistics > Zero Statistics (F8): Select this option to reset the Message, SMTP, POP, IMAP, and LDAP statistics.