1 NUT outlets management and PDU notes
2 ====================================
4 NUT supports advanced outlets management for any kind of device that proposes
5 it. This chapter introduces how to manage outlets in general, and how to take
6 advantage of the provided features.
11 Outlets are the core of Power Distribution Units. They allow you to turn on,
12 turn off or cycle the load on each outlet.
14 Some UPS models also provide manageable outlets (Eaton, MGE, Powerware,
15 Tripplite, ...) that help save power in various ways, and manage loads more
18 Finally, some devices can be managed in a PDU-like way. Consider blade systems:
19 the blade chassis can be controlled remotely to turn on, turn off or
20 cycle the power on individual blade servers.
22 NUT allows you to control all these devices!
25 NUT outlet data collection
26 --------------------------
28 NUT provides a complete and uniform integration of outlets related data,
29 through the 'outlet' collection.
31 First, there is a special outlet, called 'main outlet'.
32 You can access it through 'outlet.{id, desc, ...}' without any index.
34 Any modification through the 'main outlet' will affect *all* outlets.
35 For example, calling the command 'outlet.load.cycle' will cycle all outlets.
37 Next, outlets index starts from *1*. Index '0' is implicitly reserved to
38 the 'main outlet'. So the first outlet is 'outlet.1.*'.
40 For a complete list of outlet data and commands, refer to the
41 <<nut-names,NUT command and variable naming scheme>>.
43 An example upsc output (data/epdu-managed.dev) is available in the source
46 NOTE: The variables supported depend on the exact device type.
52 Smart Power Distribution Units provide at least various meters, related to
53 current, power and voltage.
55 Some more advanced devices also provide control through the 'load.off',
56 'load.on' and 'load.cycle' commands.
61 Some advanced Uninterruptible Power Supplies provide smart outlet management.
63 This allows to program a limited backup time to non-critical loads in order
64 to keep the maximum of the battery reserve for critical equipment.
66 This also allows the same remote electrical management of devices provided
67 by PDUs, which can be very interesting in Data Centers.
69 For example, on small setup, you can plug printers, USB devices, hubs, (...)
70 into managed outlets. Depending on your UPS's capabilities, you will be able to
73 - after some minutes of back-up time using 'outlet.n.delay.start',
74 - when reaching a percentage battery charge using
75 'outlet.n.autoswitch.charge.low'.
77 This will ensure a maximum runtime for the computer.
79 On bigger systems, with bigger UPSs, this is the same thing with servers
80 instead of small devices.
82 NOTE: If you need the scheduling function and your device doesn't support
84 <<Advanced_usage_scheduling_notes,NUT scheduling features>>.
86 WARNING: don't plug the UPS's communication cable (USB or network) on a managed outlet.
87 Otherwise, all computers will be stopped as soon as the communication is lost.
92 As mentioned in the introduction, some other devices can be considered and managed like
93 PDUs. This is the case in most blade systems, where the blade chassis offers
94 power management services.
96 This way, you can control remotely each blade server as if it were a PDU
99 This category of devices is generally called Remote Power Controls - RPC in NUT.