Difference between revisions of "Ipmitool"

From Nuclear Physics Group Documentation Pages
Jump to navigationJump to search
Line 54: Line 54:
 
== Sample Commands ==
 
== Sample Commands ==
  
To check the power status of [[Taro]] you would use this command, which will prompt for a password:
+
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.
  
ipmitool -U ADMIN -H 10.0.0.147 -a chassis power status
+
To check the power status of an IPMI enabled machine you would use this command, which will prompt for a password:
  
To remotely power on [[Taro]]:
+
ipmitool -U ADMIN -H <ip address> -a chassis power status
  
  ipmitool -U ADMIN -H 10.0.0.147 -a chassis power on
+
To remotely power on an IPMI enabled machine:
  
To remotely perform a hard reset of [[Taro]]:
+
  ipmitool -U ADMIN -H <ip address> -a chassis power on
  
  ipmitool -U ADMIN -H 10.0.0.147 -a chassis power reset
+
To remotely perform a hard reset of an IPMI enabled machine:
  
To query the current Power-On Hours Counter for [[Taro]]:
+
  ipmitool -U ADMIN -H <ip address> -a chassis power reset
  
  ipmitool -U ADMIN -H 10.0.0.147 -a chassis poh
+
To query the current Power-On Hours Counter for an IPMI enabled machine:
  
To instruct [[Taro]] to stay off in the event of a power outage:
+
  ipmitool -U ADMIN -H <ip address> -a chassis poh
  
ipmitool -U ADMIN -H 10.0.0.147 -a chassis policy always-off
+
To instruct an IPMI enabled machine to stay off in the event of a power outage:
  
Any of these commands will work the same way with the other IPMI enabled systems. Just make sure to use the correct IP address of the system.
+
ipmitool -U ADMIN -H <ip addresss> -a chassis policy always-off

Revision as of 21:43, 25 October 2009

ipmitool is a Linux command line utility for sending commands to remote ipmi interfaces.

Using ipmitool

The basic syntax for ipmitool is:

ipmitool [option] <command>

For a full list of commands and options see the ipmitool ipmitool Man page.

Usage

ipmitool Options

-a
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.

IPMI Commands

Chassis

poh
Returns the power-on hours counter.
restart_cause
Queries for the cause of the last system restart.
policy
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.
power
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


Sample Commands

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