Python daemon for controlling/sequentially executing commands to PDUs (Power Distribution Units)
Why is this needed?
Most PDUs have a very low power microprocessor, or low quality software, which cannot handle multiple requests at the same time. This quickly becomes an issue in environments that use power control frequently, such as board farms, and gets worse on PDUs that have a large number of controllable ports.
Every PDU manufacturer has a different way of controlling their PDUs. Though many support SNMP, there's still no single simple way to communicate with all PDUs if you have a mix of brands.
Supported devices list
APC, Devantech and ACME are well supported, however there is no official list yet. The strategies.py file is a good place to see all the current drivers.
Debian packages are on the way, hopefully.
For now, make sure the requirements are met and then:
python3 setup.py install
To be added.
Making a power control request
HTTP The daemon can accept requests over plain HTTP. The port is configurable, but defaults to 16421 There is no encryption or authentication, consider yourself warned. To enable, change the 'listener' setting in the 'daemon' section of the config file to 'http'. This will break 'pduclient' requests.
An example request would be
- HTTP 200 - Request Accepted
- HTTP 503 - Invalid Request, Request not accepted
pduclient The bundled client is used when PDUDaemon is configured to listen to 'tcp' requests.
Usage: pduclient --daemon deamonhostname --hostname pduhostname --port pduportnum --command pducommand PDUDaemon client Options: -h, --help show this help message and exit --daemon=PDUDAEMONHOSTNAME PDUDaemon listener hostname (ex: localhost) --hostname=PDUHOSTNAME PDU Hostname (ex: pdu05) --port=PDUPORTNUM PDU Portnumber (ex: 04) --command=PDUCOMMAND PDU command (ex: reboot|on|off) --delay=PDUDELAY Delay before command runs, or between off/on when rebooting (ex: 5)
PDUDaemon was written to accept "plugin" style driver files. There's no official example yet, so take a look in the drivers directory and see if you can adapt one.
Why can't PDUDaemon do $REQUIREMENT?
Patches welcome, as long as it keeps the system simple and lightweight.
#pdudaemon on Freenode