HP iLO Chassis Management IPMI UserGuideAbstractThis document provides customers with information on the implementation of the Intelligent Platform Ma
Table 3 SEL event records (continued)DescriptionFieldByteEvent typeType of trigger for the event, such as, a critical threshold going high or state as
Table 61 Set watchdog timer command request and response data (continued)Reserved100b,111b=Reserved[3]Timeout action[2:0]No action000b =Hard reset001b
Timer use2Don't log1b =[7]Timer is started (running)1b =[6]Timer is stopped0b =Reserved[5:3]Timer use (logged on expiration when don't log b
Table 62 Get watchdog timer command response data (continued)BIOS/POST[2]BIOS FRB2[1]Reserved[0]Initial countdown value, LS byte (100 ms/count)6Initia
Table 63 Get chassis capabilities command response data (continued)Chassis FRU info device address. All IPMB addresses used in this command have the 7
Table 64 Get chassis status command response data (continued)Last power down caused by power fault1b =[3]Last power down caused by a power interlock b
Table 65 Chassis control command request and response data (continued)Power down. Force system into soft off (S4/S45) state. This is for emergencymana
Table 66 Chassis identify command request and response dataData fieldRequest databyte numberIdentify interval in seconds (optional). 1-based. Timing a
Table 67 Set power restore policy command request and response data (continued)Chassis supports always powering up after AC/mains returns1b =[2]Chassi
Table 69 Get system boot options request command and response dataData fieldRequest databyte numberParameter selector1Reserved[7]Boot option parameter
Table 70 Boot option parameters (continued)Parameter data (non-volatile unless otherwise noted)#Parameterparameter data. It is a notification flag onl
Table 4 Sensor data record formatsRecord bodyRecord Key fieldsRecord headerContains specific information to thesensor data recordThe record key bytes
Table 70 Boot option parameters (continued)Parameter data (non-volatile unless otherwise noted)#ParameterOS loader has handled boot information.0b =[1
Table 70 Boot option parameters (continued)Parameter data (non-volatile unless otherwise noted)#ParameterForce boot from default hard-drive20010b =Res
Table 71 Get POH counter command response dataData fieldResponse databyte numberCompletion code1Minutes per count2Counter reading. LS byte first.3:6Wh
Get event receiver commandThis command is used to retrieve the present setting for the event receiver slave address and LUN.This command is only appli
SEL commandsThe SEL is a non-volatile repository for system events and certain system configuration information.The device that fields these commands
Table 75 Get SEL info command request and response data (continued)Data fieldRequest databyte numberEntries MS byte — number of log entries in SEL, MS
Get SEL entry commandUse this command to retrieve entries from the SEL. The record data field in the response returns the16 bytes of data from the SEL
Table 80 Add SEL entry response dataData fieldRequest databyte numberCompletion code. Generic, plus following command specific:180h = operation not su
Get SEL time commandThis command returns the time from the SEL device. This time is used by the SEL device for eventtimestampting.Table 84 Get SEL tim
changed. Software can determine whether a given record has been given a different record ID byexamining just the SDR’s header and record key bytes.Get
inventory data mechanisms such as those provided by SM BIOS, and PCI vital product data. Rather,IPMI FRU information is typically used to complement t
Get SDR repository allocation info commandThis command is available to the MC.This command returns the number of possible allocation units, the amount
the record ID for the wrong record. However, events that change record IDs for any existing recordscause the present reservation ID to be canceled. Th
version of the SDR repository before it sends any other SDR repository commands. This is importantsince the SDR repository command format and operatio
This command adds the specified sensor record to the SDR repository and returns its record ID.The data passed in the request must contain the SDR data
Table 92 Clear SDR repository command request and response data (continued)R (52h)56• AAH = initiate erase• 00h = get erasure statusData fieldResponse
Get FRU inventory area info commandThis command returns the overall size of the FRU inventory area for a device in bytes.Table 94 Get FRU inventory ar
Table 95 Read FRU data command request and response data (continued)Count returned – count is 1 based2Requested data.3:2+NWrite FRU data commandThis c
Table 97 Get device SDR info command request and response data (continued)[7:1] — reserved[0] — 1b = Get SDR count, returns the total number of SDRs i
Table 98 Get device SDR command request and response data (continued)Offset into record.5Bytes to read. FFh means read entire record.6Data fieldRespon
Table 100 Get sensor thresholds command response data (continued)Data fieldResponse databyte numberupper non-critical threshold, if present, ignore on
The timestamps used for SDR and SEL records are specified in relative local time (that is, thedifference between the timestamp does not include the GM
Table 101 Get sensor reading command request data (continued)[3] = 1b = state 3 asserted[2] = 1b = state 2 asserted[1] = 1b = state 1 asserted[0] = 1b
Table 102 DCMI completion codes (continued)DefinitionCodeCannot execute duplicated request. This completion code is for devices which cannot return th
Table 104 DCMI Capabilities ParametersParameter data (non-volatle unless noted)#ParameterThis field returns the supported capabilities available in th
Table 104 DCMI Capabilities Parameters (continued)Parameter data (non-volatle unless noted)#ParameterThis field returns the attributes required for th
Table 105 Get asset tag command request and response data (continued)shall return the requested data bytes, but shall also return a command-specific c
Table 107 Get DCMI sensor info command request and response data (continued)Number of record IDs in this response (maximum of 8 per response)01h for e
controller identifier string commands are provided to provision the controller withthe unique identification. The management controller must maintain
PICMG specific commandsGet PICMG properties commandTable 111 Get PICMG properties command request and response dataData fieldRequest data bytenumberPI
Table 112 Get address info command request and response data (continued)Completion code.1PICMG identifier. Indicates that this is a PICMG-defined grou
Table 114 FRU inventory device lock control command request and response data (continued)Operation. The operation to perform on the FRU lock.30 Get la
2 The virtual topology of the Moonshot 1500 CM moduleFigure 1 Moonshot virtual IPMI topologyThere are five virtual management controller (MC) entity t
6 IPMI Messaging and InterfacesIPMI uses message based interfaces for the different interfaces to the platform management subsystemsuch as IPMB, LAN,
Message interface descriptionThe heart of this specification is the definition of the messages and data formats used forimplementing sensors, event me
for a given network function are not node specific. The format and function for standard commandsets is specified later.Table 116 Moonshot network fun
completed successfully and normally, and if not, provides a value indicating the completioncondition.Completion codes work at the command level. They
Table 117 Completion Codes (continued)DefinitionCodeCannot execute command due to insufficient privilege level or other security based restriction(exa
Privilege Levels determine which IPMI commands a given user can execute over a given channel.Privilege Limits set the maximum privilege level at which
Table 119 Channel privilege levelsDescriptionChannel privilege levelLowest privilege level. Only commands necessary to support initiating a Callback a
An IPMI messaging connection to the MC fits one of three classifications, session-less, single-session,or multi-session.Session-less connectionsA sess
message in the queue. This helps prevent lockout by having the queue fill with just messages fromone interface.The MC itself can, if necessary, use th
Send Message command with response trackingThe Send Message command is used primarily to direct the MC to act as a proxy that translatesa message from
Table 5 Moonshot virtual management controller functions (continued)Applicable Virtual Management ControllerDescriptionFunctionNodeCartPowerSupplyChas
When a request message is bridged to another channel by encapsulating it in a Send Messagecommand (from a source channel other than the system interfa
1. When the MC receives the Send Message command with the Bridged Request parameterbit set, it checks for an available entry in a Pending Bridged Resp
Table 121 MC IPMB LUNsLong DescriptionShort DescriptionLUNEvent Request Messages received on this LUN are routed to the EventReceiver Function in the
The response is for the Send Message command and not for the Set Event Receivercommand. The response to the Set Event Receiver command is returned lat
Where:Returns the LUN that was passed in the Request Message.LUNA return of the NetFn code that was passed in the Request Message. Except that an odd
Table 122 RMCP Port Numbers (continued)DescriptionNamePort#Since discovery requires sending in the clear RMCP ping/pong packets, thesecondary port is
Table 124 Message Type Determination Under RMCP (continued)Message DataMessage TypeMessage ClassACK/Normal bitPer ASF specificationASF MessagesASFnorm
7 Support and other resourcesInformation to collect before contacting HPBe sure to have the following information available before you contact HP:• So
These documents are on the HP website at:http://www.hp.com/go/moonshot/docsWebsites• HP Moonshot website:http://www.hp.com/go/moonshot• HP Moonshot Co
A Command AssignmentsThe following lists the commands defined in this specification and the minimum privilege levelrequired to execute a given command
Table 5 Moonshot virtual management controller functions (continued)Applicable Virtual Management ControllerDescriptionFunctionNodeCartPowerSupplyChas
Table 125 Moonshot command number assignments and privilege levelsAOUCCMDNetFnIPM Device “Global” CommandsX01hAppGet Device IDIIII01hAppBroadcast ‘Get
Table 125 Moonshot command number assignments andprivilege levels (continued)AOUCCMDNetFnX4AhAppGet Payload Activation StatusX4BhAppGet Payload Instan
Table 125 Moonshot command number assignments andprivilege levels (continued)AOUCCMDNetFnX12hStorageWrite FRU DataSDR Device CommandsX20hStorageGet SD
Table 125 Moonshot command number assignments andprivilege levels (continued)AOUCCMDNetFnX00hPICMG(00h)Get PICMG PropertiesX01hPICMG(00h)Get Address I
B Verbose output examplesroot@JSMITH-LX:/# ipmitool -I lanplus -H ILOH101GEMINI -U Administrator -P password sdr list all –vRunning Get PICMG Properti
Device CapabilitiesChassis Device : NoBridge : NoIPMB Event Generator : YesIPMB Event Receiver : NoFRU Inventory Device : Ye
Logs Init Agent Errors : NoEvent Message Gen : EnableDevice CapabilitiesChassis Device : NoBridge : NoIPMB Event Generator
ACPI Device P/S Notif : Not RequiredController Presence : DynamicLogs Init Agent Errors : NoEvent Message Gen : EnableDevice CapabilitiesChas
Channel Number : 0hACPI System P/S Notif : Not RequiredACPI Device P/S Notif : Not RequiredController Presence : DynamicLogs Init Agent E
Entity ID : 160.97 (PICMG Front Board)Device Slave Address : 88hChannel Number : 0hACPI System P/S Notif : Not RequiredACPI De
3 Discovering managed entities using IPMIToolEnter the IPMItool sdr list all command to show all management controller records, whetheryou are queryin
Device ID : CaMCEntity ID : 160.97 (PICMG Front Board)Device Slave Address : 8ChChannel Number : 0hACPI System P/S
SDR Repository : YesSensor Device : YesDevice ID : CaMCEntity ID : 160.97 (PICMG Front Board)Device Slave Add
FRU Inventory Device : YesSEL Device : NoSDR Repository : YesSensor Device : YesDevice ID : CaMCEntity ID
IPMB Event Generator : YesIPMB Event Receiver : NoFRU Inventory Device : YesSEL Device : NoSDR Repository : YesSensor Device
Chassis Device : NoBridge : NoIPMB Event Generator : YesIPMB Event Receiver : NoFRU Inventory Device : YesSEL Device
Positive Hysteresis : UnspecifiedNegative Hysteresis : UnspecifiedMinimum sensor range : -127.000Maximum sensor range : UnspecifiedEvent Message
Device CapabilitiesChassis Device : NoBridge : NoIPMB Event Generator : YesIPMB Event Receiver : NoFRU Inventory Device : Ye
SEL Record ID : 0005Record Type : 02Timestamp : 03/27/2000 01:23:36Generator ID : 0044EvM Revision :
Event Data : 01ffffDescription : Failure detectedSEL Record ID : 000cRecord Type : 02Timestamp : 0
Sensor Number : 04Event Type : Sensor-specific DiscreteEvent Direction : Assertion EventEvent Data : 01ffffDescrip
4 IPMItoolIPMI tool is a simple command-line interface to systems that support the IPMI v1.5 specification. Itprovides the ability to read the sensor
Generator ID : 0044EvM Revision : 04Sensor Type : Power SupplySensor Number : 02Event Type : Sensor-spe
SEL Record ID : 0020Record Type : 02Timestamp : 08/09/2013 14:34:49Generator ID : 0044EvM Revision :
Event Data : 00ffffDescription : Transition to RunningSEL Record ID : 0027Record Type : 02Timestamp
Sensor Number : 0aEvent Type : Generic DiscreteEvent Direction : Assertion EventEvent Data : 00ffffDescription
Generator ID : 0044EvM Revision : 04Sensor Type : FanSensor Number : 0aEvent Type : Generic DiscreteEve
SEL Record ID : 003bRecord Type : 02Timestamp : 08/09/2013 15:00:54Generator ID : 0044EvM Revision :
GlossaryACPI Advanced Configuration and Power Interface SpecificationBCD Binary-coded DecimalBMC Baseboard Management ControllerBT Block TransferChMC
rsSA Random Single Switch AlgorithmRTS Request to sendSCI Software Configuration IdentificationSDR Sensor Data RecordSEL System Event LogSMB System Ma
IndexAACK messages, 155active sessions, 57authcode, 59authentication, 144authorized resellers, 157BBMC, 141interfaces, 141BT, 19Cchannel access, 66cha
Pparsing hierarchy, 141payload commands, 70POH counter, 12print field replaceable unit, 18privilege level, 65RRCMP+, 70remote systems, 22response mess
where:• –B <transit channel for bridged request (dual bridge)>• –T <transit address for bridge request (dual bridge)>• -b <ipmi channel
© Copyright 2014NoticesConfidential computer software. Valid license from HP required for possession, use, or copying. Consistent with FAR 12.211 and
Example 1 Raw Get Device ID to chassis satellite controller over LAN# ipmitool -I lanplus -H 16.85.178.125 -U admin -P admin123 -L Administrator -b 0
Example 4 Output from sdr list all commandZoMC | Static MC @ 20h | ok254 | Log FRU @FEh f0.60 | okIPMB0 Phys Link | 0x00
InventoryIPMI supports multiple sets of non-volatile FRU information for different parts in the system. Thisprovides access to data such as serial num
<command>ipmitool [-chvV] -Ilanplus -H<hostname>[-p<port>][-U<username>][-L<privlvl>][-aEPf<password>][-o<oemt
Increase verbose output level. May be specified multiple times to increaselevels of debug output, for example, specifying three times results inhexdum
5 Command specificationIPMI provides standardized interfaces and commands for configuring the platform managemenetsubsystem. This enables cross-platfo
DescriptionNotationMulti-byte fields that are shown as optional cannot be split. Either all bytes for the field are presentor absent. For example, if
Table 6 Moonshot IPMI commands and their iLO CM CLI equivalents (continued)Moonshot iLO CM CLI command equivalentCommandCodeNetFnMoonshot IPMI Command
Table 6 Moonshot IPMI commands and their iLO CM CLI equivalents (continued)Moonshot iLO CM CLI command equivalentCommandCodeNetFnMoonshot IPMI Command
Table 6 Moonshot IPMI commands and their iLO CM CLI equivalents (continued)Moonshot iLO CM CLI command equivalentCommandCodeNetFnMoonshot IPMI Command
Contents1 Introduction and key concepts...7Overview...
While broad dependence on OEM-specific functionality is discouraged, two fields in the responseallow software to identify controllers for the purpose
Table 7 Device ID command response data (continued)Data fieldResponse databyte numbervendor-specific definition is not known, generic utilities should
Table 8 Additional device ID specifications (continued)DescriptionDevice ID SpecificationIndicates the logical device support that the device provides
NOTE: The cold reset command is provided for platform development, test, andplatform-specific initialization and recovery actions. The system actions
Table 11 Get self test results command response dataData fieldResponse data bytenumberCompletion code.12• 55h — No error. All self tests passed.• 56h
Table 12 Get ACPI power state command response data (continued)Data fieldResponse databyte numberTypically equates to suspend-to-RAMS303hTypically equ
See “Get device ID command” (page 29) for information on the fields returned by the broadcastget device ID command response. The IPMB message format f
Table 13 Set BMC global enables command request and response data (continued)Enable event message buffer. Error completion code returned if writtenas
Table 15 Clear message flags command request and response dataData fieldRequest databyte numberClear OEM 21b =[7]1Clear OEM 11b =[6]Clear OEM 01b =[5]
messages from channels that it intends to process, and provides a disable mechanism in case thereceive message queue is being erroneously or malicious
Get channel authentication capabilities command...50Get Channel Cipher Suites Command...
based the on the present operating privilege level for the user (set using the set sessionprivilege level command). If, before sending the packet, the
The following table indicates the contents of the Message Data field from the get message responseaccording to the channel type and channel protocol t
calculation for the receive message queue data whenever IPMB is listed as the originating bus and with IPMB as thechannel protocol.Send message comman
Table 20 Send message command request and response data (continued)Channel number where to send the message[3:0]Message data. Format dependent on targ
Table 21 Send message data fields (continued)Message data for sending requests (RQ) andresponses (RS)Target channel protocolTarget channel typeNOTE: T
system implementations. However, versions 3, 4, or 5 formats are also allowed. A system GUIDshould not change over the lifetime of the system.If the M
Get system info parameters commandThis command is available to the MC.This command is used for retrieving system information parameters from the set s
Table 25 System info parameters (continued)Parameter data (non-volatile unless otherwise noted)1#ParameterSet in progress indicating that some utility
Table 25 System info parameters (continued)Parameter data (non-volatile unless otherwise noted)1#Parameteras follows. There is no required value to be
Table 25 System info parameters (continued)Parameter data (non-volatile unless otherwise noted)1#ParameterSet selector = 16-byte data block number to
Set event receiver command...112Get event receiver command...
Table 26 Master write-read command request and response data (continued)Read count. Number of bytes to read, 1 based. 0 equals not bytes to read. The
Table 27 Get channel authentication capabilities command request and response data (continued)Get IPMI v2.0+ extended data. If the given channel suppo
Table 27 Get channel authentication capabilities command request and response data (continued)None[0]Reserved[7:6]4KG status (two-key login status). A
The data is accessed 16-bytes at a time starting from List Index field value of 0 in the request andthen repeating the request incrementing the List I
Table 28 Get channel cipher suites command request and response data (continued)Format. Record data is ‘packed’; there are no pad bytes between record
Table 29 Cipher suite record format (continued)Tag bits[5:0]Tag bits[7:6]Size[5:0] = Integrity Algorithm Number(s).01bvar[5:0] = Confidentiality Algor
Table 30 Cipher suite ID numbers (continued)ConfidentialityAlgorithm(s)Integrity Algorithm(s)AuthenticationAlgorithmCipher SuiteCharacteristicsIDA = A
Close session commandThis command is used to immediately terminate a session in progress. It is typically used to closethe session that the user is co
Table 33 Get session info command request and response data (continued)Data fieldIPMI responsedata bytenumberCompletion code1Session handle presently
Table 33 Get session info command request and response data (continued)If PPP connection, the IP address of the remote console. (MS-byte first). 00h,
Channel numbers...145Logical channels...
Table 34 Get AuthCode command request and response dataData fieldIPMI requestdata bytenumber[7:6] - Authentication type / Integrity algorithm number1•
The active (volatile) settings can be overwritten to allow run-time software to make temporarychanges to the access. The volatile settings are overwri
Table 35 Set channel access command request and response data (continued)Always available. Channel always available for communication regardlessof sys
Table 36 Get channel access command request and response data (continued)Completion code. Generic, plus the command-specific completion code:1Command
Table 37 Get channel info command request and response data (continued)Data fieldIPMI responsedata bytenumberCompletion code1Reserved[7:4]2Actual chan
Table 37 Get channel info command request and response data (continued)For OEM channel types: Byte 1:2 = OEM specified per OEM identified by vendor ID
Table 38 Set user access command request and response data (continued)User ID2• [7:6] — Reserved• [5:0] — User ID. 000000b = Reserved.User limits3Rese
Table 39 Get user access command request and response data (continued)NOTE: An implementation does not return an error completion code if the user acc
Table 39 Get user access command request and response data (continued)Administrator4h =OEM proprietary5h =No access. This value does not add to, or su
Table 41 Get user name command request and response data (continued)Data fieldResponse databyte numberCompletion code.1User name string in ASCII, 16 b
1 Introduction and key conceptsOverviewThe term Intelligent Platform Management (IPMI), refers to autonomous monitoring and recoveryfeatures implement
Table 42 Set user password command request and response data (continued)Disable user00b =Enable user01b =Set password10b =Test password. Compares the
NOTE: The following commands remain available for payloads if IPMI messaging payload typeis disabled:• Deactivate payload• Suspend/resume payload encr
Table 44 Activate payload command request and response dataData fieldRequest databyte number1• [7:6] — Reserved• [5:0] — Payload type. IPMI message pa
Table 44 Activate payload command request and response data (continued)the remote console to first alter volatile configuration settings before hardwa
Table 45 Deactivate payload command request and response dataData fieldRequest databyte number1• [7:6] — Reserved• [5:0] — Payload type.Payload instan
Table 46 Payload-specific encryption behavior (continued)Payload Type = SOL• The SOL configuration parameters allow configuring the system to require
If this command is not supported, it indicates that the keys are either permanently pre-configured,or that they are only configurable via an OEM/MC-sp
7:2 - reserved.21:0 - lock status• 00b = key is not lockable.• 01b = key is locked.• 10b = key is unlocked.• 11b = reservedKey value.(3:N)The MC retur
[2:0] - SSIF Version• 000b = version 1 (version defined in this specification).Input message size in bytes. (1 based.)4Number of bytes of IPMI message
Table 48 Get payload activation status command request and response data (continued)Instance 1 is deactivated.0b =Instance 16 is activated.1b =[7]4Ins
Table 1 Sensor owner ID and sensor number field definition (continued)System Sensor Owner IDIPMB Sensor Owner ID0 1b (ID is a software ID)0 0b (ID is
payloads selected to set the configuration for standard payloads, and then at least once with OEMpayloads selected to set the configuration for OEM pa
Table 51 Get user payload access command request and response dataData fieldRequest data bytenumberChannel number1• [7:4] — Reserved• [3:0] — Channel
Table 52 Get channel payload support command request and response data (continued)Completion code12• [7] = Standard payload type #7 supported• ...• [0
Table 53 Get channel payload version command request and response data (continued)Data fieldResponse databyte numberCompletion code. Generic plus comm
Table 55 Get LAN configuration parameters request and response dataData fieldRequest data bytenumber[7]1• 0b = Get parameter• 1b = Get parameter revis
Table 56 LAN configuration parameters (continued)Parameter Data (non-volatile unless otherwise noted)1#Parameterprogress’ and then go to the ‘set in p
Table 56 LAN configuration parameters (continued)Parameter Data (non-volatile unless otherwise noted)1#Parameter◦ [1] - MD2◦ [0] - none• byte 2: Authe
Table 56 LAN configuration parameters (continued)Parameter Data (non-volatile unless otherwise noted)1#Parameterdata 1 - MC-generated ARP control. Not
Table 56 LAN configuration parameters (continued)Parameter Data (non-volatile unless otherwise noted)1#ParameterSets the type of LAN Alert associated
Table 56 LAN configuration parameters (continued)Parameter Data (non-volatile unless otherwise noted)1#ParameterSets/Gets the list of IP addresses tha
Event messages are special messages sent by management controllers when they detect significantor critical system management events. This includes mes
Table 56 LAN configuration parameters (continued)Parameter Data (non-volatile unless otherwise noted)1#ParameterCipher Suite IDs assigned for standard
Table 56 LAN configuration parameters (continued)Parameter Data (non-volatile unless otherwise noted)1#Parameterit must support configuring unique TAG
Table 56 LAN configuration parameters (continued)Parameter Data (non-volatile unless otherwise noted)1#ParameterThe Set User Access command is used to
Table 57 Set SOL configuration parameters command request and response dataData fieldRequest data bytenumber1• [7:4] — Reserved• [3:0] — Channel numbe
Table 59 SOL configuration parametersParameter Data (non-volatile unless otherwise noted)1#ParameterData 1 - This parameter is used to indicate when a
Table 59 SOL configuration parameters (continued)Parameter Data (non-volatile unless otherwise noted)1#ParameterForce authentication. If the cipher su
Table 59 SOL configuration parameters (continued)Parameter Data (non-volatile unless otherwise noted)1#ParameterNOTE: If SOL is enabled for multiple L
• System power cycle• Pre-timeout interrupt (optional)The system reset on timeout, system power off on timeout, and system power cycle on timeoutactio
Pre-timeout interruptThe watchdog timer offers a pre-timeout interrupt option. This option is enabled whenever theinterrupt on timeout option is selec
If the timer is already running, the set watchdog timer command stops the timer (unless thedon’t stop bit is set) and clears the watchdog pre-timeout
Comentarios a estos manuales