1MGE-SHUT(8)                       NUT Manual                       MGE-SHUT(8)
2
3
4

NAME

6       mge-shut - Driver for SHUT Protocol UPS equipment
7

SYNOPSIS

9       mge-shut -h
10
11       mge-shut -a UPS_NAME [OPTIONS]
12
13           Note
14           This man page only documents the hardware-specific features of the
15           mge-shut driver. For information about the core driver, see
16           nutupsdrv(8).
17

SUPPORTED HARDWARE

19       mge-shut supports all recent Eaton, MGE and Dell UPS models which use
20       the SHUT (Serial HID UPS Transfer) protocol.
21
22       Older MGE models, such as Pulsar ESV+, Pulsar EX and Pulsar ES+, use
23       the U-Talk protocol and should use the mge-utalk driver.
24

EXTRA ARGUMENTS

26       This driver also supports the following optional settings:
27
28       lowbatt=num
29           Set the low battery warning threshold at which shutdown is
30           initiated by upsmon(8).
31
32           The factory default value is 30 (in percent), and can be settable
33           depending on the exact model.
34
35       offdelay=num
36           Set the timer before the UPS is turned off after the kill power
37           command is sent (via the -k switch).
38
39           The default value is 20 (in seconds). Usually this must be lower
40           than ondelay, but the driver will not warn you upon startup if it
41           isn’t.
42
43       ondelay=num
44           Set the timer for the UPS to switch on in case the power returns
45           after the kill power command had been sent but before the actual
46           switch off. This ensures the machines connected to the UPS are, in
47           all cases, rebooted after a power failure.
48
49           The default value is 30 (in seconds). Usually this must be greater
50           than offdelay, but the driver will not warn you upon startup if it
51           isn’t. Some UPSes will restart no matter what, even if the power is
52           (still) out at the moment this timer elapses. In that case, you
53           could try if setting ondelay = -1 in ups.conf helps.
54
55               Warning
56               ondelay parameter was set in ten seconds unit in the legacy
57               mge-shut driver ( 3 for 30 seconds) . It is now set in seconds
58               ( 30 for 30 seconds). Make sure you use the correct unit in
59               your configuration.
60
61       notification=num
62           Set notification type to 1 (no), 2 (light) or 3 (yes).
63
64           This argument is ignored. It is only here for backward
65           compatibility.
66

KNOWN ISSUES

68   Repetitive timeout and staleness
69       Some models tends to be unresponsive with the default polling
70       frequency. The result is that you have some "data stale" errors in your
71       system log.
72
73       In this case, simply modify the general parameter "pollinterval" to a
74       higher value (like 10 for 10 seconds). This should solve the issue.
75
76       Using notification=3 might also help.
77

AUTHOR

79       Arnaud Quette
80

SEE ALSO

82   The core driver
83       nutupsdrv(8)
84
85   Internet resources
86       The NUT (Network UPS Tools) home page: http://www.networkupstools.org/
87
88
89
90Network UPS Tools 2.8.0           04/26/2022                       MGE-SHUT(8)
Impressum