SURVIVOR: ups Check Module
About ups
basics
Module Type Scheduler Remote
check Yes No
syntax 
     module ups {
       [community <string>]
       [replaceBattery <boolean>]
       [timeOnBattery <boolean>]
       [snmpversion (1 | 2 | 2c | 3)]
       [snmptimeout <number>]
     }

Dependencies

Arguments

Name Type Value
community optional string, default is 'public' SNMP community name with read-access.
replaceBattery optional boolean, default is true Controls whether module reports battery needs replacement condition and triggers a warning.
timeOnBattery optional boolean, default is true Controls whether module reports non-zero time remaining on battery condition and triggers a problem.
snmpversion optional string, one of '1', '2','2c', or '3', default is '1' SNMP protocol version to use.
snmptimeout optional number between 1 and infinity, default is '5' SNMP query timeout, in seconds. Note that multiple queries may be issued within one check, so this should not be the same as the module timeout.

The module must check for at least one of replaceBattery and timeOnBattery.

Description

The ups module uses the Perl SNMP module to query the status of American Power Conversion (APC) or Liebert uninterruptible power supplies. UPSs are checked for necessity of battery replacement and for time on battery.

This module was initially written for APC devices. Support has since been added for Liebert devices, the only change is that different MIBs are polled. The Liebert UPS devices also have a generic alarm value which must be checked.

Examples

  1. To check a UPS with the community name "public": 
         module ups {}
  2. To skip the battery replacement check: 
         module ups {
       replaceBattery false
     }
$Date: 2007/02/11 02:09:08 $
$Revision: 0.10 $
 keywords
community
replaceBattery
snmptimeout
snmpversion
timeOnBattery