gwmon (1)

Name

gwmon - GroupWise Monitor Agent.

Syntax

gwmon --home domain_directory

Description

The Monitor Agent is a monitoring and management tool that allows you to monitor GroupWise agents and gateways, along with Messenger agents, from any location where you are connected to the Internet and have access to a Web browser. Some agent administration can also be performed from your Web browser.

Monitor agent configuration information is stored in the gwmonitor.cfg file in the /opt/novell/groupwise/gwmonitor directory.

Options

NOTE:The --show switch that is available for the other GroupWise agents to provide a user interface is not available for the Linux Monitor Agent.

Usage Options:

--home domain_directory

Specifies a domain directory where the Monitor Agent can access a domain database (wpdomain.db). From the domain database, the Monitor Agent can determine which agents to monitor, what user names and passwords are necessary to access them, and so on.

Help Options:

--help , -?

Displays the help information and exits.

Files

/opt/novell/groupwise/gwmonitor/gwmonitor.cfg

Configuration file with Monitor Agent properties. The Monitor Agent does not have a startup file like the other agents. Its startup switches can be used only on the command line.

/var/log/novell/groupwise/gwmon/mmddmon.nnn

Log file for Monitor Agent events.

/var/log/novell/groupwise/gwmon/mmddhist.nnn

Log file for dumps of monitored agent MIB values.

Examples

This program can run as any user.

/opt/novell/groupwise/agents/bin/gwmon --home /gwsystem/provo1

Starts the Monitor Agent by accessing the domain database in the specified domain directory.

Diagnostics

The Monitor Agent writes to two different types of log files. Event log files record error messages, status messages, and other types of event-related messages. History log files record dumps of all MIB values gathered during each poll cycle of monitored agents. By default, both types of log files are created in the /var/log/novell/groupwise/gwmon directory.

Typically you find multiple log files in this directory. The first four characters of each filename represent the date. The following characters are mon for event log files and hist for history log files. A three-digit extension allows for multiple log files created on the same day. For example, a log file named 0518mon.001 indicates that it is a Monitor Agent event log file created on May 18. If you restart the Monitor Agent on the same day, a new event log file is created, named 0518mon.002.

For information about Monitor Agent error messages, see Troubleshooting 1: Error Messages.

Authors

Copyright 2004-2010, Novell, Inc.. All rights reserved.

See Also

grpwise (1).

To report problems with this software or its documentation, visit Novell Bugzilla.