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 /etc/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 agent 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 than 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 than 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

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.

Examples

This program 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

Authors

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

See Also

gwmon (1).

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