C H A P T E R  6

Using IPMI

This chapter describes the Intelligent Platform Management Interface (IPMI) functionality and lists the supported IPMI commands. It includes the following sections:


About IPMI

The Intelligent Platform Management Interface (IPMI) is an open-standard hardware management interface specification that defines a specific way for embedded management subsystems to communicate. IPMI information is exchanged through the service processor (SP), an IPMI-compliant hardware component. Using low-level hardware intelligence instead of the operating system has two main benefits: First, this configuration allows for out-of-band server management, and second, the operating system is not burdened with transporting system status data.

You can manage your server with the IPMI v.1.5/2.0 on your server or stand-alone server, which runs a daemon to do the following:

Your Sun Fire X4150 server is IPMI v2.0 compliant. You can access IPMI functionality through the command line with the IPMItool utility either in-band or out-of-band. Additionally, you can generate an IPMI-specific trap from the web interface or manage the server’s IPMI functions from any external management solution that is IPMI v1.81 or v2.0 compliant. For more information about the IPMI v2.0 specification, go to:

http://www.intel.com/design/servers/ipmi/spec.htm#spec2

IPMItool

IPMItool is a simple command-line interface that is useful for managing IPMI-enabled devices. You can use this utility to perform IPMI functions with a kernel device driver or over a LAN interface. IPMItool enables you to manage system field-replaceable units (FRUs), monitor system health, and monitor and manage system environmentals, independent of the operating system.

Download this tool from http://ipmitool.sourceforge.net/, or locate IPMItool and its related documentation on your server Tools and Drivers CD.

When IPMItool is installed, it includes a man page. To view it, enter:

man ipmitool

If your client machine has a default installation of Solaris 10, you can find a preinstalled version of IPMItool in the following directory:/usr/sfw/bin. The binary file is called ipmitool.

Sensors

Your server includes a number of IPMI-compliant sensors. Some sensors measure voltages, and temperature ranges, and others are capable of monitoring switches, such as the chassis interlocks, which detect whether the chassis cover is open or shut. For a complete list of sensors, see your platform supplement. To obtain sensor information on specific sensors, enter the following command:

ipmitool -H ipaddressof the SP -U username -P password [sensor|sdr]

The sensors can activate system fault lights, and register events in the system event log (SEL). To see the system event log from the IPMItool, at the prompt, enter the following command:

ipmitool -H ipaddress of the SP -U root -P password sel list

Depending on where IPMItool is installed from, the -P option might be missing. In such a case, do not type the -P in the previous command, and enter the password when prompted.


Supported IPMI 2.0 Commands

TABLE 6-2 lists the supported IPMI 2.0 commands.

For details on individual commands, see the IPMI Intelligent Platform Management Interface Design Specification, v2.0. A copy is available at:

http://www.intel.com/design/servers/ipmi/spec.htm


TABLE 6-1 Supported IPMI 2.0 Commands

Commands

Description

raw

Send a RAW IPMI request and print response

i2c

Send an I2C Master Write-Read command and print response

lan

Configure LAN channels

chassis

Get chassis status and set power state

power

Shortcut to chassis power commands

event

Send predefined events to MC

mc

Management Controller status and global enables

sdr

Print Sensor Data Repository entries and readings

sensor

Print detailed sensor information

fru

Print built-in FRU and scan SDR for FRU locators

sel

Print system event log (SEL)

pef

Configure platform event filtering (PEF)

sol

Configure and connect IPMIv2.0 Serial-over-LAN

tsol

Configure and connect with Tyan IPMIv1.5 Serial-over-LAN

isol

Configure IPMIv1.5 Serial-over-LAN

user

Configure Management Controller users

channel

Configure Management Controller channels

session

Print session information

sunoem

OEM commands for Sun servers

kontronoem

OEM commands for Kontron devices

picmg

Run a PICMG/ACTA extended cmd

fwum

Update IPMC using Kontron OEM Firmware Update Manager

exec

Run list of commands from file

set

Set runtime variable for shell and exec



TABLE 6-2 Supported IPMI 2.0 Commands

Supported IPMI 2.0 Commands

General Commands

Get Device ID

Cold Reset

Get Self Test Results

Set/Get ACPI Power State

Reset/Set/Get Watchdog Timer

Set/Get BMC Global Enables

Clear/Get Message Flags

Enable Message Channel Receive

Get/Send Message

Read Event Message Buffer

Get Channel Authentication Capabilities

Get Session Challenge

Activate/Close Session

Set Session Privilege Level

Get Session Info

Set/Get Channel Access

Get Channel Info

Set/Get User Access

Set/Get User Name

Set User Password

Master Write-Read

Set/Get System Boot Options

Set/Get Event Receiver IPMI

System Interface Support

KCS

BT

Serial Over LAN

RCMP

  • Multiple Payloads
  • Enhanced Authentication
  • Encryption

 

PEF and Alerting Commands

Get PEF Capabilities

Arm PEF Postpone Timer

Set/Get PEF Configuration Parameters

Set/Get Last Processed Event ID

Alert Immediate

PET Acknowledge

 

Sensor Device Commands

Get Sensor Reading Factors

Set/Get Sensor Hysteresis

Set/Get Sensor Threshold

Set/Get Sensor Event Enable

Get Sensor Reading

 

FRU Device Commands

Get FRU Inventory Area Info

Read/Write FRU Data SDR Device

Get SDR Repository Info

Get SDR Repository Allocation

Reserve SDR Repository

Get/Add SDR

Clear SDR Repository

Get SDR Repository Time

Run Initialization Agent

 

SEL Device Commands

Get SEL Info

Get SEL Allocation Info

Reserve SEL

Get/Add SEL Entry

Clear SEL

Set/Get SEL Time

 

LAN Device Commands

Get LAN Configuration Parameters

 

Serial/Modem Device Commands

Set/Get Serial Modem Configuration

Set Serial Modem MUX

Get TAP Response Codes

Serial/Modem Connection Active

Callback

Set/Get User Callback Options

 

Event Commands

Get Event Count

Set/Get Event Destination

Set/Get Event Reception State

Send ICMB Event Message