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.