This man page only documents the hardware-specific features of the netxml-ups driver. For information about the core driver, see nutupsdrv(8).
netxml-ups support all recent Eaton / MGE models which use a Network Management Card or Proxy (MGE XML/HTTP protocol based). This applies to both Eaton (previously MGE Office Protection Systems) and to MGE UPS SYSTEMS. Supported card and proxy models are:
Older models, such as SNMP card (Ref 66062 and Ref 66045), use the SNMP protocol and should use the snmp-ups(8) driver with the "mibs=mge" parameter.
This driver supports the following optional settings in the ups.conf(5):
This value must never be higher than half the MAXAGE value specified in upsd.conf(5), otherwise you run the risk that upsd(8) declares the driver stale while it is waiting for a connection to timeout.
The hostname of the UPS is specified with the "port" value in ups.conf, i.e.:
[mgexml] driver = netxml-ups port = http://netxml-ups.example.com:80
Specifying the method to connect to the UPS (http, https) is mandatory. If the port is equal to the default for the method specified (80 for http, 443 for https) it may be omitted.
In order not to overload older NMCs by polling them too frequently, it is recommended to increase the "pollinterval" (see nutupsdrv(8)) and ups.conf(5)) to at least 5 seconds.
Don't connect to the UPS through a proxy. Although it would be trivial to add support for proxies, this is not recommended and don't ask for it. Not only because it will prevent the driver to make a persistent connection to the UPS, but also it adds an additional failure mode. If the proxy goes down (for whatever reason), the driver will no longer be able to reach the UPS.
Arjen de Korte <firstname.lastname@example.org>
The NUT (Network UPS Tools) home page: http://www.networkupstools.org/