Embedded Lights Out Manager Administration Guide For the Sun Fire X4150 and X4450 Servers
|
|
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:
- Support low pin count (LPC) host interface in two modes:
- KCS Mode (3 channels)
- BT Mode (1 channel with 32 bytes of FIFO)
- Support dedicated NIC or shared lights out management (LOM)
- Support Serial-On-LAN (SOL)
- Customize FRU/Sensor Data Record data (firmware independent)
- Provide KVM over IP (remote access to the server)
- Enable the user interface (UI) for hot key definitions (for example Ctrl-Alt-Del)
- Provide full screen display switch
- Set dynamic video scaling (4x4 Video Scalar)
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
|
|
|
|
|
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
|
Embedded Lights Out Manager Administration Guide For the Sun Fire X4150 and X4450 Servers
|
820-1855-13
|
|
Copyright © 2008, Sun Microsystems, Inc. All Rights Reserved.