The following sections explain the various methods you can use to monitor the GroupWise WebAccess Agent to ensure that it is operating properly.
The NetWare WebAccess Agent server console, shown below, lets you monitor the operation of the agent, view the agent’s log information, and change the log settings while at the server.
Figure 56-1 WebAccess Agent Server Console
The console and its options are described below.
The
field displays how long it has been since the WebAccess Agent was started.The default of 12 threads enables the WebAccess Agent to service 12 user requests at one time. The Section 54.1.1, Modifying WebAccess Settings.
field displays the number of threads that are currently servicing user requests. The field displays the total number of threads available to service requests (by default, 12). The field displays the most threads used at one time to service requests. If all threads are busy much of the time, you can increase the number of threads available for use. SeeThe
field displays the number of users who currently are logged in. During startup, if you have enabled WebPublisher, the WebAccess Agent logs in one time for each available thread; these logins are reflected in the fields. The field displays the total number of users who have logged in during the current up time. The field displays the most users who have been logged in at one time.By default, a maximum of 250 users can be logged in at one time. You can use the /maxusers startup switch to change the default. See Section 57.0, Using WebAccess Startup Switches.
The
field displays the total number of requests the WebAccess Agent has processed during its current up time. The field lists the number of requests that could not be processed because of errors.The F10 = Options). For each line, the first item is the number of the thread that processed the user’s request, the second item is the time of the request, and the third item is the information associated with the request.
box displays the logged information. The current log level determines the amount of information that is displayed (seePress F7 to shut down the WebAccess Agent.
Press F9 to view the log file. If disk logging is turned on, the current log file is displayed. If disk logging is turned off, a list of old log files is displayed (if any exist). You can then choose which log file you want to view.
Press F10, then select
or . Using the logging options, you can specify the logging level, turn disk logging on or off, specify the number of days to keep old log files, and specify the maximum amount of disk space to use for log files.Any changes you make to the logging options apply only to the current session. When you restart the WebAccess Agent, the logging level is reset to the level specified in ConsoleOne or in the startup file (strtweb.ncf).
Log Level:
turns logging off; displays initial statistics, user logins, warnings, and errors; displays logging plus user requests; and displays logging plus thread information. The default is logging. Use only if you are troubleshooting a problem with WebAccess.File Logging: Turns disk logging on or off. When disk logging is turned on, the WebAccess Agent creates a new log file each day and each time it is restarted. The log file is named mmddweb.nnn, where mm is the month, dd is the day, and nnn is a sequenced number (001 for the first log file of the day, 002 for the second, and so forth). The default location for the log files is the domain\wpgate\webac80a\xxx.prc directory.
The verbose and diagnostic logging levels do not degrade WebAccess Agent performance, but log files saved to disk consume more disk space when verbose or diagnostic logging is in use.
Max Log File Age: Specifies the number of days you want the WebAccess Agent to retain old log files. The WebAccess Agent retains the log file for the specified number of days unless the maximum disk space for the log files is exceeded. The default age is 30 days.
Max Log Disk Space: Specifies the maximum amount of disk space you want to use for log files. If the disk space limit is exceeded, the WebAccess Agent deletes log files, beginning with the oldest file, until the limit is no longer exceeded. The default disk space is 102400 KB (100 MB).
By default, the Linux Agent runs as a daemon with no user interface. To display information on the server where the WebAccess Agent runs, you must start the WebAccess Agent with the --show startup switch. The console is displayed in a terminal window.
Figure 56-2 Linux WebAccess Agent Server Console
The Windows WebAccess Agent server console lets you monitor the operation of the agent. The server console, shown below, is displayed in a DOS window.
Figure 56-3 Windows WebAccess Agent Server Console
The console and its options are described below.
The current logging level determines the amount of information that is displayed. You can specify the logging level through ConsoleOne, through startup switches, or by using the F2 function key. See Modifying WebAccess Agent Log Settings in ConsoleOne, Modifying WebAccess Agent Log Settings through Startup Switches, and F2.
The verbose and diagnostic logging levels do not degrade WebAccess Agent performance, but log files saved to disk consume more disk space when verbose or diagnostic logging is in use.
For each line, the first item is the number of the thread that processed the user’s request, the second item is the time of the request, and the third item is the information associated with the request.
Shuts down and exits the agent.
Cycles the logging level among
, , and . displays initial statistics, user logins, warnings, and errors; displays logging plus user requests; and displays logging plus thread information. The default is logging. Use only if you are troubleshooting a problem with WebAccess.The verbose and diagnostic logging levels do not degrade WebAccess Agent performance, but log files saved to disk consume more disk space when verbose or diagnostic logging is in use.
Any changes you make to the logging level using F2 apply only to the current session. When you restart the WebAccess Agent, the logging level is reset to the level specified in ConsoleOne or in the startup file (strtweb.bat).
You can use a Web browser interface, referred to as the Web console, to monitor the WebAccess Agent.
Figure 56-4 WebAccess Agent Web Console
Through the Web console you can view the following information:
Status: Displays how long the WebAccess Agent has been up; the number of client/server users who have logged in, the number of threads dedicated to handling requests, and the number of successful and failed requests; and the amount of memory on the server and the percent of processor utilization.
Configuration: Displays the gateway home directory being used by the WebAccess Agent, the current log settings, the performance settings (processing threads and maximum users), and the client/server settings (IP address, TCP port, and so forth).
Environment: Displays server information such as name, operating system date, memory, processor utilization, and loaded modules.
Log Files: Lets you view the contents of the WebAccess Agent’s log files and the current log settings.
For detailed information about each field on the Status, Configuration, Environment, or Log Files page, select the page, then click
.You cannot use the Web console to change any of the WebAccess Agent’s settings. Changes must be made through ConsoleOne, the WebAccess Agent console, or the startup file.
Refer to the following sections for information about enabling and using the Web console:
The default HTTP port for the WebAccess Agent Web console is established during WebAccess Agent installation. You can change the port number and increase security after installation in ConsoleOne.
In ConsoleOne, right-click the WebAccess Agent object, then click
.Click
to display the Network Address page.In the
field, specify a port number. We recommend that you use port 7211 if it is not already in use on the WebAccess Agent’s server.Assigning a port number enables the Web console; assigning 0 as the port number disables the Web console.
Any user who knows the WebAccess Agent’s IP address (or hostname) and the HTTP port number can use the Web console. If you want to restrict Web console access, you can assign a username and password. To do so:
Click the
tab, then click to display the Optional Gateway Settings page.In the
field, enter an arbitrary username (for example, webcon).Click
to assign a password (for example, monitor).Click
to save your changes.In a Web browser, enter the following:
http://IP_address:agent_port
or
https://IP_address:agent_port
where IP_address is the IP address of the server where the WebAccess Agent is running, and agent_port is the port number assigned to the agent. If you used the default port during installation, the port number is 7211.
If prompted, enter the Web console username and password.
Select
, , , or to view the desired information.For detailed information about each field on the Status, Configuration, Environment, or Log Files page, select the page, then click
.If the WebAccess Agent is running on NetWare 6.5 or on Novell Open Enterprise Server (OES), you can use the IP Address Management feature in Novell Remote Manager (
> ) to view the IP address and port configuration for the WebAccess Agent. This is also true for other GroupWise agents (MTA, POA, and Internet Agent) running on NetWare 6.5/OES servers.IMPORTANT:If the WebAccess Agent is running on NetWare in protected mode, it does not display in Novell Remote Manager.
You access Novell Remote Manager by entering the following URL in a Web browser:
http://server_address:8008
For example:
http://172.16.5.18:8008
For more information about using Novell Remote Manager, see the Novell Open Enterprise Server Documentation Web site.
The WebAccess Agent can be monitored through an SNMP management console, such as the one provide with Novell ZENworks Server Management.
Before you can monitor the WebAccess Agent through an SNMP management console, you must compile the WebAccess Agent’s MIB (Management Information Base) file. The Internet Agent’s MIB file, named gwweb.mib, is located in the agents\snmp directory on the GroupWise 8 DVD or downloaded GroupWise 8 software image, or in the GroupWise software distribution directory.
The MIB file contains all the Trap, Set, and Get variables used for communication between the WebAccess Agent and management console. The Trap variables provide warnings that point to current and potential problems. The Set variables allow you to configure portions of the application while it is still running. The Get variables display the current status of different processes of the application.
To compile the MIB file:
Copy the WebAccess Agent MIB (gwweb.mib) to the SNMP management console’s MIB directory.
Compile the MIB file.
Create a profile that uses the WebAccess Agent MIB, then select that profile.
You can select GroupWise users to receive warning and error messages issued by the WebAccess Agent. Whenever the agent issues a warning or error, these users, called operators, receive a message in their mailboxes. You can specify one or more operators.
To assign an operator:
In ConsoleOne, right-click the WebAccess Agent object, then click
.Click
to display the Gateway Administrators page.Click
, select a user, then click to add the user to the Gateway Administrators list.Make sure
is selected as the .If desired, add additional operators.
Click
.WebAccess Agent error messages are documented with the source and explanation of the error, possible causes of the error, and actions to take to resolve the error. See WebAccess Agent Error Messages
in GroupWise 8 Troubleshooting 1: Error Messages.
If you are having a problem with the WebAccess Agent but not receiving a specific error message, or if the suggested actions for the specific error did not resolve the problem, you can review more general troubleshooting strategies for dealing with WebAccess Agent problems. See Strategies for Agent Problems
in GroupWise 8 Troubleshooting 2: Solutions to Common Problems.