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.
07/29/2014 pduclient