5.10 Monitoring the Archive Agent

By monitoring the Archive Agent, you can determine whether its current configuration is meeting the archiving and indexing needs being placed upon it. You have a variety of tools to help you monitor the operation of the Archive Agent:

5.10.1 Using the Archive Agent Console on Windows

The following topics help you use the Archive Agent console on Windows:

NOTE:The Archive Agent console is not available on Linux. Use the Web Console instead, as described in Using the Archive Agent Web Console and GroupWise Monitor.

Monitoring the Archive Agent from the Archive Agent Console

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

Figure 5-2 Archive Agent Console

The Archive Agent console includes several areas of information:

Table 5-3 Archive Agent Console

Information

Description

Information Box

Identifies the Archive Agent, displays description information provided in ConsoleOne, and shows how long the Archive Agent has been running.

Status Box

Displays the number of current users who are searching the archive and the number of conversations that are queued for archiving. The rotating processing bar shows that the Archive Agent is running.

Statistics Box

Displays the number of requests that the Archive Agent has received from client users who are searching the archive or from the Messaging Agent, along with the number of requests that it has been unable to respond to. Pending requests might indicate a need to optimize Archive Agent performance so that it can keep up with the demands being placed upon it.

Log Message Box

Displays the same information that is being written to the Archive Agent log file. The amount of information displayed depends on the current log settings for the Archive Agent. See Using Archive Agent Log Files. The information scrolls up automatically.

Controlling the Archive Agent from the Archive Agent Console

You can perform the following tasks to monitor and control the Archive Agent from the Archive Agent console at the Messenger server:

Table 5-4 Archive Agent Keyboard Shortcuts

Task

Windows

Stop the Archive Agent

File > Exit

Edit the startup file

Configuration > Edit Startup File

Display current agent settings

Configuration > Agent Settings

Display the current log file

Log > Auto Scroll Off > scroll as needed

Display a selected log file

Log > View Log

Change log settings for the current agent session

Log > Log Settings

Start a new log file

Log > Cycle Log

Index the archive

Actions > Update Indexes

Compress the archive indexes

Actions > Compress Indexes

Perform maintenance on the archive

Actions > Verify and Repair Archive

Display online help

Help > Help

5.10.2 Using the Archive Agent Web Console and GroupWise Monitor

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

You can use the same procedure to set up the Archive Agent Web Console as the Messaging Agent Web Console. For instructions, see Using the Messaging Agent Web Console. In addition, you can compress the archive indexes and perform maintenance on the archive from the Web Console.

As with the Messaging Agent, you can access the Archive Agent Web Console console from GroupWise Monitor. For setup and usage instructions, Using GroupWise Monitor.

5.10.3 Using Archive Agent Log Files

Error messages and other information about the Archive Agent are written to log files as well as displaying on the Archive Agent console. Log files can provide a wealth of information for resolving problems with Archive Agent functioning. On Windows, the default location for log files is the logs subdirectory of the Archive Agent installation directory. On Linux, the default location is /var/opt/novell/log/messenger/aa.

You can use the same procedure for Archive Agent log files as for Messaging Agent log files. For instructions, see Using Messaging Agent Log Files.

5.10.4 Using SNMP Monitoring Programs

You can monitor the Archive Agent from the Management and Monitoring component of any SNMP management and monitoring program. When properly configured, the Archive Agent sends SNMP traps to network management consoles for display along with other SNMP monitored programs. It also responds to requests for configuration and status information from SNMP management and monitoring programs.

You can use the same procedure for setting up the Archive Agent as for the Messaging Agent. For instructions, see Using SNMP Monitoring Programs.