UPS-MIB

        The MIB module to describe Uninterruptible Power
Supplies.
    
Source file
UPS-MIB
Last revised
Identity
upsMIB
Base OID
1.3.6.1.2.1.33
Imported Objects
SNMPv2-CONF MODULE-COMPLIANCE (no object page) OBJECT-GROUP (no object page)
SNMPv2-SMI Counter32 Gauge32 Integer32 mib-2 MODULE-IDENTITY (no object page) NOTIFICATION-TYPE (no object page) OBJECT-IDENTITY (no object page) OBJECT-TYPE (no object page)
SNMPv2-TC AutonomousType DisplayString TestAndIncr TEXTUAL-CONVENTION (no object page) TimeInterval TimeStamp
Net-SNMP examples using the liebert MIB directory Show commands

These commands use the standard Observium installation path and load the selected MIB variant before the RFC and Net-SNMP directories.

Translate the module identity
/usr/bin/snmptranslate -Pud -Ir -On -m 'UPS-MIB' -M '/opt/observium/mibs/liebert:/opt/observium/mibs/rfc:/opt/observium/mibs/net-snmp' 'UPS-MIB::upsMIB'
Walk the MIB subtree
/usr/bin/snmpbulkwalk -v2c -c '<community>' -Pud -Ir -OQUs -m 'UPS-MIB' -M '/opt/observium/mibs/liebert:/opt/observium/mibs/rfc:/opt/observium/mibs/net-snmp' 'udp:<hostname>:161' 'UPS-MIB::upsMIB'
How SNMP, Net-SNMP, MIB paths, and variants work
Objects (116)
.1.3.6.1.2.1.33
.1.3.6.1.2.1.33.1
.1.3.6.1.2.1.33.1.1
OctetString
.1.3.6.1.2.1.33.1.1.1
OctetString
.1.3.6.1.2.1.33.1.1.2
OctetString
.1.3.6.1.2.1.33.1.1.3
OctetString
.1.3.6.1.2.1.33.1.1.4
OctetString
.1.3.6.1.2.1.33.1.1.5
OctetString
.1.3.6.1.2.1.33.1.1.6
.1.3.6.1.2.1.33.1.2
Enumeration
.1.3.6.1.2.1.33.1.2.1
.1.3.6.1.2.1.33.1.2.2
.1.3.6.1.2.1.33.1.2.3
percentInteger32
.1.3.6.1.2.1.33.1.2.4
.1.3.6.1.2.1.33.1.2.5
.1.3.6.1.2.1.33.1.2.6
degrees CentigradeSNMPv2-SMIInteger32
.1.3.6.1.2.1.33.1.2.7
.1.3.6.1.2.1.33.1.3
.1.3.6.1.2.1.33.1.3.1
.1.3.6.1.2.1.33.1.3.2
.1.3.6.1.2.1.33.1.3.3
.1.3.6.1.2.1.33.1.3.3.1
.1.3.6.1.2.1.33.1.3.3.1.1
.1.3.6.1.2.1.33.1.3.3.1.2
.1.3.6.1.2.1.33.1.3.3.1.3
.1.3.6.1.2.1.33.1.3.3.1.4
.1.3.6.1.2.1.33.1.3.3.1.5
.1.3.6.1.2.1.33.1.4
Enumeration
.1.3.6.1.2.1.33.1.4.1
.1.3.6.1.2.1.33.1.4.2
.1.3.6.1.2.1.33.1.4.3
.1.3.6.1.2.1.33.1.4.4
.1.3.6.1.2.1.33.1.4.4.1
.1.3.6.1.2.1.33.1.4.4.1.1
.1.3.6.1.2.1.33.1.4.4.1.2
.1.3.6.1.2.1.33.1.4.4.1.3
.1.3.6.1.2.1.33.1.4.4.1.4
percentInteger32
.1.3.6.1.2.1.33.1.4.4.1.5
.1.3.6.1.2.1.33.1.5
.1.3.6.1.2.1.33.1.5.1
.1.3.6.1.2.1.33.1.5.2
.1.3.6.1.2.1.33.1.5.3
.1.3.6.1.2.1.33.1.5.3.1
.1.3.6.1.2.1.33.1.5.3.1.1
.1.3.6.1.2.1.33.1.5.3.1.2
.1.3.6.1.2.1.33.1.5.3.1.3
.1.3.6.1.2.1.33.1.5.3.1.4
.1.3.6.1.2.1.33.1.6
.1.3.6.1.2.1.33.1.6.1
.1.3.6.1.2.1.33.1.6.2
.1.3.6.1.2.1.33.1.6.2.1
.1.3.6.1.2.1.33.1.6.2.1.1
.1.3.6.1.2.1.33.1.6.2.1.2
.1.3.6.1.2.1.33.1.6.2.1.3
.1.3.6.1.2.1.33.1.6.3
.1.3.6.1.2.1.33.1.6.3.1
.1.3.6.1.2.1.33.1.6.3.10
.1.3.6.1.2.1.33.1.6.3.11
.1.3.6.1.2.1.33.1.6.3.12
.1.3.6.1.2.1.33.1.6.3.13
.1.3.6.1.2.1.33.1.6.3.14
.1.3.6.1.2.1.33.1.6.3.15
.1.3.6.1.2.1.33.1.6.3.16
.1.3.6.1.2.1.33.1.6.3.17
.1.3.6.1.2.1.33.1.6.3.18
.1.3.6.1.2.1.33.1.6.3.19
.1.3.6.1.2.1.33.1.6.3.2
.1.3.6.1.2.1.33.1.6.3.20
.1.3.6.1.2.1.33.1.6.3.21
.1.3.6.1.2.1.33.1.6.3.22
.1.3.6.1.2.1.33.1.6.3.23
.1.3.6.1.2.1.33.1.6.3.24
.1.3.6.1.2.1.33.1.6.3.3
.1.3.6.1.2.1.33.1.6.3.4
.1.3.6.1.2.1.33.1.6.3.5
.1.3.6.1.2.1.33.1.6.3.6
.1.3.6.1.2.1.33.1.6.3.7
.1.3.6.1.2.1.33.1.6.3.8
.1.3.6.1.2.1.33.1.6.3.9
.1.3.6.1.2.1.33.1.7
upsTestId r/w
ObjectIdentifier
.1.3.6.1.2.1.33.1.7.1
.1.3.6.1.2.1.33.1.7.2
Enumeration
.1.3.6.1.2.1.33.1.7.3
OctetString
.1.3.6.1.2.1.33.1.7.4
.1.3.6.1.2.1.33.1.7.5
.1.3.6.1.2.1.33.1.7.6
.1.3.6.1.2.1.33.1.7.7
.1.3.6.1.2.1.33.1.7.7.1
.1.3.6.1.2.1.33.1.7.7.2
.1.3.6.1.2.1.33.1.7.7.3
.1.3.6.1.2.1.33.1.7.7.4
.1.3.6.1.2.1.33.1.7.7.5
.1.3.6.1.2.1.33.1.8
Enumeration
.1.3.6.1.2.1.33.1.8.1
secondsInteger32
.1.3.6.1.2.1.33.1.8.2
secondsInteger32
.1.3.6.1.2.1.33.1.8.3
secondsInteger32
.1.3.6.1.2.1.33.1.8.4
Enumeration
.1.3.6.1.2.1.33.1.8.5
.1.3.6.1.2.1.33.1.9
.1.3.6.1.2.1.33.1.9.1
.1.3.6.1.2.1.33.1.9.10
.1.3.6.1.2.1.33.1.9.2
.1.3.6.1.2.1.33.1.9.3
.1.3.6.1.2.1.33.1.9.4
.1.3.6.1.2.1.33.1.9.5
.1.3.6.1.2.1.33.1.9.6
.1.3.6.1.2.1.33.1.9.7
Enumeration
.1.3.6.1.2.1.33.1.9.8
.1.3.6.1.2.1.33.1.9.9
.1.3.6.1.2.1.33.2
.1.3.6.1.2.1.33.3
.1.3.6.1.2.1.33.3.1
.1.3.6.1.2.1.33.3.2
.1.3.6.1.2.1.33.3.2.1
.1.3.6.1.2.1.33.3.2.2
.1.3.6.1.2.1.33.3.2.3
Dependencies (3) 3 direct Show tree and compile order Hide dependency details

Each imported module is resolved in the importing module's source directory first, then through the normal default-variant rules.

Dependency tree
Dependency-first compile order
  1. SNMPv2-SMIrfc
  2. SNMPv2-CONFrfc
  3. SNMPv2-TCrfc
  4. UPS-MIBliebertselected
Type Definitions (2)
Integer32 range: 0..2147483647
Integer32 range: 1..2147483647
Conformance Groups (25)
The upsSubsetIdentGroup defines objects which are
common across all UPSs which meet subset compliance.
Most devices which conform to the upsSubsetIdentGroup
will provide access to these objects via a proxy
agent. If the proxy agent is compatible with multiple
UPS types, configuration of the proxy agent will
require specifying some of these values, either
individually, or as a group (perhaps through a table
lookup mechanism based on the UPS model number).
.1.3.6.1.2.1.33.3.2.1.1
The upsSubsetBatteryGroup defines the objects that
are common to battery groups of two-contact UPSs.
.1.3.6.1.2.1.33.3.2.1.2
The upsSubsetInputGroup defines the objects that are
common to the Input groups of two-contact UPSs.
.1.3.6.1.2.1.33.3.2.1.3
The upsSubsetOutputGroup defines the objects that are
common to the Output groups of two-contact UPSs.
.1.3.6.1.2.1.33.3.2.1.4
The upsSubsetAlarmGroup defines the objects that are
common to the Alarm groups of two-contact UPSs.
.1.3.6.1.2.1.33.3.2.1.6
The upsSubsetControlGroup defines the objects that
are common to the Control groups of two-contact UPSs.
.1.3.6.1.2.1.33.3.2.1.8
The upsSubsetConfigGroup defines the objects that are
common to the Config groups of two-contact UPSs.
.1.3.6.1.2.1.33.3.2.1.9
The upsBasicIdentGroup defines objects which are
common to the Ident group of compliant UPSs which
support basic functions.
.1.3.6.1.2.1.33.3.2.2.1
The upsBasicBatteryGroup defines the objects that are
common to the battery groups of compliant UPSs which
support basic functions.
.1.3.6.1.2.1.33.3.2.2.2
The upsBasicInputGroup defines the objects that are
common to the Input groups of compliant UPSs which
support basic functions.
.1.3.6.1.2.1.33.3.2.2.3
The upsBasicOutputGroup defines the objects that are
common to the Output groups of compliant UPSs which
support basic functions.
.1.3.6.1.2.1.33.3.2.2.4
The upsBasicBypassGroup defines the objects that are
common to the Bypass groups of compliant UPSs which
support basic functions.
.1.3.6.1.2.1.33.3.2.2.5
The upsBasicAlarmGroup defines the objects that are
common to the Alarm groups of compliant UPSs which
support basic functions.
.1.3.6.1.2.1.33.3.2.2.6
The upsBasicTestGroup defines the objects that are
common to the Test groups of compliant UPSs which
support basic functions.
.1.3.6.1.2.1.33.3.2.2.7
The upsBasicControlGroup defines the objects that are
common to the Control groups of compliant UPSs which
support basic functions.
.1.3.6.1.2.1.33.3.2.2.8
The upsBasicConfigGroup defines the objects that are
common to the Config groups of UPSs which support
basic functions.
.1.3.6.1.2.1.33.3.2.2.9
The upsFullIdentGroup defines objects which are
common to the Ident group of fully compliant UPSs.
.1.3.6.1.2.1.33.3.2.3.1
The upsFullBatteryGroup defines the objects that are
common to the battery groups of fully compliant UPSs.
.1.3.6.1.2.1.33.3.2.3.2
The upsFullInputGroup defines the objects that are
common to the Input groups of fully compliant UPSs.
.1.3.6.1.2.1.33.3.2.3.3
The upsFullOutputGroup defines the objects that are
common to the Output groups of fully compliant UPSs.
.1.3.6.1.2.1.33.3.2.3.4
The upsFullBypassGroup defines the objects that are
common to the Bypass groups of fully compliant UPSs.
.1.3.6.1.2.1.33.3.2.3.5
The upsFullAlarmGroup defines the objects that are
common to the Alarm groups of fully compliant UPSs.
.1.3.6.1.2.1.33.3.2.3.6
The upsFullTestGroup defines the objects that are
common to the Test groups of fully compliant UPSs.
.1.3.6.1.2.1.33.3.2.3.7
The upsFullControlGroup defines the objects that are
common to the Control groups of fully compliant UPSs.
.1.3.6.1.2.1.33.3.2.3.8
The upsFullConfigGroup defines the objects that are
common to the Config groups of fully compliant UPSs.
.1.3.6.1.2.1.33.3.2.3.9
Compliance Statements (3)

OID .1.3.6.1.2.1.33.3.1.1
The compliance statement for UPSs that only support
the two-contact communication protocol.
Required groups
Object refinements
ObjectAccessSyntaxDescription
upsBatteryStatus
Enumeration
batteryNormal(2), batteryLow(3)
Support of the values unknown(1) and
batteryDepleted(4) is not required.
upsAlarmDescr
Support of all `well known' alarm types is not
required. The well known alarm types which must be
supported are: upsAlarmOnBattery, upsAlarmLowBattery,
upsAlarmInputBad, upsAlarmUpsOutputOff,
upsAlarmUpsSystemOff, and upsAlarmTestInProgress.
upsOutputSource
Enumeration
normal(3), battery(5)
Support of the values other(1), none(2), bypass(4),
booster(6) and reducer(7) is not required.
upsShutdownType readonly
Read-write access is not required, i.e., compliant
systems need not support more than one shutdown type.
upsAutoRestart readonly
Read-write access is not required, i.e., compliant
systems need not support more than one restart type.
upsConfigInputVoltage readonly
Read-write access is not required.
upsConfigInputFreq readonly
Read-write access is not required.
upsConfigOutputVoltage readonly
Read-write access is not required.
upsConfigOutputFreq readonly
Read-write access is not required.

OID .1.3.6.1.2.1.33.3.1.2
The compliance statement for UPSs that support
full-featured functions, such as control.
Required groups
mandatory upsBasicIdentGroup
mandatory upsBasicBatteryGroup
mandatory upsBasicInputGroup
mandatory upsBasicOutputGroup
mandatory upsBasicAlarmGroup
mandatory upsBasicTestGroup
mandatory upsBasicControlGroup
mandatory upsBasicConfigGroup
optional upsBasicBypassGroup The upsBasicBypassGroup is only required for UPSs
that have a Bypass present.
Object refinements
ObjectAccessSyntaxDescription
upsAlarmDescr
Support of all `well known' alarm types is not
required. The well known alarm types which must be
supported are: upsAlarmOnBattery, upsAlarmLowBattery,
upsAlarmDepletedBattery, upsAlarmTempBad,
upsAlarmInputBad, upsAlarmOutputOverload,
upsAlarmOnBypass, upsAlarmBypassBad,
upsAlarmOutputOffAsRequested,
upsAlarmUpsOffAsRequested, upsAlarmUpsOutputOff,
upsAlarmUpsSystemOff, upsAlarmGeneralFault,
upsAlarmDiagnosticTestFailed,
upsAlarmCommunicationsLost, upsAlarmShutdownPending,
and upsAlarmTestInProgress.
upsTestId
Support of all `well known' test types is not
required. If no tests are supported, then the only
well known test type which must be supported is
upsTestNoTestsInitiated.
upsOutputSource
Enumeration
normal(3), battery(5)
Support of the values other(1), none(2), bypass(4),
booster(6) and reducer(7) is not required.
upsShutdownType readonly
Read-write access is not required, i.e., compliant
systems need not support more than one shutdown type.
upsAutoRestart readonly
Read-write access is not required, i.e., compliant
systems need not support more than one restart type.
upsConfigInputVoltage readonly
Read-write access is not required.
upsConfigInputFreq readonly
Read-write access is not required.
upsConfigOutputVoltage readonly
Read-write access is not required.
upsConfigOutputFreq readonly
Read-write access is not required.
upsConfigLowBattTime
Implementation of all possible values may be onerous
for some systems. Consequently, not all possible
values must be supported. However, at least two
different manufacturer-selected values must be
supported.

OID .1.3.6.1.2.1.33.3.1.3
The compliance statement for UPSs that support
advanced full-featured functions.
Required groups
mandatory upsFullIdentGroup
mandatory upsFullBatteryGroup
mandatory upsFullInputGroup
mandatory upsFullOutputGroup
mandatory upsFullAlarmGroup
mandatory upsFullTestGroup
mandatory upsFullControlGroup
mandatory upsFullConfigGroup
optional upsFullBypassGroup The upsFullBypassGroup is only required for UPSs that
have a Bypass present.
Object refinements
ObjectAccessSyntaxDescription
upsAlarmDescr
Support of all `well known' alarm types is not
required. The well known alarm types which must be
supported are: upsAlarmBatteryBad, upsAlarmOnBattery,
upsAlarmLowBattery, upsAlarmDepletedBattery,
upsAlarmTempBad, upsAlarmInputBad, upsAlarmOnBypass,
upsAlarmBypassBad, upsAlarmOutputOffAsRequested,
upsAlarmUpsOffAsRequested, upsAlarmUpsOutputOff,
upsAlarmUpsSystemOff, upsAlarmGeneralFault,
upsAlarmDiagnosticTestFailed,
upsAlarmCommunicationsLost, upsAlarmShutdownPending,
and upsAlarmTestInProgress.
upsTestId
Support of all `well known' test types is not
required. The well known test types which must be
supported are: upsTestNoTestsInitiated,
upsTestGeneralSystemsTest, and
upsTestQuickBatteryTest.
upsOutputSource
Enumeration
normal(3), battery(5)
Support of the values other(1), none(2), bypass(4),
booster(6) and reducer(7) is not required.
upsShutdownType readonly
Read-write access is not required, i.e., compliant
systems need not support more than one shutdown type.
upsAutoRestart readonly
Read-write access is not required, i.e., compliant
systems need not support more than one restart type.
upsConfigInputVoltage readonly
Read-write access is not required.
upsConfigInputFreq readonly
Read-write access is not required.
upsConfigOutputVoltage readonly
Read-write access is not required.
upsConfigOutputFreq readonly
Read-write access is not required.
upsConfigLowBattTime
Implementation of all possible values may be onerous
for some systems. Consequently, not all possible
values must be supported. However, at least two
different manufacturer-selected values must be
supported.
Notifications / Traps (4)
NameOIDDescription
.1.3.6.1.2.1.33.2.1
The UPS is operating on battery power. This trap is
persistent and is resent at one minute intervals until
the UPS either turns off or is no longer running on
battery.
.1.3.6.1.2.1.33.2.2
This trap is sent upon completion of a UPS diagnostic
test.
.1.3.6.1.2.1.33.2.3
This trap is sent each time an alarm is inserted into
to the alarm table. It is sent on the insertion of
all alarms except for upsAlarmOnBattery and
upsAlarmTestInProgress.
.1.3.6.1.2.1.33.2.4
This trap is sent each time an alarm is removed from
the alarm table. It is sent on the removal of all
alarms except for upsAlarmTestInProgress.