Scroll to navigation

FREEIPMI_INTERPRET_SEL(5) Configuration FREEIPMI_INTERPRET_SEL(5)

NAME

freeipmi_interpret_sel.conf - specify system event log (SEL) interpretation rules

DESCRIPTION

The/etc/freeipmi//freeipmi_interpret_sel.confdefines how IPMI system event log entries should beinterpreted. IPMI system events specify a number ofstates/thresholds when they are read. Based on thosestates/thresholds, libraries and tools such aslibipmimonitoring(3)andipmi-sel(8)can report if an event is "good" or "bad" via a report of a NOMINAL,WARNING, or CRITICAL state. A different state can be reported for anevent depending on if it is asserted or deasserted.

Each of the states listed below are (hopefully) descriptive enoughto describe the state conditions that may be set/unset for eachsensor or event type. For more detailed information on each of theindividual states listed below, please see the IPMI Specification"Sensor and Event Code Tables".Ipmi-sensors(8)can be used to determine the sensor types and the states/thresholdsthat exist on a system by outputting very verbose output and seeingwhat types of Assertion or Deassertion events are possible.

Each of the events below may may take 1 or 2 of the following statesas input.

Nominal - Signal Nominal reading if event tripped

Warning - Signal Warning reading if event tripped

Critical - Signal Critical reading if event tripped

If only one state is listed, that state will be interpreted when theevent is asserted or deasserted. If two states are listed, the firststate will be interpreted when an event is asserted, and the laterwill be interpreted when an event is deasserted.

Not all IPMI sensor types and event types are currently supported. Ifyou would like more to be supported, please e-mail the FreeIPMImailing list.

The default values selected for individual events beingtripped are based on best guesses and motherboards being analyzed.If you think they should be changed, please e-mail the FreeIPMImailing list to discuss what the defaults should be.

Most default interpretations can be determined quite easily and canmeet the needs of most users. For example, a reading of"Performance_Met" is normally better than "Performance_Lags".However, some sensors can be ambiguous and depend completely on themanufacturer. For example, "State_Asserted" vs. "State_Deasserted"are completely at the interpretation of the vendor. Users are advisedto adjust the interpretations below as needed for their machines.

FORMAT

The configuration options that can be specified in the configurationfile are listed below. Each configuration option must be listed on aseparate line. Arguments for an option are separated by any amount ofwhitespace. Multiple arguments are also separated by whitespace.Comments can be marked by using the pound sign ("#") character, andlines can be continued on the next using backslash ("\").

OPTIONS

The following states correspond to threshold sensor events. Thisnormally applies to events that dealing with non-discrete values, suchas temperatures, voltages, RPM, etc.
The following states correspond to Temperature sensor events that report anassertion or deassertion.
Defaults to Nominal.
Defaults to Warning.
The following states correspond to Temperature sensor events thatreport on limits.
Defaults to Nominal.
Defaults to Critical.
The following states correspond to Temperature sensor events thatreport on transition severity.
The following states correspond to Voltage sensor events that report anassertion or deassertion.
Defaults to Nominal.
Defaults to Warning.
The following states correspond to Voltage sensor events thatreport on limits.
Defaults to Nominal.
Defaults to Critical.
The following states correspond to Voltage sensor events that report onperformance.
Defaults to Nominal/Nominal.
Defaults to Critical/Warning.
The following states correspond to Voltage sensor events thatreport on device severity.
The following states correspond to Current sensor events thatreport on device severity.
The following states correspond to Fan sensor events that report anassertion or deassertion.
Defaults to Nominal.
Defaults to Warning.
The following states correspond to Fan sensor events thatreport on device severity.
The following states correspond to Fan sensor events that report ondevice installation.
The following states correspond to Fan sensor events that report ondevice availability.
Defaults to Nominal/Nominal.
Defaults to Warning/Warning.
Defaults to Warning/Warning.
Defaults to Warning/Warning.
Defaults to Warning/Warning.
Defaults to Warning/Warning.
Defaults to Critical/Warning.
Defaults to Warning/Warning.
Defaults to Critical/Critical.
The following states correspond to Fan sensor events that report onredundancy.
The following states correspond to Physical Security sensor events w/Physical Security specific output events.
The following states correspond to Platform Violation Attempt sensor events w/Platform Security Violation Attempt specific output events.
The following states correspond to Processor sensor events w/Processor specific output events.
The following states correspond to Processor sensor events that report anassertion or deassertion.
Defaults to Nominal.
Defaults to Critical.
The following states correspond to Power Supply sensor events w/Power Supply specific output events.
Defaults to Nominal/Nominal.
Defaults to Critical/Critical.
Defaults to Critical/Critical.
Defaults to Critical/Warning.
Defaults to Critical/Warning.
Defaults to Critical/Warning.
Defaults to Critical/Critical.
Defaults to Warning/Warning.
The following states correspond to Power_Supply sensor events that report anassertion or deassertion.
Defaults to Critical.
Defaults to Nominal.
The following states correspond to Power Supply sensor events thatreport on device severity.
The following states correspond to Power Supply sensor events that report onredundancy.
The following states correspond to Power Unit sensor events w/Power Unit specific output events.
Defaults to Nominal/Nominal.
Defaults to Nominal/Nominal.
Defaults to Warning/Nominal.
Defaults to Warning/Warning.
Defaults to Critical/Warning.
Defaults to Critical/Critical.
Defaults to Critical/Critical.
Defaults to Critical/Critical.
The following states correspond to Power Unit sensor events that report ondevice installation.
The following states correspond to Power Unit sensor events that report onredundancy.
The following states correspond to Cooling Device sensor events that report onredundancy.
The following states correspond to Memory sensor events w/Memory specific output events.
Defaults to Warning.
Defaults to Critical.
Defaults to Critical.
Defaults to Critical.
Defaults to Critical.
Defaults to Warning.
Defaults to Nominal.
Defaults to Critical.
Defaults to Nominal.
Defaults to Warning.
Defaults to Critical.
The following states correspond to Memory sensor events that report anassertion or deassertion.
Defaults to Nominal.
Defaults to Critical.
The following states correspond to Memory sensor events thatreport on transition severity.
The following states correspond to Memory sensor events that report onredundancy.
The following states correspond to Drive Slot sensor events w/Drive Slot specific output events.
Defaults to Nominal.
Defaults to Critical.
IPMI_Drive_Slot_Predictive_Failure
Defaults to Critical.
Defaults to Nominal.
Defaults to Nominal.
Defaults to Critical.
Defaults to Critical.
Defaults to Nominal.
Defaults to Critical.
The following states correspond to Drive Slot sensor events that report anassertion or deassertion.
Defaults to Warning.
Defaults to Nominal.
The following states correspond to Drive_Slot sensor events that report apredictive failure assertion or deassertion.
The following states correspond to Drive Slot sensor events that report ondevice installation.
The following states correspond to POST Memory Resize sensor eventsthat report an assertion or deassertion.
The following states correspond to System Firmware Progress sensor events w/System Firmware Progress specific output events.
The following states correspond to System Firmware Progress sensorevents that report on device severity.
The following states correspond to Event Logging Disabled sensor events w/
The following states correspond to System Event sensor events w/System Event specific output events.
The following states correspond to System Event sensor events that report atransition state.
The following states correspond to System Event sensor events that report anassertion or deassertion.
Defaults to Nominal.
Defaults to Warning.
The following states correspond to Critical Interrupt sensor events w/Critical Interrupt specific output events.
Defaults to Critical.
Defaults to Critical.
Defaults to Critical.
Defaults to Warning.
Defaults to Critical.
Defaults to Critical.
Defaults to Critical.
Defaults to Warning.
Defaults to Critical.
Defaults to Critical.
Defaults to Critical.IPMI_Critical_Interrupt_Bus_Degraded Defaults to Warning.
The following states correspond to Button/Switch sensor events w/Button/Switch specific output events.
The following states correspond to Button/Switch sensor events that report anassertion or deassertion.
The following states correspond to Button Switch sensor events thatreport on device severity.
The following states correspond to Module/Board sensor events that report anassertion or deassertion.
Defaults to Nominal.
Defaults to Critical.
The following states correspond to Module/Board sensor events that report ondevice installation.
The following states correspond to Chassis sensor events thatreport on device severity.
The following states correspond to Chip Set sensor events w/ ChipSet specific output events.
Defaults to Critical.
Defaults to Critical.
The following states correspond to Chip Set sensor events thatreport on device severity.
The following states correspond to Cable/Interconnect sensor events w/Cable/Interconnect specific output events.
The following states correspond to Cable/Interconnect sensor events thatreport on device severity.
The following states correspond to System Boot Initiated sensor events w/System Boot Initiated specific output events.
IPMI_System_Boot_Initiated_Initiated_By_Power_Up Defaults to Nominal. IPMI_System_Boot_Initiated_Initiated_By_Hard_Reset Defaults to Nominal. IPMI_System_Boot_Initiated_Initiated_By_Warm_Reset Defaults to Nominal. IPMI_System_Boot_Initiated_User_Requested_PXE_Boot Defaults to Nominal. IPMI_System_Boot_Initiated_Automatic_Boot_To_Diagnostic Defaults to Nominal. IPMI_System_Boot_Initiated_OS_Run_Time_Software_Initiated_Hard_Reset Defaults to Warning. IPMI_System_Boot_Initiated_OS_Run_Time_Software_Initiated_Warm_Reset Defaults to Warning. IPMI_System_Boot_Initiated_System_Restart Defaults to Nominal.
The following states correspond to Boot Error sensor events w/Boot Error specific output events.
The following states correspond to Boot Error sensor events thatreport an assertion or deassertion.
Defaults to Nominal.
Defaults to Critical.
The following states correspond to Boot Error sensor events thatreport on device severity.
The following states correspond to OS Boot sensor events w/OS Boot specific output events.
IPMI_OS_Boot_A_Boot_Completed Defaults to Nominal. IPMI_OS_Boot_C_Boot_Completed Defaults to Nominal. IPMI_OS_Boot_PXE_Boot_Completed Defaults to Nominal. IPMI_OS_Boot_Diagnostic_Boot_Completed Defaults to Nominal. IPMI_OS_Boot_CD_ROM_Boot_Completed Defaults to Nominal. IPMI_OS_Boot_ROM_Boot_Completed Defaults to Nominal. IPMI_OS_Boot_Boot_Completed_Boot_Device_Not_Specified Defaults to Warning. IPMI_OS_Boot_Base_OS_Hypervisor_Installation_Started Defaults to Nominal. IPMI_OS_Boot_Base_OS_Hypervisor_Installation_Completed Defaults to Nominal. IPMI_OS_Boot_Base_OS_Hypervisor_Installation_Aborted Defaults to Warning. IPMI_OS_Boot_Base_OS_Hypervisor_Installation_Failed Defaults to Critical.
The following states correspond to OS Critical Stop sensor events w/OS Critical Stop specific output events.
IPMI_OS_Critical_Stop_Critical_Stop_During_OS_Load Defaults to Critical. IPMI_OS_Critical_Stop_Run_Time_Critical_Stop Defaults to Critical. IPMI_OS_Critical_Stop_OS_Graceful_Stop Defaults to Warning. IPMI_OS_Critical_Stop_OS_Graceful_Shutdown Defaults to Warning. IPMI_OS_Critical_Stop_Soft_Shutdown_Initiated_By_PEF Defaults to Warning. IPMI_OS_Critical_Stop_Agent_Not_Responding Defaults to Critical.
The following states correspond to OS Critical Stop sensor events thatreport an assertion or deassertion.
The following states correspond to Slot Connector sensor events w/Slot Connector specific output events.
The following states correspond to Slot Connector sensor events thatreport on device severity.
The following states correspond to Watchdog 2 sensor events w/Watchdog 2 specific output events.
Defaults to Warning.
Defaults to Critical.
Defaults to Critical.
Defaults to Critical.
Defaults to Nominal.
Defaults to Nominal.
Defaults to Nominal.
Defaults to Nominal.
Defaults to Warning.
The following states correspond to Platform Alert sensor events w/Platform Alert specific output events.
IPMI_Platform_Alert_Platform_Generated_Page Defaults to Nominal. IPMI_Platform_Alert_Platform_Generated_LAN_Alert Defaults to Nominal. IPMI_Platform_Alert_Platform_Event_Trap_Generated Defaults to Nominal. IPMI_Platform_Alert_Platform_Generated_SNMP_Trap Defaults to Nominal.
The following states correspond to Platform Alert sensor events thatreport an assertion or deassertion.
The following states correspond to Entity Presence sensor events w/Entity Presence specific output events.
The following states correspond to Entity Presence sensor events that report ondevice installation.
The following states correspond to LAN sensor events w/ LAN specificoutput events.
IPMI_LAN_Heartbeat Defaults to Nominal. IPMI_LAN_Heartbeat_Lost Defaults to Warning.
The following states correspond to Management Subsystem Health sensor events w/Management Subsystem Health specific output events.
The following states correspond to Battery sensor events w/Battery specific output events.
Defaults to Warning.
Defaults to Critical.
Defaults to Nominal.
The following states correspond to Session Audit sensor events w/Session Audit specific output events.
The following states correspond to Version Change sensor events thatVersion Change specific output events.
The following states correspond to FRU State sensor events w/FRU State specific output events.
The following configuration options can be used to configure OEMsystem event log events. Interpretations rules for a specificcombination of Manufacturer-ID, Product-ID, and Record-Type, are iterated through and the worst resulting sensor state is returned (i.e. Warning < Nominal, Critical < Warning). If no match is found, no state is returned for the OEM event. For each of the configuration options below, <Manufacturer-ID> is the numeric IANA manufacturer ID for the manufacturer in question. The <Product-ID> is one or more numeric IDs representing the manufacturer's product. The <Product-ID> can be listed as a single numeric number (e.g. 1234), a range of IDs separated by a dash (e.g. 12-20), or a list of specific product IDs separated by a plus (e.g. 12+19+22). Both the Manufacturer-ID and Product-ID can be found using bmc-info(8).Multiple <Manufacturer-ID> and <Product-ID> pairs can be input separated by commas.
IPMI_OEM_System_Event_Record can be used to configure a state interpretation for a specific Manufacturer-ID, Product-ID, Event-Reading-Type-Code, and Sensor-Type combination, and a specific Event-Direction, EventData1, EventData2, and EventData3. The Event-Direction field must specify Assertion, Deassertion, or ANY. Each of the EventData fields must specify a hex byte to match or the keyword ANY to match anything. The Event-Reading-Type-Code and Sensor-Type need not be OEM types. They may be non-OEM types and used to provide interpretation rules for sensors that may be behaving outside the standard of the IPMI specification.
IPMI_OEM_Timestamped_Record can be used to configure an interpretation for a specific Manufacturer-ID, Product-ID, Record-Type, and OEM data combination. The Record-Type must be a legal record type for OEM Timestamped Records (currently 0xC0-0xDF). Each of the OEMDATA fields must specify a hex byte to match or the keyword ANY to match anything.
IPMI_OEM_Non_Timestamped_Record can be used to configure an interpretation for a specific Manufacturer-ID, Product-ID, Record-Type, and OEM data combination. The Record-Type must be a legal record type for OEM Non-Timestamped Records (currently 0xEO-0xFF). Each of the OEMDATA fields must specify a hex byte to match or the keyword ANY to match anything.

FILES

/etc/freeipmi//freeipmi_interpret_sel.conf

REPORTING BUGS

Report bugs to <freeipmi-users@gnu.org> or <freeipmi-devel@gnu.org>.

COPYRIGHT

Copyright (C) 2007-2015 Lawrence Livermore National Security, LLC.

This library is free software; you can redistribute it and/or modifyit under the terms of the GNU General Public License as published bythe Free Software Foundation; either version 3 of the License, or (atyour option) any later version.

SEE ALSO

libfreeipmi(3), libipmimonitoring(3), ipmi-sel(8)

http://www.gnu.org/software/freeipmi/

2022-09-03 FreeIPMI 1.6.10