Scroll to navigation

PDUCLIENT(1) pduclient User Manual PDUCLIENT(1)

NAME

pduclient - program to automate power control of a device

SYNOPSIS

pduclient --daemon daemonhostname --hostname pduhostname --port pduportnumber --command pducommand

pduclient [{-h | --help}]

DESCRIPTION

This manual page documents briefly the pduclient command.

pduclient is the frontend for lavapdu to issue commands to a Power Distribution Unit (PDU). Commands include on, off and reboot.

A particular device will be connected to a particular port on a PDU. The lavapdu-runner is able to control multiple PDUs, specified by hostname. pduclient connects to the lavapdu-listen daemon which stores the command until the lavapdu-runner daemon is able to connect to the specified PDU and execute the command on the specified port.

Typically, pduclient will be used from the device configuration file of a LAVA instance, using lava-dispatcher.

REVERSE LOOKUPS

pduclient needs the hostname of the calling machine to match a DNS reverse lookup. This means that not only does hostname -f need to resolve to an IP address but that IP address must resolve to that hostname:


$ dig myhostname.domain
...
192.168.0.56
...


$ dig -x 192.168.0.56
...
myhostname.domain
...

If the second call does not work, you will need to fix the local DNS resolution before pduclient will operate. Error messages will look something like:


Unknown error sending command! control replied: nack

OPTIONS

--daemon daemonhostname

Determines the hostname of the hostname which is running lavapdu-listen to which the client can connect and add the command to the queue.

--hostname pduhostname

The PDU which will run the command.

--port pduportnumber

The port on the specified PDU to which the device is connected.

--command pducommand

The command to run on the specified port of the specified PDU.

-h, --help

Show a summary of the required commands.

SEE ALSO

lavapdu-listen(8), lavapdu-runner(8)

AUTHOR

Matthew Hart <matthew.hart@linaro.org>

Wrote this manpage for the Debian system.

COPYRIGHT

Copyright © 2014 Matthew Hart

This manual page was written for the Debian system (and may be used by others).

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 or (at your option) any later version published by the Free Software Foundation.

On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.

04/02/2021 pduclient