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 folder. It works in conjunction with the monitor.xml file, which is created in the /opt/novell/groupwise/agents/share folder. 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. This enables you to run rcgrpwise-ma from any folder, 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 service on the local server. A green “done” indicates that an agent is running. If a green “done” does not appear, the agent was unable to start.

status

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

stop

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

restart

Stops the Monitor Agent. A green “done” indicates that an agent is stopped. A black “unused” indicates that an 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 folder where the Monitor Agent can determine what GroupWise 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 main Monitor web console.

Examples

This script does not need to be run as root.

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

/etc/init.d/grpwise-ma start

Starts the Monitor Agent.

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

http://localhost:8200

You can view the Monitor console at the following URL:

http://localhost/gwmon/gwmonitor

Authors

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

See Also

gwmon(1).

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