NAME
stat_agent.pl - dim_STAT monitoring agent
SCRIPT CATEGORIES
UNIX/System_administration
PREREQUISITES
This script requires "IO::Socket" and "Getopt::Long"
OSNAMES
"linux" and all UNIX systems
SYNOPSIS
stat_agent.pl -f access_file [-p port] [-l logfie] [-d] [-v]
stat_agent --port 5000 -f access
README
This script can be used as a replacement of the original dim_STAT
STATsrv monitoring agent.
DESCRIPTION
This script opens the specified TCP port and waits for connections of
the dim_STAT server.
This script was tested with dim_STAT Version 8.2.
Improvements:
* Platform independent
Should run under all UNIX/Linux systems.
* More restricted security behavior
- The access file is checked if specified command is executable
(if not it's not added to the executable command stack).
- All special characters in the command parameter are deleted
(except '_', '/', '-' and ' ').
- It's possible specify a user for each executable command.
The options are as follows:
"--port, -p"
TCP port (default 5000)
"--file, -f"
Command access file with the usually STATsrv syntax, e.g.:
# Usable from any hosts
command vmstat /usr/bin/vmstat
# Usable from .50 and .51 only
access 10.10.10.50
access 10.10.10.51
command mpstat /usr/bin/mpstat
command netstat /usr/bin/netstat
To execute a command by a specific user the following syntax
has to be used:
command jack:netstat /usr/bin/netstat
command jane:mpstat /usr/bin/mpstat
To do so the current user must be allowed to "su" to the
specified user without a password.
"--daemon, -d"
Run program as unix daemon
"--log, -l" Specifies the log file (default STDOUT)
"--verbose, -v"
Verbose mode
INSTALLATION
To replace the existing STATsrv agent with this version shutdown all
running STATsrv agents and copy the stat-agent.pl script to your STATsrv
installation:
/etc/STATsrv/STAT-service stop
cp stat-agent.pl /etc/STATsrv/bin
Replace the old STAT-service script with this one:
cp STAT-service /etc/STATsrv
SEE ALSO
The dim_STAT project: http://dimitrik.free.fr/
COPYRIGHT
Copyright (C) 2009 by Marc Koderer/LHS Telekommunikations GmbH & Co. KG
This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License.