********************************************************************************

check_asc

(c) 2013 by Florian Fuchs (florian.fuchs@k.roteskreuz.at)

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.

********************************************************************************

Requirements
============
You must have an ASC Marathon Evolution voice recording system. The script has 
been tested against version 10.00.14. In order to run it, you must order the the 
EMAIL/SNMP license at ASC (see http://www.asctelecom.com). Otherwise, it won't 
work.

In order to be able to query the ASC status you must execute the following 
steps.

1) Login into the ASC DataManager.
2) Under "Configuration" -> "Alarm Notifications" activate the "SNMP Get"
   option and save the new config.

Installation
============
1) Put the check_asc script into the /usr/local/nagios/libexec directory.
2) Add definitions according to the voicerecording.cfg sample to your own 
   definition files.


Usage
=====
The check_asc script verify certain parameters via SNMP.

Parameters:
   -h (--help)                  usage help
   -V (--version)               plugin version
   -t (--timeout)               seconds before the plugin times out (default=15)
   -C <command> (--command)     execute command
   -H <hostname>
      valid commands:   ASCSTATUS
                        ASCVERSION
                        CPULOAD1 -w <warnlevel> -c <criticallevel> (1 minute 
                                 load)
                        CPULOAD5 -w <warnlevel> -c <criticallevel> (5 minute 
                                 load)
                        CPULOAD15 -w <warnlevel> -c <criticallevel> (15 minute 
                                 load)
                        DISKSPACE -w <warnlevel in percent of free space>
                                  -c <criticallevel in percent of free space>
                                  [-P mountpoint]
                        OSVERSION
                        RAM -w <warnlevel in percent of free memory without 
                                buffer and cache> 
                            -c <criticallevel in percent of free memory without
                                buffer and cache>
                        SWAP -w <warnlevel in percent of free space> 
                             -c <criticallevel in percent of free space>
                        SYSTEMDATE -w <warnlevel in seconds of deviation>
                                   -c <criticallevel in seconds of deviation>
                        UPTIME
						
Changes

=======

V 1.2 (2013-11-15): *) added a hint that the SNMP option might not be active in
                       case a check fails
V 1.1 (2013-10-08): *) added command ASCVERSION which returns the ASC software 
                       version
                    *) added command OSVERSION which returns the operating system 
                       version of the machine
                    *) added commamd SYSTEMDATE to verify the current time of 
                       the machine

	
