moncmd - send commands to mon daemon and show the results.
SYNOPSIS
moncmd [-a] [-d] [-l username] [-f file] [-s server] [-p
port] [command]
DESCRIPTION
moncmd sends commands to the mon server.
OPTIONS
-a Authenticate with the server.
-d enable debugging, which is the same as -s local-
host.
-f file
Read and execute commands from file.
-l username
Supply username as the username while authenticat-
ing to the server.
-s server
Connect to server.
-p port
Use TCP port port when connecting to the server,
instead of the default of 32777.
MONITOR HOST
moncmd will use the host specified by the -s parameter as
the server. If there is no -s parameter it will use the
host specied in the the MONHOST environment variable. If
there is no host in either of these locations it will exit
with an error.
BATCH OPERATION
If no commands are supplied to moncmd on the command line,
then commands will be taken from either standard input, or
from the file specified by the -f parameter. If standard
input is connected to a TTY and the -a option is supplied,
then it will prompt for a password. If the -a option is
supplied without the -f option and standard input is not a
TTY, then the username and password are read from standard
input using the syntax "USER=username" and "PASS=pass-
word". The remaining input lines are interpreted as com-
mands to send to the server. moncmd will not take user-
names or passwords from a file, for obvious security rea-
sons.
user ID of the current process.
COMMANDS
The following is a list of the commands that the server
understands.
enable | disable service group servicename
Enables/disables alerts for group and servicename.
All disabled states are automatically saved to the
state file, which may optionally be re-loaded upon
restarting or initial startup of the server.
ack group service comment
Acknowledge a failure condition. This will store
comment in the state of service (queryable by doing
a list opstatus command), and will surppress fur-
ther alerts for the service. Once the service
returns to a non-failure state, then the acknowl-
edgement is reset.
version
Displays the protocol version in the form of "ver-
sion num" where num is the protocol version number.
list aliases
Lists aliases.
list aliasgroups
Lists alias groups.
savestate
Save the state of the server. Currently, the only
state which is saved is the host/watches/services
which are disabled.
loadstate
Load the state of the server. Currently, the only
state which is loaded is the host/watches/services
which are disabled.
enable | disable host hostname
Enables/disables host hostname in all groups. When
the monitor is called, this hostname will not be
included in the list of hostnames sent to the moni-
instead.
enable | disable watch watchgroup
Enables/disables an entire watch for watchgroup, as
defined in the configuration file. Disabling a
watch not only stops alerts from happening, but it
stops the actual monitor processes from being
scheduled.
reset Resets the server, forcing it to re-read the con-
figuration file, kill off currently running moni-
tors, restart all monitoring, and reset all coun-
ters. This command is only accessible if moncmd
connects from the host which is running the mon
server.
reset stopped
Resets the server and immediately stops the sched-
uler. This is an atomic version of the commands
reset and stop.
reload auth
Reloads the auth.cf file in order to incorporate
any new changes. The auth table is completely re-
generated; it is not merged.
reset keepstate
If the word "keepstate" comes after the reset com-
mand, the server will do a "loadstate" right after
the reset, before the scheduler kicks back in.
stop Stops the scheduler, but continues to allow client
connections.
start Re-starts the scheduler after it has been stopped.
test group servicename
Triggers a test for group and service immediately
by setting the service's countdown timer to zero.
servertime
Returns the current time of the server as seconds
since Jan 1, 1970.
Lists the members of group groupname.
list descriptions
List the descriptions of each service, as defined
in the configuration file. If a service description
is undefined, then it is not listed.
list alerthist
Lists the last alarms triggered for each service of
each watch group, in addition to the summary out-
put. The number of alerts to keep in memory is
bounded by the maxkeep variable, configurable on
the mon command line at startup, and expandable
with the set command during runtime.
list failurehist
Lists the last failures, in addition to the summary
output. This is also limited by the maxkeep vari-
able.
list opstatus
Lists operational status of all services. Reports
whether the last time a service group was tested
resulted in success or failure. The output is:
group service untested
group service time timeleft succeeded
group service time timeleft failed output
where output is the first line of output from the
monitor script which failed, time is the time that
the condition was last noticed in time(2) format,
and timeleft is the number of seconds left until
the service is tested again.
list successes
Generates the same output as the list opstatus com-
mand, but only shows the services that have suc-
ceeded the last time they were tested.
list failures
Generates the same output as the list opstatus com-
mand, but only shows the services that have failed
the last time they were tested.
Lists all hosts and services which have been dis-
abled by the disable host|service command.
list pids
Shows the currently active watch groups/services
along with their process IDs, and it process ID of
the server daemon.
list watch
Lists all watches and services.
list state
Lists the state of the scheduler.
set group service variable value
Sets a variable to value. Useful for temporarily
changing an interval or alertevery value. Be care-
ful, because this can just set any value in the
%watch hash, and some values that are specified in
the configuration file like "10m" or "35s" are con-
verted and stored as just plain integer seconds
(e.g. "alertevery").
get group service variable
Displays the value of group service variable.
set variable value
Assigns value to the global variable variable.
set opstatus group service value
Sets the opstatus value for group and service.
get variable
Shows the value of global variable variable.
term Terminates the server. This command is only acces-
sible if moncmd connects from the host which is
running the mon server.
ENVIRONMENT VARIABLES
MONSERVER
The hostname of the server which runs the mon pro-
The port number to connect to.
SEE ALSO
mon(1)
BUGS
Report bugs to the email address below.
AUTHOR
Jim Trocki <trockij@transmeta.com>
Man(1) output converted with
man2html