grpwise-ma (1)

Name

grpwise-ma - GroupWise Monitor Script.

Syntax

grpwise-ma [start] [stop] [status] [restart]

Description

The grpwise-ma script is created during installation and controls the Monitor Agent. (The grpwise script controls the other four GroupWise agents.) The grpwise-ma script is created in the /etc/init.d directory. It works in conjunction with the monitor.xml file, which is created in the /opt/novell/groupwise/agents/share directory. The monitor.xml file points the Monitor Agent to a domain database (wpdomain.db) where it can access a list of agents to monitor in your GroupWise system.

The grpwise-ma script includes an MA_OPTIONS variable where you can specify Monitor Agent startup switches. This is convenient because the Monitor Agent does not use a startup file as the other GroupWise agents do.

The Monitor Agent is Run Control compliant. During installation, a symbolic link is created from /etc/init.d/grpwise-ma to /usr/sbin/rcgrpwise-ma. Typically, /usr/sbin is already on your path, so you can run rcgrpwise-ma from any directory, rather than changing to /etc/init.d in order to run the grpwise-ma script.

Options

Usage Options:

start

Starts the Monitor Agent as a daemon on the local server. A green “done” indicates that the agent is running. If a green “done” does not appear, then the agent was unable to start.

status

Displays status for the Monitor Agent. A green “running” indicates that the agent is running. A black “unused” indicates that the agent is not running.

stop

Stops the Monitor Agent. A green “done” indicates that the agent is stopped. A black “unused” indicates that the agent is not running and therefore cannot be stopped.

restart

Stops the Monitor Agent. A green “done” indicates that the agent is stopped. A black “unused” indicates that the agent is not running and therefore cannot be stopped. The Monitor Agent then starts again with the standard start status indicators.

Help Options:

--help, -?

Displays the help information and exits.

Files

/opt/novell/groupwise/agents/share/monitor.xml

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.

/var/opt/novell/groupwise/monitor/gwmonitor.cfg

Monitor Application configuration file. Provides integration information for passing agent status information gathered by the Monitor Agent to your Web browser for display in the Monitor Web console.

Examples

This script does not run as root.

/etc/init.d/grpwise-ma start

Starts the Monitor Agent.

You can view the Monitor Agent Web console at the following URL:

http://localhost:8200

You can view the Monitor Web console at the following URL:

http://localhost/gwmon/gwmonitor

NOTE:In the example, /etc/init.d/grpwise-ma can be replaced with rcgrpwise-ma to run the script from any directory.

Authors

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

See Also

gwmon (1).

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