Kontron AM4120 IPMI Firmware - Manual (Page 38)

Functional Description AM4120 IPMI Firmware
Page 32 ID 1045-9586, Rev. 1.0
9.2 OS Requirements for Graceful Shutdown
Requirements:
• At system start on the payload side, the Kontron shutdown daemon “grnsd” must be start-
ed. It is included in the Linux board support packages for the AM4120. This daemon com-
municates cyclically with the MMC for the exchange of states, commands and
acknowledges. For this, it uses the
OEM Module Quiescence Feedback
command.
Refer to Chapter 3.4.
Hot swap operation sequence processed by MMC and OS:
• On command of the carrier controller the MMC sets a “shut down request” flag.
• The “grnsd” daemon recognizes this request in the response to its cyclical
OEM Module
Quiescence Feedback
command and initiates the shutdown of the payload software
system.
• At the end of the shutdown process, the “grnsd” daemon informs the MMC by setting the
appropriate flag when calling the
OEM Module Quiescence Feedback
command.
• The MMC reports this to the carrier controller so that the hot swap processing can be con-
tinued and finished.
By default the MMC waits endlessly for this information. If an endless wait is to be avoided, it
is possible to set a timeout time after which the system will be switched off unconditionally. For
the setting of the timeout refer to Chapter 3.4, OEM Module Quiescence Feedback.
10. OS Support / Tools
10.1 Linux Tools
OpenIPMI - KCS driver
Normally all drivers and kernel modules needed for communication between the payload
software and the MMC firmware via the KCS interface come with the distribution. The
OpenIPMI library package includes some applications and the required libraries.
“ipmitool”
Another very useful all-in-one tool is the “ipmitool” (http://ipmitool.sourceforge.net). It provides
a user-friendly interface to many IPMI features and extensions, for example, to get sensor
readings, change sensor thresholds or access other Management Controllers via IPMB. Before
“ipmitool” can be used, the OpenIPMI driver mentioned above must be loaded too.
10.2 OS Support - Board Support Packages
To see which Operating Systems are supported refer to the board's data sheet. Please visit
http://www.kontron.com to get the data sheet. Please also have a look in the download section
for latest versions of Board Support Packages or Firmware Updates.
For further information concerning IPMI, refer to the BSP documentation for the respective OS.