Eaton UPS

Eaton offers network management cards for many of their UPS lines that provide a web management console and SNMP server. The “Eaton Gigabit Network Card (NETWORK-M2)” is the offering at time of writing.

For SNMP, this card implements the RFC 1628 UPS standard as well as an Eaton specific set of objects¹ starting at 1.3.6.1.4.1.534.

snmpwalk -v1 -c public your.ups.address

snmpwalk -v1 -c public your.ups.address 1.3.6.1.4.1.534 

To make sense of these you need the Eaton MIBs². If you download and extract to your working folder you can query like this.

snmpwalk -v1 -c public -m +./EATON-OIDS.txt:./EATON-EMP-MIB.txt:./XUPS-MIB.txt your.ups.address 1.3.6.1.4.1.534 

Some useful MIBs are:

You’d query these like so:

snmpget  -v1 -c public -m +./EATON-OIDS.txt:./EATON-EMP-MIB.txt:./XUPS-MIB.txt your.ups.address \
sysLocation.0 xupsInputVoltage.1 xupsOutputSource.0 xupsBatVoltage.0 xupsInputFrequency.0 xupsOutputWatts.1 xupsEnvAmbientTemp.0

Some objects need a .0 here and others a .1 as shown above.

Notes

The object xupsOutputSource is generally used to determine if the UPS is ‘on battery’³. There is a trap specifically for OnBattery, but you can’t query the traps.

xupsOutputSource OBJECT-TYPE
    SYNTAX  INTEGER {
        other(1),
        none(2),
        normal(3),              
        bypass(4),
        battery(5),
        booster(6),             
        reducer(7),             
        parallelCapacity(8),    
        parallelRedundant(9),   
        highEfficiencyMode(10), 
        maintenanceBypass(11),   
        essMode(12)   
        }

Troubleshooting

There is no such variable name in this MIB

You might need to “walk” the object to get the instance ID as .0 is only for scalar objects, and not tabular.

snmpget  -v1 -c public -m +./EATON-OIDS.txt:./EATON-EMP-MIB.txt:./XUPS-MIB.txt your.ups.address xupsInputVoltage.0
Error in packet
Reason: (noSuchName) There is no such variable name in this MIB.
Failed object: XUPS-MIB::xupsInputVoltage.0

snmpwalk  -v1 -c public -m +./EATON-OIDS.txt:./EATON-EMP-MIB.txt:./XUPS-MIB.txt your.ups.address xupsInputVoltage
XUPS-MIB::xupsInputVoltage.1 = INTEGER: 116 RMS Volts

snmpget  -v1 -c public -m +./EATON-OIDS.txt:./EATON-EMP-MIB.txt:./XUPS-MIB.txt your.ups.address xupsInputVoltage.1
XUPS-MIB::xupsInputVoltage.1 = INTEGER: 116 RMS Volts

Resources