Avocent (formerly Cyclades) is a supplier for various datacenter management tools. They are best known for their rackmounted power distribution units and their serial console servers. Both devices run Linux and have been around for years.
Both the now EOL'd devices from Cyclades as well as the newer devices from Avocent can powercycle devices either through a serially attached smart PDU or through IPMI. Every device under the Advanced Console Server (ACS) label can control IPMI devices with a recent firmware.
While the functionality of the attached PDUs is quite well documented, there's no matching documentation for the IPMI interface. The web-interface works but the logic is mostly inside the AcsWeb webserver binary.
There's a cyc_ipmicmd binary but that one doesn't offer any --help functionality to explain how to call it.
For future reference here's the missing man page:
cyc_ipmicmd(1) General Commands Manual cyc_ipmicmd(1)
NAME
cyc_ipmicmd - utility for power cycling servers via IPMI
SYNOPSIS
cyc_ipmicmd SERVER COMMAND
DESCRIPTION
The cyc_ipmicmd utility is a wrapper around /bin/ipmitool which allows to send IPMI
power commands such as On, Off, Status and Cycle to configured devices.
The server address as well as necessary authentication data is taken from
/etc/IPMIServer.conf.
CONFIG FILE FORMAT
The /etc/IPMIServer.conf file contains the necessary data to successfully send IPMI
commands to remote devices.
Each line contains one remote server definition with the following colon separated
fields:
- Numerical server ID (starting at 1)
- IP address
- Authentication Type (none, password, md2, md5)
- Access Level (user, operator, admin)
- Username
- Password
- Alias (human readable name)
An example line might look as follows:
1:192.168.0.1:password:operator:user:pass:Example Server:
SERVER parameter
The server parameter is the numerical server ID taken from the first field of the
configuration file.
COMMAND parameter
The command parameter is numerical code which specifies which command is being
sent to the remote IPMI device.
0 Off
Poweroff the server
1 On
Poweron the server
2 Status
Reportpower status
3 Cycle
Powercycle the server
EXAMPLES:
Powercycle the first server:
cyc_ipmicmd 1 3
AUTHOR:
Andreas Thienemann