FRU Control Script, CMM Status State Diagram | Intel MPCMM0001

CMM Scripting

Figure 5. CMM Status State Diagram

18.5FRU Control Script

The CMM will check for a file in /home/scripts called frucontrol before it activates or deactivates any FRU. If that file does not exist, the CMM automatically activates or deactivates all FRUs. If it does exist, the CMM attempts to execute the program, and that is all. It is then up to the /home/

MPCMM0001 Chassis Management Module Software Technical Product Specification

169

Image 169

Intel MPCMM0001 manual FRU Control Script, CMM Status State Diagram

Contents

Intel NetStructure MPCMM0001 Chassis Management Module Software Technical Product SpecificationPage 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 Introduction1Terms Used in this Document Glossary Sheet 1 Glossary Sheet 2 Red Hat* Embedded Debug and Bootstrap Redboot Software SpecificationsOperating System Command Line Interface CLI Rmcp Remote Procedural Call RPC InterfaceEthernet Interfaces Sensor Event Logs SEL Retrieving the Raw SEL Clearing the SELBlade OverTemp Shutdown Script Failover Redundancy, Synchronization,Synchronization Files or Data Description Path Priority CMM Synchronization Sheet 1 Setting User Scripts Sync Configuration Flag User Scripts Synchronization and ConfigurationHeterogeneous Synchronization 1 SDR/SIF Synchronization Synchronization Requirements Retrieving User Scripts Sync Configuration FlagInitial Data Synchronization Initial Data Sync Failure Sensor bitmap Datasync Status SensorEvent IDs Querying the Datasync Status Initial Data Sync is complete and Priority 1 data is changed Snmp Trap SEL Event CMM Failover System HealthScenarios That Prevent Failover Scenarios That Failover to a Healthier Standby CMM Scenarios That Force a Failover Manual Failover CMM Status Event Strings CMM Status CMM Ready EventEvent String Event Code Event Severity Bist Test Flow Built-In Self Test Bist Boot-BIST Early-BIST Mid-BIST Late-BIST Bist Flow ChartBist Implementation Early-BIST Boot-BISTMid-BIST Late-BIST Configuring QuickBoot QuickBoot Feature Event Log Area and Event Management OS Flash Corruption Detection and Recovery DesignMonitoring the Static Images Bist Test Descriptions 5 DS1307 RTC Real-Time Clock Test Fpga Version CheckNIC Presence/Local PCI Bus Test OS Image Checksum Test Ipmb Bus Busy/Not Ready Test Re-enumeration on Failover Re-enumeration5 Re-enumeration of M5 FRU Resolution of EKeysEvents Regeneration Process Existence Monitoring Process Monitoring and IntegrityThread Watchdog Monitoring Processes Monitored Process Integrity MonitoringProcess 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 RecoverySuccessful Restart Recovery Description Event String Successful Failover/Restart Recovery Successful Failover/Restart Recovery Failed Failover/Reboot Recovery, Non-Critical Successful Failover/Reboot RecoverySuccessful 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.iniPMS Excessive Reboot/Failover Count PMS Excessive Reboot/Failover Interval Process Section Name Process Specific DataUnique ID Chassis Applicability Start Program Name and Arguments Administrative StateProcess Existence Interval Thread Watchdog Retries Process Definition Section of pms.ini Monitor Process CMM Wrapper Process Chassis Wrapper Process Snmp Command HandlerCLI Server 3.8 BPM Inet Daemon Dynamic Wrapper Process PIE Section Name Process Integrity Executable PIE Specific Data ConfigSyslog Daemon Process Integrity Executable Administrative StateUnique ID Process Integrity Interval PmsPieSnmp Command LineChassis 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 ManagementFRU Insertion Graceful FRU Extraction Power Management on the Standby CMM Forced Power State ChangesPower Feed Targets Surprise FRU Extraction/IPMI Failure Pinging Ipmi Controllers Time to Delay and Number of AttemptsVariable Description Value Connecting to the CLI Command Line Interface CLIConnecting 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 DhcpSetip Interface Assignments when BOOTPROTO=static Interface Setting the Amount of Time for Auto-Logout Setting a HostnameSetip Interface Assignments when BOOTPROTO=dhcp Rebooting the CMM Setting the Date and TimeTelnet into the CMM Connect Through SSH Secure Shell Cmmget and Cmmset Syntax CLI Command Line Syntax and ArgumentsHelp Parameter -h Location Parameter -l PEM2 Target Parameter -t Keyword Description CMM Targets Location Dataitem lists Dataitem Parameter -dDataitem 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 ParameterGenerating 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 CMM Sensor Types Threshold-Based Sensors Sensor TypesThreshold-Based Sensor Events Discrete Sensors CMM Voltage/Temp Sensor ThresholdsCMM Voltage and Temp Sensor Thresholds Sensor Name Discrete Sensor Events Syntax of Health Event Strings Health EventsHealthevents Query Event Syntax SEL Event Syntax Snmp Trap Event Syntax SEL Sensor TypesCMM SEL Sensor Information Descriptions Sensor Targets Sheet 1 Sensor TargetsSensor Target Description HealthEvents Queries for Individual Sensors Healthevents QueriesSensor Targets Sheet 2 No Active Events HealthEvents Queries for All Sensors on a LocationNot Present or Non-IPMI Locations List of Possible Health Event Strings Threshold-Based Sensors Voltage, Temp, Current, Fan All LocationsEvent 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 LocationCMM 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 2Datasync 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 CodesChassis Location Chassis Events IPMI/IMB Error Message Format Configuring Ipmi Error Completion CodesIpmi Error Completion Codes and Enumerations Code Error Message Example LED Symbol Status Description Alarm LEDsFront Panel LEDs LED Types and States Hot Swap LED Health LEDUser Definable LEDs Retrieving a Location’s LED properties Retrieving the State of LEDs Setting the State of the User LEDsLedstate Functions and Function Options Function values Description Function options LED Event Sequence LED Boot SequenceEvent Health LED Hot Swap Node Power Control Resetting a Board Electronic Keying Manager EKeying CLI CommandsPoint-to-Point EKeying Bused EKeying Chassis Data Module CDMs and FRU Information15.2 FRU/CDM Election Process FRU Information Dataitems Used With FRU Target -t to Obtain FRU Information FRU Query SyntaxDataitem Description Fan Control and Monitoring CMM Cooling Manager Temperature StatusAutomatic Fan Control Querying Fan Tray Sensors FantrayN location Temperature Sample Cooling User Setting Values in the Cooling TableCMM Cooling Table CMM Cooling Table Fantray Control Mode CMM Control ModeEmergency Shutdown Control Mode Control Modes for Fan Trays Automatic Mode Change User Initiated Mode ChangeGetting Temperature Statuses Retrieving the Current Cooling Level Fantray PropertiesFantray Insertion Vendor Defaults Default Cooling ValuesSetting User Defaults and Defaultcontrol through the CLI Restoring Defaults Code DefaultsFirmware Upgrade/Downgrade Structure of /etc/cmm/fantray.cfg Chassis vs. Fantray Legacy Method of Querying/Setting Fan Speed Snmp MIB Design CMM MIBMIB 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 Agent to Respond to Snmp v3 Requests Configuring the Snmp Agent PortSnmp Agent Setting up an Snmp v1 MIB Browser Configuring the Agent Back to SnmpSetting 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 PortConfiguring the CMM to Send Snmp v1 Traps Configuring and Enabling Snmp Trap Addresses Alerts Using Snmp Configuring an Snmp Trap AddressAlert Using UDP Alert Enabling and Disabling Snmp Traps Snmp Trap Descriptions Snmp Security Snmp v1 SecuritySnmp v3 Security Fields For Traps Snmp v3 Security Fields For Queries Snmpd.conf File CLI Scripting CMM ScriptingScript Synchronization Event Scripting Listing Scripts Associated With Events Setting Scripts for Specific Individual EventsRemoving Scripts From an Associated Event Event Codes Sensor Data Bits Setting Event Action ScriptsCMM State Transition Events and Event IDs Event ID Event Name CMM Status Sensor Data Bits Retrieving the Value of the Data Sensor BitsBit Bit Name Explanation Setting the CMMReadyTimeout Value CMMReadyTimeout ValueRetrieving the CMMReadyTimeout Value CMM State Transition Model FRU Control Script CMM Status State Diagram Sample frucontrol file Command line arguments 171 # Activation 173 Setting Up the RPC Interface Remote Procedure Calls RPCUsing 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 FormatThreshold 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 String Response Formats Sheet 5 ChassisManagementApi Integer Response FormatInteger Response Formats FRU Data Items String Response Format FRU String Response FormatData Item Description RPC Usage Examples RPC Sample CodeRPC Usage Examples Sheet 1 RPC Usage Examples Sheet 2 RPC Usage Examples Sheet 3 Rmcp References Rmcp Mode DescriptionRmcp Modes Rmcp Modes Rmcp Discovery Rmcp User Privilege LevelsRmcp Session Activation Rmcp Session Phase Time-out Interval Rmcp Session TimersRmcp Port Numbers Ipmb Slave Addresses CMM Rmcp ConfigurationRmcp Slave Addresses Nodes Value Ipmi Commands Supported by CMM Rmcp Sheet 1 Ipmi Commands Supported by CMM RmcpCommand 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 LoggingError Logging Error.log File Cmmdump Utility System Details Startup and Shutdown Scripts Application HostingSystem Resources Available to User Applications File System Storage Constraints Flash Memory Map RAM ConstraintsRAM-Disk Storage Locations RAM Disk Directory Structure Interrupt Constraints Update Process Architecture Key Features of the Firmware Update ProcessUpdating CMM Software Update Package Critical Software Update Files and DirectoriesList of Critical Software Update Files and Directories File or Directory Name Description Contents of the Update Package Update Package File Validation Component Versioning Update Firmware Package VersionSaveList and Data Preservation SaveList Items and Their Priorities Update ModeFile Priority Firmware Update Synchronization/Failover Support UpdateMetadata FileAutomatic/Manual Failover Configuration CMM Update Directions Retrieving the Failover Configuration Flag Setting Failover Configuration FlagCLI 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 LoggingRedboot* 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 StringSnmp Usage Example Ipmi Pass-Through FRU Update Architecture FRU Update UtilityPlatform 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 UtilityFRU Verification FRU Display FruUpdate Utility Command Line Options Using the Location SwitchArgument Parameter Description Short Name Required/Optional Getting the Contents of the FRU Viewing the Contents of the FRUDumping the Contents of the FRU Updating the FRU LDLIBRARYPATH=. ./fruUpdate /d output.bin 12 /l chassis Configuration File Format FRU Update Configuration FileFile Format String Constraints Numeric Constraints Control CommandsTags Ifset Endif Else27.6.4 SET Clear Probing CommandsCfgname Probe System Probe Command ParametersFruver 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 SpecificationsFRU Field First String Description Ascii String FRU Fields FRU Field Max Allowed Length FRU Field Maximum Allowed Lengths Sheet 2 FRU Field Second String SpecificationEmpty string Type Description Frusdr Version Type Code Specification Input of Data Display Commands Display Input CommandsMenu Prompt Menutitle Command Quick Reference Sheet 1 Command Quick Reference27.9.8 YES 27.9.9 no Else Command Quick Reference Sheet 2 Frufield Command Quick Reference Sheet 3 Chassis Update Version Example Configuration FileProbe 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 Snmp Trap Header Format System Events- Snmp Trap SupportSnmp Trap Atca Trap Text Translation Format SNMPTrapFormat = Snmp Trap Raw Format Snmp Trap Control Results of Variable SettingsSystem Events- SEL Support SEL Header Format SEL Raw Format Configuring SEL FormatSELFormat = 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 Sheet 1 Example CLI CommandsUse 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