NAME
mge-shut, newmge-shut - Driver for SHUT Protocol UPS equipment
NOTE
This man page only documents the hardware-specific features of the
mge-shut driver. For information about the core driver, see
nutupsdrv(8).
SUPPORTED HARDWARE
mge-shut support all recent Eaton, MGE and Dell UPS models which use
the SHUT (Serial HID UPS Transfer) protocol.
Older MGE models, such as Pulsar ESV+, Pulsar EX and Pulsar ES+, use
the U-Talk protocol and should use the mge-utalk driver.
EXTRA ARGUMENTS
This driver supports the following optional settings in the
ups.conf(5):
lowbatt=num
Set the low battery warning threshold at which shutdown is
initiated by upsmon(8). The factory default value is 30 (in
percentage), and only be settable depending on the exact model.
offdelay=num
Set the timer before the UPS is turned off after the kill power
command is sent (via the -k switch). The default value is 20
(in seconds), and MUST BE LOWER than ondelay.
ondelay=num
Set the timer for the UPS to switch on in case the power returns
after the kill power command had been sent but before the actual
switch off. This ensures the machines connected to the UPS are,
in all cases, rebooted after a power failure. The default value
is 3 (in 10 seconds units, which means 30 seconds), and MUST BE
GREATER than offdelay.
notification=num
Set notification type to 1 (no), 2 (light) or 3 (yes). The
default value is 3 (yes) because of some early Ellipse models
which need it.
KNOWN ISSUES
Pulsar Ellipse S: Repetitive stale status - Loss of communication
Several users have reported "data stale" errors with Pulsar Ellipse
equipment. This lasts around 10 seconds and happens once every few
hours. This is due to the fact that the SHUT protocol is verbose, and
the driver sometimes does not handle all of it during the usual polling
interval in upsd. To solve this problem, change the value of MAXAGE to
25 in upsd.conf. Also add "notification=3" in ups.conf (thanks to
Julien Lesaint and Fabien).
AUTHOR
Arnaud Quette <arnaud.quette@free.fr> or <arnaud.quette@mgeups.com>
Philippe Marzouk <philm@users.sourceforge.net>
SEE ALSO
The core driver:
nutupsdrv(8)
Internet resources:
The NUT (Network UPS Tools) home page: http://www.networkupstools.org/
MGE UPS SYSTEMS SHUT protocol information:
http://random.networkupstools.org/protocols/mge/
Thu Nov 19 2009 mge-shut(8)