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