UPSs over SNMP

WISPMap reads UPSs over SNMP: APC (with a network management card), CyberPower (with an RMCARD), and any other UPS that supports the standard UPS-MIB (RFC 1628).

What you get

On the UPS's page: whether it's on mains or on battery, its charge, the runtime it reports at the current load, its load and input voltage, and a replace battery badge when its own battery test says so.

You also get the UPS battery needs replacing alert when the UPS reports it.

Turn on SNMP

• APC network management card: under Configuration → Network → SNMPv1 → Access, enable it and set a read-only community (and restrict it to the collector's address under Access Control), or set up an SNMPv3 user under SNMPv3.
• CyberPower RMCARD: under Network Service → SNMP Settings, set a read-only community, or an SNMPv3 user.
• Other makes: look for SNMP in the UPS's network card settings. WISPMap uses the standard UPS-MIB.

Then add the credentials to the collector's .env (how) and the UPS in Admin → Devices with Kind SNMP (other makes) and Role Other.

A UPS as the site's power device

WISPMap follows a site's power from its battery voltage: mains, on battery, low and critical. Usually that's the voltage a router powered from the battery reads. A UPS knows better, so it can take that place:

1. Open the site in Admin → Sites.
2. Set Power to a type with a battery (for example Grid + battery) and Battery to its voltage (12, 24 or 48 V).
3. Set Battery voltage from to the UPS.

Then:

• the site goes on battery the moment the UPS says it switched, not only when the voltage sags, and back to mains as soon as the UPS says so;
• while it's on battery, the time left on the map and in the alert is the UPS's own estimate, which it measures at the actual load;
• low and critical still come from the battery voltage, at the same levels as for a router.