Kontron IPMI Firmware User Manual
» User Guide «
IPMI Controller
LPC
IPMB, HW Monitor,
Power Supply,
Temp. Sensors, PCIe
Chipset, Switches,
LEDs etc.
Chipset,
UART
Ethernet
Controller
SideBand
UART
FPGA
Serial Port
IOL/SOL
Serial Port
Connector
I²C
IPMI & OEM Signals
IPMI Firmware
Doc. ID: 1055-7522, Rev. 1.0
Date: December 20, 2013
D R A F T — F O R I N T E R N A L U S E O N L Y
The pulse of innovation
User Guide
IPMI Firmware
Revision History
Revision Brief Description of Changes Date of Issue
1.0 Initial issue 20-Dec-2013
Imprint
Kontron Europe GmbH may be contacted via the following:
MAILING ADDRESS TELEPHONE AND E-MAIL
Kontron Europe GmbH +49 (0) 800-SALESKONTRON
Sudetenstraße 7 sales@kontron.com
D - 87600 Kaufbeuren Germany
For further information concerning other Kontron products, please visit our Internet website:
www.kontron.com.
Disclaimer
Copyright © 2013 Kontron AG. All rights reserved. All data is for information purposes only and not
guaranteed for legal purposes. Information has been carefully checked and is believed to be accurate;
however, no responsibility is assumed for inaccuracies. Kontron and the Kontron logo and all other
trademarks or registered trademarks are the property of their respective owners and are recognized.
Specifications are subject to change without notice.
www.kontron.com
D R A F T — F O R I N T E R N A L U S E O N L Y
2
User Guide
IPMI Fimware
Contents
Revision History ..........................................................................................................2
Imprint .....................................................................................................................2
Disclaimer ..................................................................................................................2
Contents ....................................................................................................................3
1 IPMI Overview ..................................................................................... 5
2 IPMI Controller Configuration................................................................. 5
2.1 IPMI in a CompactPCI Chassis.......................................................................... 5
2.1.1 IPMI Firmware Setup..................................................................................... 6
2.1.2 IPMI Setup for the Rack ................................................................................. 6
2.2 IPMI in a an MicroTCA/ATCA Environment .......................................................... 7
2.2.1 IPMI in AdvancedMC / AdvancedTCA Environment ................................................ 8
2.2.2 IPMI in a MicroTCA Environment ...................................................................... 8
3 IPMI Firmware Code .............................................................................. 8
3.1 IPMI Firmware Code...................................................................................... 8
3.1.1 Structure and Functionality............................................................................ 8
3.1.2 uEFI BIOS—IPMI Controller Interaction ............................................................. 8
3.1.3 Firmware Upgrade ........................................................................................ 9
3.1.3.1 Firmware File Formats ....................................................................................9
3.1.3.2 Firmware Upgrade via “ipmitool hpm” ...............................................................9
3.1.4 Firmware Upgrade via “uEFI kIpmi hpm”........................................................... 10
3.1.5 Firmware Upgrade via “uEFI kUpdate”.............................................................. 11
3.1.6 Setting the SEL Time (CompactPCI) ................................................................. 11
4 FRU Data ........................................................................................... 11
4.1 Structure and Functionality........................................................................... 11
4.2 FRU Version Identification ............................................................................ 11
4.3 Board-Specific FRU Data............................................................................... 12
4.4 FRU Data Update ........................................................................................ 12
4.5 E-Keying (AMC) .......................................................................................... 12
5 XMC Card Support in a CompactPCI Environment ........................................ 13
6 Hot Swap and Shutdown ....................................................................... 13
6.1 Hot Swap and Shutdown of a CompactPCI Board ................................................. 13
6.1.1 Hot Swap Handle and Hot Swap LED ................................................................ 13
6.1.2 The Hot Swap and Shutdown Processes ............................................................ 14
6.2 Hot Swap and Shutdown of an AMC Module ....................................................... 15
6.2.1 Method 1: The Payload OS Supports ACPI .......................................................... 16
6.2.2 Method 2: The Payload OS Does Not Support ACPI ............................................... 16
www.kontron.com
D R A F T — F O R I N T E R N A L U S E O N L Y
3
User Guide
IPMI Fimware
7 LAN Functions .................................................................................... 17
7.1 Overview................................................................................................... 17
7.2 Setting Up the Ethernet Channel .................................................................... 17
7.3 Basic Setup from uEFI Shell........................................................................... 17
7.4 Setup by “ipmitool” or IPMI Commands ............................................................ 18
7.5 Setup of User Accounts and Password .............................................................. 18
7.6 IPMI Over LAN ............................................................................................ 18
7.7 Serial Over LAN .......................................................................................... 19
8 OS Support / Tools ............................................................................... 20
8.1 ipmitool ................................................................................................... 20
9 Terminology and Acronym Definitions ..................................................... 20
10 Related Publications ........................................................................... 21
www.kontron.com
D R A F T — F O R I N T E R N A L U S E O N L Y
4
User Guide
IPMI Fimware
1 IPMI Overview
The Kontron IPMI implementation fully supports the Intelligent Platform Management Interface specification. The IPMI functionality operates under an autonomous management controller even if the
board is held in reset or power-down mode by a management card within a system designed for high
availability.
While the IPMI implementation is fully compliant with IPMI v2.0 and has been designed to operate with
any system management software (SMS) that respects this specification, can be easily integrated with
the Service Availability Forum — Hardware Platform Interface (SAF HPI) specification.
More information about Service Availability can be found on the following website:
http://www.saforum.org/
For further information concerning IPMI refer to the following website:
http://www.intel.com/design/servers/ipmi/
For board-specific IPMI information, refer to the IPMI chapter of the user guide provided with the CompactPCI board or the AMC module.
2 IPMI Controller Configuration
2.1 IPMI in a CompactPCI Chassis
IPMI is an extensible and open standard that defines autonomous system monitoring. It is autonomous
because every management controller within a CompactPCI chassis monitors its own sensors and sends
critical events through a dedicated bus to the BMC that logs it into a non-volatile System Event Log
(SEL). The IPMI implementation includes a device SDR repository module that allows the user's system
management software to detect all system components and build a database of all management controller sensors.
Kontron's IPMI implementation in the CompactPCI environment is compliant with the PICMG 2.9 R1.0
specification. This specification defines the pinout of the J1 and J2 CompactPCI connectors as well as
the addressing scheme.
Each CompactPCI board is equipped with an IPMI controller acting either as a BMC or as an SMC. There
should be only one BMC in the chassis, or at least on the IPMB segment. The BMC may reside either on
a board, or on an external system management card, or in a shelf management controller (ShMC). The
specification allows all of these variants. As a BMC in the system slot, the board supports dual-ported
IPMB (IPMB-0 to the SMCs and IPMB-1 to the external segments via the CompactPCI backplane connector). The BMC administrates the SEL and the SDRR for the complete system. In a CompactPCI chassis,
there can be several SMCs. The SMC administrates the sensor and FRU data of the board and makes it
available to the BMC. Each SMC can be connected to the BMC via a dedicated bus (IPMB-0).
D R A F T — F O R I N T E R N A L U S E O N L Y
www.kontron.com
5
User Guide
The IPMB address of the SMCs is determined by the geographic address of the slot.
IPMB-1
IPMB-0 IPMB-0
BMC
IPMB Address:
20h Fixed
SMC
IPMB Address:
B0h
SMC
IPMB Address:
B2h
SMC
IPMB Address:
B4h
SMC
IPMB Address:
B6h
SMC
IPMB Address:
B8h
SMC
IPMB Address:
BAh
SMC
IPMB Address:
BCh
Backplane
IPMI Fimware
Table 1: BMC Mode vs. SMC mode
BMC MODE SMC MODE
Fixed IPMB address: 20h IPMB address is calculated based on the Geographical Adress
(GA), e.g. slot number: B0h (slot1), B2h (slot 2), ... BEh (slot 8)
System Event Log (SEL) storing all events sent to
BMC via IPMB
Sensor Data Record Repository (SDRR) may contain
all Sensor Data Records (SDR) of all IPMI control-
lers in the chassis
Events are sent to BMC (20h) via IPMB by default and are also
stored in the local System Event Log (SEL)
No SDRR
To use the IPMI resources in a CompactPCI system requires an initial setup for IPMI operation. The following actions must first be performed to achieve operable IPMI functionality.
2.1.1 IPMI Firmware Setup
To select the BMC or the SMC mode, the kIpmi uEFI Shell command is used. Upon every board reset, the
uEFI BIOS forwards the user settings (BMC or SMC mode) to the IPMI controller. The IPMI controller’s
factory default setting is SMC mode.
2.1.2 IPMI Setup for the Rack
For a working IPMI configuration, the SDRR of the BMC must be filled with all sensor data records of all
IPMI controllers in the rack. After every system start the BMC uses the SDRR to initialize all sensors of
all boards in the rack. The SDRR setup must be done by a management tool, e.g. the open-source tool
“ipmitool”, after system modification. Then the command is:
www.kontron.com
D R A F T — F O R I N T E R N A L U S E O N L Y
6
User Guide
The IPMB-L address of the AMC modules is determined by the geographic address of the slot.
AMC
IPMB-L
Addr.:
72h
AMC
IPMB-L
Addr.:
7Ah
AMC
IPMB-L
Addr.:
7Ch
AMC
IPMB-L
Addr.:
7Eh
AMC
IPMB-L
Addr.:
80h
AMC
IPMB-L
Addr.:
88h
AMC
IPMB-L
Addr.:
86h
Carrier
IPMC
(ATCA/
AMC.0)
Carrier
Manager
(MicroTCA,
active MCH)
AMC
IPMB-L
Addr.:
74 h
AMC
IPMB-L
Addr.:
76h
AMC
IPMB-L
Addr.:
78h
AMC
IPMB-L
Addr.:
82h
AMC
IPMB-L
Addr.:
84h
IPMB-L
Addr.:
20h
IPMB-L
IPMB-L
Backplane
IPMI Fimware
ipmitool sdr fill sensors
This will only work if the IPMI controller configured as BMC is addressed. This addressing is the default
if the “ipmitool” is running on the payload side of the board where the BMC is residing.
2.2 IPMI in a an MicroTCA/ATCA Environment
The Module Management Controller (IPMI controller of an AMC module) is a crucial component of any
AMC module. Besides acting as a regular IPMI management controller (sensor monitoring, event logging, etc.), it also provides an interface to all necessary data related to module power requirements
and implemented interfaces (E-Keying). Further, it plays an active role in the module hot swap state
management.
The MMC provides access to various sensors which permit the monitoring of:
» System power voltages: +12V (PWR), +3.3V (MP)
» AMC module voltages: 5V, +3.3V
» Temperatures: CPU and PCH die as well as airflow near AMC edge-connector
» Power Good, LAN links, IPMB link, board reset, POST code, boot error, CPU States (processor
hot, THERMTRIP, …), IPMB-L state, Health error, IPMI watchdog, etc.
www.kontron.com
D R A F T — F O R I N T E R N A L U S E O N L Y
7
Loading...