MGE-SHUT(8) NUT Manual MGE-SHUT(8)NAMEmge-shut - Driver for SHUT Protocol UPS equipment
SYNOPSISmge-shut-h
mge-shut-a UPS_NAME [OPTIONS]
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 HARDWAREmge-shut supports 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 also supports the following optional settings:
lowbatt=num
Set the low battery warning threshold at which shutdown is
initiated by upsmon(8).
The factory default value is 30 (in percent), and can 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). Usually this must be lower
than ondelay, but the driver will not warn you upon startup if it
isn’t.
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 30 (in seconds). Usually this must be greater
than offdelay, but the driver will not warn you upon startup if it
isn’t. Some UPS’es will restart no matter what, even if the power
is (still) out at the moment this timer elapses. In that case, you
could try if setting ondelay = -1 in ups.conf helps.
Warning
ondelay parameter was set in ten seconds unit in the legacy
mge-shut driver ( 3 for 30 seconds) . It is now set in seconds
( 30 for 30 seconds). Make sure you use the correct unit in
your configuration.
notification=num
Set notification type to 1 (no), 2 (light) or 3 (yes).
This argument is ignored. It is only here for backward
compatibility.
KNOWN ISSUES
Repetitive timeout and staleness
Some models tends to be unresponsive with the default polling
frequency. The result is that you have some "data stale" errors in your
system log.
In this case, simply modify the general parameter "pollinterval" to a
higher value (like 10 for 10 seconds). This should solve the issue.
Using notification=3 might also help.
AUTHOR
Arnaud Quette
SEE ALSO
The core driver
nutupsdrv(8)
Internet resources
The NUT (Network UPS Tools) home page: http://www.networkupstools.org/
Network UPS Tools 08/07/2012 MGE-SHUT(8)
