Document Audience: SPECTRUM

Document ID:

213339

Old Document ID:

(formerly 88377)

Title:

How to collect data from a x86/x64 platform using Intelligent Platform

Management Interface (IPMI).

Copyright Notice:

Copyright ? 2008 Sun Microsystems, Inc. All Rights Reserved

Update Date:

Wed Jul 16 00:00:00

MDT 2008

Solution Type Technical Instruction

Solution 213339 : How to collect data from a x86/x64 platform using Intelligent Platform
Management Interface (IPMI).
Related Categories

Home>Product>Systems>Servers

Description
IPMIisanopenstandardformonitoring,logging,recovery,inventory,
andcontrolofhardwarethatisimplementedindependentofthemainCPU,
BIOS,andOS.Theserviceprocessor(orBaseboardManagementController,
BMC)isthebrainbehindplatformmanagementanditsprimarypurposeis
tohandletheautonomoussensormonitoringandeventloggingfeatures.

Available for this topic, a Video Tutorial; Brief how-to video tutorials that provide step-by-step
instructions answering Sun's most frequently asked questions. View the video answer and/or
follow the detailed instructions below.
Click here to view the VideoTutorial
Learn more about this topic by viewing our related Web Based Training
Steps to Follow
TocollecttheinformationfromtheBMCwecanmakeuseoftheILOMora
separateipmitool.

ILOM, BMC and SMDC (x2100) are all forms of system processor.
Note: On Sun blade products, the cabinet is equipped with a separate service processor that
supports cabinet-level functionality, such as fans and power supplies, and that provides access to
the service processors on the blades. This cabinet-level service processor is called a Chassis
Management Module (CMM).

ILOM SP hardware. Graphics Redirect and Service Processor (GRASP) board that performs the
the following functions
1. Monitors the status and configuration of field-replaceable components of your server,
such as fans, disk drives, and power supplies
2. Provides serial and Ethernet connections to external terminals or local area networks
(LANs)
ILOM SP firmware. Preinstalled on the GRASP board is a library of system management firmware
applications. This ILOM firmware is operating system independent. These firmware applications
provide the following system management interfaces into your server
1.
2.
3.
4.
5.

A web-based graphical interface

A Secure Shell (SSH) command-line interface
An IPMI v2.0 command interface
A Simple Network Management Protocol (SNMP) v1, v2c, or v3 interface
Remote Console application. The Remote Console application is a piece of layered
software that allows remote clients to view the graphical console of your host server as
though they were directly attached its video connector. The Remote Console is a mirror
of the 1024x768 output from the server s VGA video connector. The remote keyboard,
mouse, CD drive or diskette drive will appear as standard USB devices.

The ILOM uses a utility in the ILOM Service Processor (SP) firmware to collect some ipmi info.
The ipmitool program provides a simple command-line interface to this BMC.
This program lets you manage Intelligent Platform Management Interface (IPMI) functions of
either the local system, via a kernel device driver, or a remote system, using IPMI v1.5 and IPMI
v2.0.
These functions include printing FRU information, LAN configuration, sensor readings, and
remote chassis power control.
It features the ability to read the sensor data repository (SDR) and print sensor values, display the
contents of the System Event Log (SEL), print Field Replaceable Unit (FRU) inventory
information, read and set LAN configuration parameters, and perform remote chassis power
control.
To download ipmitool see http://sourceforge.net/projects/ipmitool/
Solaris and the latest Technical Instruction < Solution: 203335 > Sun Explorer[TM} Data Collector,
will collect the following ipmitool information.
/usr/sfw/bin/ipmitool chassis status '

'/usr/sfw/bin/ipmitool fru'
'/usr/sfw/bin/ipmitool pef status'
'/usr/sfw/bin/ipmitool pef list'
'/usr/sfw/bin/ipmitool sel info'
'/usr/sfw/bin/ipmitool sel elist'
'/usr/sfw/bin/ipmitool sdr list all info'
Command overview, see man ipmitool:
ipmitool -I bmc help
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

event

Send pre-defined 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 IPMIv2.0 Serial-over-LAN

isol

Configure IPMIv1.5 Serial-over-LAN

user
channel

Configure Management Controller users

Configure Management Controller channels

sunoem
session
exec
set

OEM Commands for Sun servers

Print session information
Run list of commands from file
Set runtime variable for shell and exec

ipmitool -I bmc chassis help

chassis Commands: status, power, identify, policy, restart_cause, poh, bootdev
ipmitool -I bmc chassis power help
chassis power Commands: status, on, off, cycle, reset, diag, soft
bmc|mc
reset <warm|cold>
Instructs the BMC to perform a warm or cold reset.
Most used commands to collect information and for configuration:
# ipmitool -I lan -H <ILOM IP address> -U <ILOM Username> sel elist
# ipmitool -I lan -H <ILOM IP address> -U <ILOM Username> fru
# ipmitool -I lan -H <ILOM IP address> -U <ILOM Username> sensor
# ipmitool -I lan -H <ILOM IP address> -U <ILOM Username> sunoem led get all
# ipmitool -I lan -H <ILOM IP address> -U <ILOM Username> sdr elist
# ipmitool -I lan -H <ILOM IP address> -U <ILOM Username> sdr elist full
# ipmitool -I lan -H <ILOM IP address> -U <ILOM Username> sdr elist all
# ipmitool -I lan -H <ILOM IP address> -U <ILOM Username> chassis status
# ipmitool -I lan -H <ILOM IP address> -U <ILOM Username> -v sdr
# ipmitool -I lan -H <ILOM IP address> -U <ILOM Username> -f passfile fru
# ipmitool -I lan -H <ILOM IP address> -U <ILOM Username> bmc reset cold

# ipmitool -I lan -H <ILOM IP address> -U <ILOM Username> chassis power off

# ipmitool -I lan -H <ILOM IP address> -U <ILOM Username> chassis power on
Changing the ILOM password with IPMItool
this one will prompt for the exisiting password.
# ipmitool -I lan -H <ILOM IP address> -U root user set password 2 <newpassword>
Examples:
Example 1 : Listing remote sensors:
# ipmitool -I lan -H 1.2.3.4 -f passfile sdr list
Baseboard 1.25V | 1.24 Volts

| ok

Baseboard 2.5V | 2.49 Volts

| ok

Baseboard 3.3V | 3.32 Volts

| ok

Example 2: Displaying status of a remote sensor:

# ipmitool -I lan -H 1.2.3.4 -f passfile sensor get
"Baseboard 1.25V"
Locating sensor record...
Sensor ID

: Baseboard 1.25V (0x10)

Sensor Type (Analog) : Voltage

Sensor Reading
Status

: 1.245 (+/- 0.039) Volts

: ok

Example 3: Displaying the power status of a remote chassis:

# ipmitool -I lan -H 1.2.3.4 -f passfile chassis power status
Chassis Power is on
Example 4: Controlling the power on a remote chassis:

# ipmitool -I lan -H 1.2.3.4 -f passfile chassis power on

Chassis Power Control: Up/On
Example 5: Collecting fru information of the platform:
# ipmitool -I lan -H 1.2.3.4-f passfile fru
FRU Device Description : Builtin FRU Device (ID 0)
Board Product

: ASSY,SERV PROCESSOR,A64/A6

Board Serial

: 1762TH1-0640001751

Board Part Number : 501-6979-05

Board Extra

: 50

Board Extra

: A64/A65_GRASP

Product Manufacturer : SUN MICROSYSTEMS

Product Name

: ILOM

FRU Device Description : sp.net0.fru (ID 2)

etc......

Product
SunLX50Server
SunCustomerReadyHPCCluster
SunFireX4600Server
SunFireX4600M2Server
SunFireX4500Server
SunFireX4200Server
SunFireX4200M2Server
SunFireX4100Server
SunFireX4100M2Server
SunFireX2200M2Server
SunFireX2100Server
SunFireX2100M2Server
SunFireV65xServer
SunFireV60xServer
SunFireV60xComputeGridRackSystem
SunFireV40zServer
SunFireV20zServer

SunFireV20zComputeGridRackSystem
RoHSSunFireX4200Server
RoHSSunFireX4100Server
N1SystemManager2.0
Keywords
ipmi,ipmitool,x64,x86,ilom,bmc,smdc

Previously Published As
88377

Change History
Date:20080715
UserName:79977
Action:Update
Comment:UpdatedlinktoSunExplorerDataCollector
Version:0

Attachments
Thissolutionhasnoattachment
This collection hosted on The Sun Partner Exchange Portal
Copyright (c) 1997 - 2008 Sun Microsystems, Inc