Intel NetStructure MPCMM0001 Chassis Management Module
Software Technical Product Specification
Page
Contents
Failed Failover/Reboot Recovery, Non-Critical
10.1
100
Snmp
Rmcp
20.5
217
27.8.1
Figures
110
177
Date Revision Description
Revision History
Overview
Introduction1
Terms Used in this Document
Glossary Sheet 1
Glossary Sheet 2
Software Specifications
Red Hat* Embedded Debug and Bootstrap Redboot
Operating System Command Line Interface CLI
Rmcp
Remote Procedural Call RPC Interface
Ethernet Interfaces
Sensor Event Logs SEL
Clearing the SEL
Retrieving the Raw SEL
Blade OverTemp Shutdown Script
Redundancy, Synchronization,
Failover
Synchronization
Files or Data Description Path Priority
CMM Synchronization Sheet 1
Setting User Scripts Sync Configuration Flag
User Scripts Synchronization and Configuration
Heterogeneous Synchronization
1 SDR/SIF Synchronization
Synchronization Requirements
Retrieving User Scripts Sync Configuration Flag
Initial Data Synchronization
Initial Data Sync Failure
Sensor bitmap
Datasync Status Sensor
Event IDs
Querying the Datasync Status
Initial Data Sync is complete and Priority 1 data is changed
Snmp Trap
SEL Event
CMM Failover
System Health
Scenarios That Prevent Failover
Scenarios That Failover to a Healthier Standby CMM
Scenarios That Force a Failover
Manual Failover
CMM Ready Event
CMM Status Event Strings CMM Status
Event String Event Code Event Severity
Bist Test Flow
Built-In Self Test Bist
Bist Flow Chart
Boot-BIST Early-BIST Mid-BIST Late-BIST
Bist Implementation
Early-BIST
Boot-BIST
Mid-BIST
Late-BIST
Configuring QuickBoot
QuickBoot Feature
OS Flash Corruption Detection and Recovery Design
Event Log Area and Event Management
Monitoring the Static Images
Bist Test Descriptions
5 DS1307 RTC Real-Time Clock Test
Fpga Version Check
NIC Presence/Local PCI Bus Test
OS Image Checksum Test
Ipmb Bus Busy/Not Ready Test
Re-enumeration on Failover
Re-enumeration5
Resolution of EKeys
Re-enumeration of M5 FRU
Events Regeneration
Process Monitoring and Integrity
Process Existence Monitoring
Thread Watchdog Monitoring
Processes Monitored
Process Integrity Monitoring
Process Monitoring Targets
Processes Monitored
Examples
Process Monitoring Dataitems
Process Monitoring CMM Events
Snmp MIB Commands
Failure Scenarios and Eventing
No Action Recovery
No Action Recovery
Successful Restart Recovery
Successful Restart Recovery
Description Event String
Successful Failover/Restart Recovery
Successful Failover/Restart Recovery
Successful Failover/Reboot Recovery
Failed Failover/Reboot Recovery, Non-Critical
Successful Failover/Reboot Recovery
Failed Failover/Reboot Recovery, Non-Critical
Failed Failover/Reboot Recovery, Critical
Excessive Restarts, Escalate No Action
Failed Failover/Reboot Recovery, Critical
Excessive Restarts, Successful Escalate Failover/Reboot
Excessive Restarts, Successful Escalate Failover/Reboot
Process Monitoring and Integrity
Administrative Action
Process Administrative Action
Excessive Failover/Reboots, Administrative Action
Excessive Failover/Reboots, Administrative Action
PMS Administrative State
Configuring pms.ini
PMS Excessive Reboot/Failover Count
PMS Excessive Reboot/Failover Interval
Process Section Name
Process Specific Data
Unique ID
Chassis Applicability
Start Program Name and Arguments
Administrative State
Process Existence Interval
Thread Watchdog Retries
Process Definition Section of pms.ini
Monitor Process
CMM Wrapper Process
Chassis Wrapper Process
Command Handler
Snmp
CLI Server
3.8 BPM
Inet Daemon
Dynamic Wrapper Process
Process Integrity Executable PIE Specific Data Config
PIE Section Name
Syslog Daemon
Administrative State
Process Integrity Executable
Unique ID
Process Integrity Interval
PmsPieSnmp Command Line
Chassis Applicability
Snmp PIE Section of pms.ini
11.1 WP/BPM Section of pms.ini
11 WP/BPM PIE
Hot Swap States
Power and Hot Swap Management
FRU Insertion
Graceful FRU Extraction
Power Management on the Standby CMM
Forced Power State Changes
Power Feed Targets
Surprise FRU Extraction/IPMI Failure
Time to Delay and Number of Attempts
Pinging Ipmi Controllers
Variable Description Value
Connecting to the CLI
Command Line Interface CLI
Connecting through a Serial Port Console
CLI Overview
Setting IP Address Properties
Initial Setup- Logging in for the First Time
Setting Static IP Information for eth1 and eth11
Setting Static IP Information for eth0
Setting eth1 to Dhcp
Setting eth0 to Dhcp
Setip Interface Assignments when BOOTPROTO=static
Interface
Setting a Hostname
Setting the Amount of Time for Auto-Logout
Setip Interface Assignments when BOOTPROTO=dhcp
Rebooting the CMM
Setting the Date and Time
Telnet into the CMM
Connect Through SSH Secure Shell
Cmmget and Cmmset Syntax
CLI Command Line Syntax and Arguments
Help Parameter -h
Location Parameter -l
PEM2
Target Parameter -t
Keyword Description
CMM Targets
Location Dataitem lists
Dataitem Parameter -d
Dataitem Keywords for All Locations
Dataitem Keywords for All Locations Except System
Command Line Interface CLI
Will only work on standby
PowerOn
Command Line Interface CLI
MPCHC0001
Dataitem Keywords for Chassis Location
Dataitem Description Get CLI Get Output Valid Set Values
Dataitem Keywords for Cmm Location Sheet 1
Dataitem Keywords for Cmm Location Sheet 2
Refer to , Updating CMM Software on
Dataitem Keywords for Cmm Location Sheet 3
C.D
Dataitem Keywords for Cmm Location Sheet 4
Dataitem Keywords for Cmm Location Sheet 5
Dataitem Keywords for Cmm Location Sheet 6
Dataitem Keywords for System Location
Dataitem Keywords for Cmm Location Sheet 7
Dataitem Keywords for FantrayN Location
Target Dataitem Lists
Dataitem Keywords Used with the Target Parameter Sheet 1
CMM Scripting on
Dataitem Keywords Used with the Target Parameter Sheet 2
125 for more
Dataitem Keywords Used with the Target Parameter Sheet 3
Sample CLI Operations
Value Parameter
Generating a System Status Report
Dataitem Keywords Used with the Target Parameter Sheet 4
Command Line Interface CLI
Resetting the Password in a Dual CMM System
Resetting the Password
Resetting the Password in a Single CMM System
Sensor Types
CMM Sensor Types Threshold-Based Sensors
Threshold-Based Sensor Events
Discrete Sensors
CMM Voltage/Temp Sensor Thresholds
CMM Voltage and Temp Sensor Thresholds
Sensor Name
Discrete Sensor Events
Syntax of Health Event Strings
Health Events
Healthevents Query Event Syntax
SEL Event Syntax
Snmp Trap Event Syntax
SEL Sensor Types
CMM SEL Sensor Information
Descriptions
Sensor Targets
Sensor Targets Sheet 1
Sensor Target Description
Healthevents Queries
HealthEvents Queries for Individual Sensors
Sensor Targets Sheet 2
No Active Events
HealthEvents Queries for All Sensors on a Location
Not Present or Non-IPMI Locations
List of Possible Health Event Strings
All Locations
Threshold-Based Sensors Voltage, Temp, Current, Fan
Event String Event Code Event Severity Hex Decimal
Ipmb Link State Sensor IPMB-0 Snsr
Hot Swap Sensor Filter Tray HS, FRU Hot Swap
0x255 597 Major
Health Events
Watchdog 2 Sensor Event Strings Sheet 1
Watchdog 2 Sensor Event Strings Sheet 2
CMM Redundancy
CMM Location
CMM Trap Connectivity CMM 1-2 Trap Conn
CMM Failover Sheet 1
CMM Failover Sheet 2
Bist Event Strings Sheet 1
Chassis Data Module CDM 1,2
Bist Event Strings Sheet 2
Datasync Status
Event String Event Code Event Severity Hex
Process Monitoring Service Fault Event Strings PMS Fault
Process Monitoring Service Info Event Strings PMS Info
Ipmi Error Completion Codes
Chassis Location
Chassis Events
IPMI/IMB Error Message Format
Configuring Ipmi Error Completion Codes
Ipmi Error Completion Codes and Enumerations
Code Error Message
Example
LED Symbol Status Description
Alarm LEDs
Front Panel LEDs
LED Types and States
Hot Swap LED
Health LED
User Definable LEDs
Retrieving a Location’s LED properties
Retrieving the State of LEDs
Setting the State of the User LEDs
Ledstate Functions and Function Options
Function values Description Function options
LED Boot Sequence
LED Event Sequence
Event Health LED Hot Swap
Node Power Control
Resetting a Board
Electronic Keying Manager
EKeying CLI Commands
Point-to-Point EKeying
Bused EKeying
Chassis Data Module
CDMs and FRU Information
15.2 FRU/CDM Election Process
FRU Information
FRU Query Syntax
Dataitems Used With FRU Target -t to Obtain FRU Information
Dataitem Description
Fan Control and Monitoring
CMM Cooling Manager Temperature Status
Automatic Fan Control
Querying Fan Tray Sensors FantrayN location
Temperature Sample Cooling User
Setting Values in the Cooling Table
CMM Cooling Table
CMM Cooling Table
Fantray Control Mode
CMM Control Mode
Emergency Shutdown Control Mode
Control Modes for Fan Trays
User Initiated Mode Change
Automatic Mode Change
Getting Temperature Statuses
Fantray Properties
Retrieving the Current Cooling Level
Fantray Insertion
Default Cooling Values
Vendor Defaults
Setting User Defaults and Defaultcontrol through the CLI
Restoring Defaults
Code Defaults
Firmware Upgrade/Downgrade
Structure of /etc/cmm/fantray.cfg
Chassis vs. Fantray
Legacy Method of Querying/Setting Fan Speed
Snmp
MIB Design
CMM MIB
MIB Tree
MIB II Objects System Group
CMM Custom MIB Tree
CMM MIB Objects
OID
System Location
String
Shelf Location Equivalent to Chassis
145
Cmm Location 1.3.6.1.4.1.343.2.14.2.10.3 Sheet 1
CMM2
Cmm Location 1.3.6.1.4.1.343.2.14.2.10.3 Sheet 2
Cmm Location 1.3.6.1.4.1.343.2.14.2.10.3 Sheet 3
CmmTable/cmmEntry 1.3.6.1.4.1.343.2.14.2.10.3.51.1 Sheet 1
CmmTable/cmmEntry 1.3.6.1.4.1.343.2.14.2.10.3.51.1 Sheet 2
CmmFruTargetTable
CmmFruTable/cmmFruEntry
Blade# Location
#TotalFrus
Blade#FruTable/blade#FruEntry
Blade#FruTargetTable/blade#FruTargetEntry
FanTrayMaximumSetting
Read-write Used to associate a script to a
Configuring the Snmp Agent Port
Configuring the Agent to Respond to Snmp v3 Requests
Snmp Agent
Setting up an Snmp v1 MIB Browser
Configuring the Agent Back to Snmp
Setting up an Snmp v3 MIB Browser
Changing the Snmp MD5 and DES Passwords
Configuring the CMM to Send Snmp v3 Traps
Configuring the Snmp Trap Port
Configuring the CMM to Send Snmp v1 Traps
Configuring and Enabling Snmp Trap Addresses
Alerts Using Snmp
Configuring an Snmp Trap Address
Alert Using UDP Alert
Enabling and Disabling Snmp Traps
Snmp Trap Descriptions
Snmp Security Snmp v1 Security
Snmp v3 Security Fields For Traps
Snmp v3 Security Fields For Queries
Snmpd.conf File
CLI Scripting
CMM Scripting
Script Synchronization
Event Scripting
Listing Scripts Associated With Events
Setting Scripts for Specific Individual Events
Removing Scripts From an Associated Event
Event Codes
Sensor Data Bits
Setting Event Action Scripts
CMM State Transition Events and Event IDs
Event ID Event Name
Retrieving the Value of the Data Sensor Bits
CMM Status Sensor Data Bits
Bit Bit Name Explanation
Setting the CMMReadyTimeout Value
CMMReadyTimeout Value
Retrieving the CMMReadyTimeout Value
CMM State Transition Model
FRU Control Script
CMM Status State Diagram
Sample frucontrol file
Command line arguments
171
# Activation
173
Remote Procedure Calls RPC
Setting Up the RPC Interface
Using the RPC Interface
ChassisManagementApi
GetAuthCapability
Remote Procedure Calls RPC
Code # Error Code String Error Code Description
Error and Return Codes for the RPC Interface Sheet 1
Error and Return Codes for the RPC Interface Sheet 2
Error and Return Codes for the RPC Interface Sheet 3
Ewpthresholdunsupported
Error and Return Codes for the RPC Interface Sheet 4
ChassisManagementApi String Response Format
ChassisManagementApi Threshold Response Format
Threshold Response Formats
String Response Formats Sheet 1
Critical/Major/Minor Event Health
String Response Formats Sheet 2
Board is present or not present /n
String Response Formats Sheet 3
X.XXXX /0
String Response Formats Sheet 4
ChassisManagementApi Integer Response Format
String Response Formats Sheet 5
Integer Response Formats
FRU String Response Format
FRU Data Items String Response Format
Data Item Description
RPC Sample Code
RPC Usage Examples
RPC Usage Examples Sheet 1
RPC Usage Examples Sheet 2
RPC Usage Examples Sheet 3
Rmcp References
Rmcp Mode Description
Rmcp Modes
Rmcp Modes
Rmcp User Privilege Levels
Rmcp Discovery
Rmcp Session Activation
Rmcp Session Timers
Rmcp Session Phase Time-out Interval
Rmcp Port Numbers
Ipmb Slave Addresses
CMM Rmcp Configuration
Rmcp Slave Addresses
Nodes Value
Ipmi Commands Supported by CMM Rmcp
Ipmi Commands Supported by CMM Rmcp Sheet 1
Command Type Defined
Ipmi Commands Supported by CMM Rmcp Sheet 2
Ipmi Commands Supported by CMM Rmcp Sheet 3
Configuring Ipmi Command Privileges
Completion Codes for the Rmcp Messages
Sample cmdPrivillege.ini file
Code Description
Rmcp Message Completion Codes
Command Logging
Command and Error Logging
Error Logging
Error.log File
Cmmdump Utility
System Details Startup and Shutdown Scripts
Application Hosting
System Resources Available to User Applications
File System Storage Constraints
RAM Constraints
Flash Memory Map
RAM-Disk Storage Locations
RAM Disk Directory Structure
Interrupt Constraints
Key Features of the Firmware Update Process
Update Process Architecture
Updating CMM Software
Update Package
Critical Software Update Files and Directories
List of Critical Software Update Files and Directories
File or Directory Name Description
Contents of the Update Package
Update Package File Validation
Update Firmware Package Version
Component Versioning
SaveList and Data Preservation
Update Mode
SaveList Items and Their Priorities
File Priority
Firmware Update Synchronization/Failover Support
UpdateMetadata File
Automatic/Manual Failover Configuration
CMM Update Directions
Retrieving the Failover Configuration Flag
Setting Failover Configuration Flag
CLI Software Update Procedure
Single CMM System
Hooks for User Scripts
Update Mode User Scripts
Example Task-Replace /home/scripts/myScript
Data Restore User Scripts
Update Process
Software update must be executed again to solve the problem
Update Process Sensor and SEL Events
Update Process Status and Logging
Redboot* Update Process
Required Setup
Updatecmm 00-a0-b7-d8-d8-5d FFS2
Updating Shelf Components
Command Request String Format
Command Syntax and Interface
Usage Examples
Response String
Snmp
Usage Example
Ipmi Pass-Through
FRU Update Utility
FRU Update Architecture
Platform FRU Accessibility of the FRU Update Utility
FRU Recovery Process
FRU Update Process
FRU Update Command Line Interface
Setting the Library Path And Invoking the Utility
FRU Verification
FRU Display
Using the Location Switch
FruUpdate Utility Command Line Options
Argument Parameter Description Short Name Required/Optional
Getting the Contents of the FRU
Viewing the Contents of the FRU
Dumping the Contents of the FRU
Updating the FRU
LDLIBRARYPATH=. ./fruUpdate /d output.bin 12 /l chassis
Configuration File Format
FRU Update Configuration File
File Format
String Constraints
Numeric Constraints
Control Commands
Tags
Ifset
Else
Endif
27.6.4 SET
Clear
Probing Commands
Cfgname
Probe
System
Probe Command Parameters
Fruver
Probe Type Parameter Description of Parameter
Found
Bmcver
Fruname
Update Commands
Fruarea
Fruaddress
FRU Area Ascii Strings
FRU Area String Specifications
Parameter Parameter Value Description Number
Multi-Record Selection Parameters
FRU Field Maximum Allowed Lengths Sheet 1
FRU Field First String Specifications
FRU Field First String Description Ascii String
FRU Fields FRU Field Max Allowed Length
FRU Field Second String Specification
FRU Field Maximum Allowed Lengths Sheet 2
Empty string
Type Description Frusdr Version
Type Code Specification
Input of Data
Display Commands
Input Commands
Display
Menu
Prompt
Menutitle
Command Quick Reference Sheet 1
Command Quick Reference
27.9.8 YES
27.9.9 no
Else
Command Quick Reference Sheet 2
Frufield
Command Quick Reference Sheet 3
Chassis Update Version
Example Configuration File
Probe Arguments Quick Reference
Probe Arguments Description
247
Errorlevel 0 Else Ifset Fruverneeded
Chassis Update Version
Errorlevel Endif Probe Fruver Found Allupdates
251
Endif Ifset Ipmblinkupdate
System Events Overview
Unrecognized Sensor Types
System Events- Snmp Trap Support
Snmp Trap Header Format
Snmp Trap Atca Trap Text Translation Format
SNMPTrapFormat =
Snmp Trap Raw Format
Snmp Trap Control
Results of Variable Settings
System Events- SEL Support
SEL Header Format
SEL Raw Format
Configuring SEL Format
SELFormat = 1 text Example Output
SELFormat = 2 raw Example Output
System Events SEL Display Control
Returning a Defective Product RMA
Warranty Information
For Asia and Pacific Apac
For Europe, Middle East, and Africa Emea
261
Customer Support
Customer Support
Certifications31
North America FCC Class a
Agency Information
French
English
Agency Information
Not the Main Disconnect
Safety Warnings
Mesures de Sécurité
269
Sicherheitshinweise
271
Norme di Sicurezza
273
Instrucciones de Seguridad
275
Chinese Safety Warning
Example CLI Commands
Example CLI Commands Sheet 1
Use Case CLI Command Return
Example CLI Commands Sheet 2
Example CLI Commands
Example CLI Commands Sheet 3
Intel AdvancedTCA* Product Information
Data Sheet Reference
Open Source CD