check_ifoperstatus with DS1 ISDN HSRP and Cacti support

Project Notes

Requires Net::SNMP.

Check interface status via SNMP.
(Based of original work by Christoph Kron)

Usage:
check_ifoperstatus.pl -H -C -k
check_ifoperstatus.pl --help
check_ifoperstatus.pl --version

-H (--hostname) Hostname/port to query - (required) (port defaults to 161)
-C (--community) SNMP read community or v3 auth (defaults to public)

(v3 specified as username:authpassword:... )
username = SNMPv3 security name
authpassword = SNMPv3 authentication pass phrase (or hexidecimal key)
authprotocol = SNMPv3 authentication protocol (md5 (default) or sha)
privpassword = SNMPv3 privacy pass phrase (or hexidecmal key)
privprotocol = SNMPv3 privacy protocol (des (default) or aes)

-v (--snmp_version) 1 for SNMP v1

2 for SNMP v2c (default)
3 for SNMP v3

-k (--key) ifIndex of interface
-I {--ifmib} IF-MIB ifXTable supported
-D (--ifdescr) ifDescr to compare to (or use in cacti lookup)
-N (--ifname) ifName to compare to (or use in cacti lookup)
-t (--type) check type (defaults to default)
--hsrpgrp HSRP group to check (requires when type of hsrpgrp)

Cacti Integration:
--cacti_database cacti database to get index from (default cacti)
--cacti_username cacti database username (default cacti)
--cacti_password cacti database password (required to enable check)
--cacti_hostname cacti database hostname (default localhost)
--cacti_port cacti database port number (default to 3306)

(ifDescr or ifName must be define to use as key in cacti database lookup)

-V (--version) Plugin version
-h (--help) usage help

Check Types:
default - uses IF-MIB and checks ifOperStatus
isdnd - uses ISDN-MIB and checks isdnLapdOperStatus
dsx1 - uses DS1-MIB and checks dsx1LineStatus
hsrpgrp - uses CISCO-HSRP-MIB and checks cHsrpGrpStandbyState

(alarms if not standby or active)

Version 0.81 fix - forgot to add support for using different snmp ports (-H host:port)
Version 0.8 added --cisco to use locIfReason from OLD-CISCO-INTERFACES MIB

added --warnadmin to warn if ifAdminStatus is down instead of critical

Version 0.7 added snmpv3 support
Version 0.61 fix - removed -h for HSRP group as it conflicts with help

fix - ifAlias will now replace | characters with # so that nagios doesn't confuse for perfdata
fix - had typos of isdnd

Version 0.6 added -h (--hsrpgrp) option to check the state of an HSRP group

added -t (--type) new type of hsrpgrp (requires -h)
Note: HSRP currently will alarm CRITICAL only if state is not active or standby

Version 0.5 $snmp was not checked for being defined - fixed

replaced -c (--cactidb) with individual options for each connect string (see help)
added -t (--type) option and integrated isdn d channel and dsx1 checking

Version 0.4 added -c (--cactidb) option to use cacti database to get index
Version 0.3 added -D (--ifdescr) option to match ifDescr to parameter

added -N (--ifname) option to match ifName to parameter
if just -D is specified only ifDescr looked up, otherwise ifName is

Version 0.2 conformed with ePN