ipmitool is a Linux command line utility for sending commands to remote IPMI interfaces.
Use this command if you want to install ipmitool on a Redhat or Fedora machine:
$ sudo yum install OpenIPMI-tools
The basic syntax for ipmitool is:
ipmitool [option] <command>
For a full list of commands and options see the ipmitool ipmitool Man page.
- Prompts for a password.
- -H <address>
- Address of the remote server. This can be either a hostname or IP address, but because the IPMI cards are on the farm network and don't have hostnames attached to them you will need to use the appropriate IP address.
- -U <username>
- IPMI username. Currently the ADMIN account is configured and will allow access to all IPMI commands.
- Returns the power-on hours counter.
- Queries for the cause of the last system restart.
- Sets the system's policy regarding power failures. Options are as follows:
- list: Returns a list of supported policies.
- always-on: Turns system on when power is restored.
- previous: Returns to the previous state when power is restored.
- always-off: Stays off when power is restored.
- Allows the user to view and change the current power state.
- status: Returns the current power state.
- on: Power on.
- off: Powers off. WARNING: Does not cleanly shutdown the system.
- cycle: Cycles the power state off for one second.
- reset: Performs a hard reset.
- soft: Soft shutdown of the OS via ACPI
The following commands can be used from the command line to control IPMI enabled machines. Make sure to replace <ip address> with the IPMI address of the machine you want to access.
To check the power status of an IPMI enabled machine you would use this command, which will prompt for a password:
ipmitool -U ADMIN -H <ip address> -a chassis power status
To remotely power on an IPMI enabled machine:
ipmitool -U ADMIN -H <ip address> -a chassis power on
To remotely perform a hard reset of an IPMI enabled machine:
ipmitool -U ADMIN -H <ip address> -a chassis power reset
To query the current Power-On Hours Counter for an IPMI enabled machine:
ipmitool -U ADMIN -H <ip address> -a chassis poh
To instruct an IPMI enabled machine to stay off in the event of a power outage:
ipmitool -U ADMIN -H <ip addresss> -a chassis policy always-off