gwmon (1)


gwmon - GroupWise Monitor Agent.


gwmon --home domain_directory


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 monitor.xml file in the /opt/novell/groupwise/agents/share directory.


NOTE:The --show switch that is available for 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. For more information about startup switches, see the GroupWise Administration Guide .

Help Options:

--help , -?

Displays the help information and exits.



Monitor Agent configuration file. Provides a domain directory where the Monitor Agent can determine what GroupWise and Messenger agents to monitor. The monitor.xml file is created during installation.


Log file for Monitor Agent events.


Log file for dumps of monitored agent MIB values.


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.


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 file name 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.


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

See Also

grpwise-ma (1).

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