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.