Manuals / Intel / TV and Video / TV Video Accessories

Intel ZT 7102 manual RPC Usage Examples Sheet 2, 117

Models: ZT 7102

1 152

Download 152 pages 43.02 Kb

Page 117

Intel® NetStructureTMZT 7102 Chassis Management Module

RPC

Table 50. RPC Usage Examples (Sheet 2 of 3)

	Example	ChassisManagementApi() [in]	ChassisManagementApi() [out] parameters
	Example	parameters	ChassisManagementApi() [out] parameters
		parameters

			uReturnType: DATA_TYPE_INT
		pszCMMHost: localhost	ppvbuffer: Integer value denoting health state
	Get the	uCmdCode: CMD_GET	0 = OK
	CMM’s overall	uCmdCode: CMD_GET	0 = OK
	CMM’s overall	pszLocation: CMM	1 = Minor
	health.	pszLocation: CMM	1 = Minor
	health.
		pszDataItem: health	2 = Major
			3 = Critical

			uReturnType: DATA_TYPE_INT
		pszCMMHost: localhost	ppvbuffer: Integer value denoting health state
	Get a blade’s	uCmdCode CMD_GET	0 = OK
	overall health.	pszLocation: blade[1..n]	1 = Minor
		pszDataItem: health	2 = Major
			3 = Critical

	Get the	pszCMMHost: localhost	uReturnType: DATA_TYPE_STRING
	Get the	uCmdCode: CMD_GET
	version of
	version of		ppvbuffer: A human-readable null-terminated
	software on	pszLocation: CMM	ppvbuffer: A human-readable null-terminated
	software on	pszLocation: CMM	version string.
	the CMM.	pszDataItem: version	version string.
	the CMM.


		pszCMMHost: localhost	uReturnType: not used
		uCmdCode: CMD_SET	uReturnType: not used
	Power off one	uCmdCode: CMD_SET	ppvbuffer: not used
	Power off one	pszLocation: blade[1-19]	ppvbuffer: not used
	of the blades.	pszLocation: blade[1-19]	The return code from ChassisManagementApi()
	of the blades.	pszDataItem: powerstate

			indicates success or failure.
		pszSetData: poweroff	indicates success or failure.
		pszSetData: poweroff

		pszCMMHost: localhost	uReturnType: not used
		uCmdCode: CMD_SET	uReturnType: not used
	Power on one	uCmdCode: CMD_SET	ppvbuffer: not used
	Power on one	pszLocation: blade[1-19]	ppvbuffer: not used
	of the blades.	pszLocation: blade[1-19]	The return code from ChassisManagementApi()
	of the blades.	pszDataItem: powerstate

			indicates success or failure.
		pszSetData: poweron	indicates success or failure.
		pszSetData: poweron

		pszCMMHost: localhost	uReturnType: not used
		uCmdCode: CMD_SET	uReturnType: not used
	Reset a	uCmdCode: CMD_SET	ppvbuffer: not used
	Reset a	pszLocation: blade[1-19]	ppvbuffer: not used
	blade.	pszLocation: blade[1-19]	The return code from ChassisManagementApi()
	blade.	pszDataItem: powerstate

			indicates success or failure.
		pszSetData: reset	indicates success or failure.
		pszSetData: reset

	Determine	pszCMMHost: localhost	uReturnType: DATA_TYPE_STRING
	Determine	uCmdCode: CMD_GET
	what sensors
	what sensors		ppvbuffer: A list of sensor names as defined in the
	are on blade	pszLocation: blade3	ppvbuffer: A list of sensor names as defined in the
	are on blade	pszLocation: blade3	SDR.
	3.	pszDataItem: ListTargets	SDR.
	3.


	Determine	pszCMMHost: localhost	uReturnType: DATA_TYPE_STRING
	Determine	uCmdCode: CMD_GET
	what may be
	what may be		ppvbuffer: A list of commands to be used as data
	queried or set	pszLocation: blade3	ppvbuffer: A list of commands to be used as data
	queried or set	pszLocation: blade3	items.
	on a blade.	pszDataItem: ListDataItems	items.
	on a blade.


	Determine	pszCMMHost: localhost
	Determine	uCmdCode: CMD_GET	uReturnType: DATA_TYPE_STRING
	what may be	uCmdCode: CMD_GET	uReturnType: DATA_TYPE_STRING
	queried on the	pszLocation: blade4	ppvbuffer: A list of commands to be used as data
	blade4 +3.3 V	pszTarget: +3.3SensorName	items.
	sensor.	pszDataItem: ListDataItems
		pszDataItem: ListDataItems

Technical Product Specification

117

Image 117

Intel ZT 7102 manual RPC Usage Examples Sheet 2, 117

Contents

Intel NetStructure ZT 7102 Chassis Management Module Technical Product SpecificationTechnical Product Specification Contents 16.1 3.1 11.1.2 15.3 20.2.1 Figures Tables 116 Date Revision Description Revision HistoryZT 7102 Features IntroductionOverview Functional Block Diagram Terms Used in This Document GlossaryAcronym Description Intel NetStructureTMZT 7102 Chassis Management Module Hardware Specifications System Architecture Backplane ConnectionsSlot Connections Fan Modules Power ModulesChassis Sensor Connections Chassis FRU Device ConnectionsFace Plate Face PlateFaceplate Features Faceplate FeaturesFeature Purpose Board Dimensions and Weight ConnectorsPCB Dimensions MechanicalConnector Locations 2 J2 Backplane Connector 1 J1 Backplane ConnectorJ1 Connector Pinout Pin#3 J3 Backplane Connector J2 Connector PinoutJ3 Connector Pinout Pin Type Definitions Backplane Pin DescriptionsPin Descriptions Sheet 1 Pin Type DefinitionPin Descriptions Sheet 2 5 JA1 Ethernet Port6 J6 Serial Port 7 J7 Telco Alarm ConnectorJA1 Ethernet Port Pinout J6 Serial Port PinoutJ7 Telco Alarm Connector Pinout CMM PowerCMM Power Availability Electrical and EnvironmentalOperating Temperature Power Ramp CircuitryReliability Absolute Maximum RatingsDC Operating Characteristics Onboard SwitchesDC Operating Characteristics Switch Cross Reference Table10.1.1 S1 Alarm Cutoff and Board Reset Switch Descriptions10.1.2 SW1-1 Password Reset Processor and ChipsetFlash MemoryDual Ethernet Controllers Serial I/OAlarm Relays Telco Alarm SignalReal Time Clock Network Time SynchronizationBattery Backup Watchdog TimerReplacing the Battery Battery CharacteristicsRunning Your System Without a CMM Operating System Command Line Interface CLI Software SpecificationsRemote Procedure Call RPC Interface Ethernet InterfacesCMM SEL Architecture Sensor Event Logs SELSatellite Management Controller SMC Boards Baseboard Management Controller BMC BoardsHardware Redundancy Specification CMM Redundancy, Synchronization and FailoverSynchronization Synchronization Requirements CMM SynchronizationFiles or data Description Path Scenarios That Force a Failover CMM FailoverScenarios That Prevent Failover Scenarios That Failover to a Healthier Standby CMMScenarios That Failover to an Equally Healthy CMM Failover TimingManual Failover Installing the CMM CMM Installation and RemovalUnpacking ConnectivityEjector Handle Operation Removing the CMMIntel NetStructureTMZT 7102 Chassis Management Module Intel NetStructureTMZT 7102 Chassis Management Module Bist Test Flow Built-In Self TestBoot-BIST Early-BIST Mid-BIST Late-BIST Boot-BISTEarly-BIST Mid-BISTEvent Log Area and Event Management Late-BISTMonitoring the Static Images OS Flash Corruption Detection and Recovery DesignMonitoring the Dynamic Images CMM FailoverBist Test Descriptions 5 DS1307 RTC Test Fpga Version CheckNIC Presence/Local PCI Bus Test OS Image Checksum TestConnecting to the CLI CMM Connection and SetupConnecting through a Console CLI OverviewInitial Setup Logging in for the First Time Setting IP Address PropertiesFTP Into the CMM Eth1 and Eth11 Setting Eth0 to DhcpRebooting the CMM Setting a HostnameSetting Auto-Logout Time Limit Cmmget and cmmset syntax Command Line Interface CLI Syntax and ArgumentsHelp Parameter -h Location Parameter -lDataitem Parameter -d Target Parameter -tTarget -t Keywords Dataitem -d Keywords for All Locations Sheet 1Dataitem -d Keywords for System location Dataitem -d Keywords for All Locations Sheet 2Dataitem -d Keywords for BladeN Locations Data Item Description Get Valid SetDataitem -d Keywords for Chassis Location Dataitem -d Keywords for CMM Location Sheet 1Set Value Parameter Sample CLI OperationsDataitem -d Keywords for CMM Location Sheet 2 Generating a System Status Report Resetting the Password Resetting the Password in a Single CMM SystemResetting the Password in a Dual CMM System Intel NetStructureTMZT 7102 Chassis Management Module Threshold-Based Sensors Sensor TypesDiscrete Sensors Threshold-Based Sensor EventsIntel NetStructureTMZT 7102 Chassis Management Module Syntax of Health Event Strings Health Event StringsHealthevents Query Event Syntax SEL Event SyntaxSnmp Trap Event Syntax Sensor TargetsCMM Sensor Targets Sensor Target DescriptionHealthEvents Queries for Individual Sensors Healthevents QueriesHealthEvents Queries for All Sensors on a Location No Active EventsNot Present or Non-IPMI Locations List of Possible Health Event StringsPower Supply Event Strings PowerSupplyN PowerSupplyN Location IPMI-Compliant Supplies OnlyAll Locations Event String Event Code Event SeverityBist Event Strings Bist Sheet 1 11.4.3 CMM LocationChassis Location Slot Event Strings Slot N Event CMM Redundancy Event Strings CMM 1-2 RedundancyCMM Failover Event Strings CMM Failover CMM File Sync Event Strings CMM File Sync Chassis Sensor Event StringsEvent String Event Code If HealthEvents, its Severity Intel NetStructureTMZT 7102 Chassis Management Module Slot Power-Up Sequence Slot Power ControlAssertion of BDSEL# System Master BoardsDrone Mode Boards Obtaining the Power State of a BoardAssertion of HEALTHY# During Power-Up Fabric and PCI-Less SlotsPower Sequencing Commands and Policies Controlling the Power State of a SlotPowering Off a Board Powering On a BoardRetrieving the Maximum Power-Up Attempts Setting the Healthy# Ramp-Up TimeSetting the Maximum Power-Up Attempts Retrieving the Healthy# Ramp-Up TimeCMM detects a slot has been placed in offline or active Power Sequencing SEL EventsIntel NetStructureTMZT 7102 Chassis Management Module Power Supply Detection Power SuppliesInhibit, Degrade, and Fail Signals Inhibiting Power SuppliesEnabling Power Supplies Drone Mode SBC Support Adding a Drone Mode Capable SBCRemoving a Drone Mode Capable SBC Intel NetStructureTMZT 7102 Chassis Management Module Setting a Slot to Active Mode Setting a Slot to Offline ModeLimitations of the Offline Mode Active vs. Offline SlotsIntel NetStructureTMZT 7102 Chassis Management Module FRU Information Obtaining FRU InformationFRU Query Syntax Data Item DescriptionChassis FRU Validity Check Fan Control and Monitoring Setting Fan SpeedAutomatic Fan Control Considerations for Turning Off the FansQuerying Fan Tray Sensors CLI Scripting CMM ScriptingAssociating Scripts to Event Severity Script SynchronizationListing Scripts Associated With Events Setting Scripts for Specific Individual EventsRemoving Scripts From an Associated Event Event CodesSlot Events Setting Event ScriptsIntel NetStructureTMZT 7102 Chassis Management Module High Level SNMP/MIB Layout SnmpCMM MIB Querying Non-IPMI Compliant Blades and Power SuppliesMIB Design Snmp AgentConfiguring the Agent to Respond to Snmp v3 Requests Configuring the Snmp Agent PortConfiguring the Agent Back to Snmp Setting up an Snmp v3 MIB BrowserSnmp Trap Utility Configuring and Enabling Snmp Trap AddressesAlert Using UDP Alert Alerts Using SNMPv3Security Model Snmpd.conf102 Using the RPC Interface Setting Up the RPC Interface20.0 RPC 103GetAuthCapability ChassisManagementApi104 105 Error and Return Codes for the RPC Interface Sheet 1 Code # Error Code String Error Code Description106 107 Error and Return Codes for the RPC Interface Sheet 2108 Error and Return Codes for the RPC Interface Sheet 3Error and Return Codes for the RPC Interface Sheet 4 ChassisManagementApi Threshold Response Format109 Threshold Response Formats ChassisManagementApi String Response FormatString Response Formats Sheet 1 110111 String Response Formats Sheet 2112 String Response Formats Sheet 3String Response Formats Sheet 4 ChassisManagementApi Integer Response FormatInteger Response Formats Sheet 1 113Integer Response Formats Sheet 2 FRU String Response FormatFRU Data Items String Response Format Sheet 1 114RPC Usage Examples RPC Sample CodeFRU Data Items String Response Format Sheet 2 115116 RPC Usage Examples Sheet 1117 RPC Usage Examples Sheet 2118 RPC Usage Examples Sheet 3119 Command Logging120 Configuring the Telco Alarm Connector Pins Telco Alarm SensorsTelco Alarm Connector Sensor Naming 121Telco Alarm Sensors and Redundancy Sensor Names using Snmp122 System Details Application HostingStartup and Shutdown Scripts System Resources Available to User ApplicationsRAM-Disk Storage Locations Ram Disk Directory StructureRAM Constraints Interrupt Constraints125 Busless Backplane Support126 Update Process Architecture Key Features of the Firmware Update ProcessUpdating Software 127Update Package Critical Software Update Files and DirectoriesList of Critical Software Update Files and Directories Contents of the Update Package Sheet 1Update Firmware Package Version Update Package File ValidationContents of the Update Package Sheet 2 129Component Versioning SaveList and Data PreservationSaveList Items and Their Priorities Sheet 1 130UpdateMetadata File Update ModeSaveList Items and Their Priorities Sheet 2 131Updating to an Older Synchronization Version Updating to a Newer Synchronization VersionSynchronization Behavior for Differing Synch Versions 132Redundant CMM Systems Single CMM SystemCLI Support Updating to the Same Synchronization VersionData Restore User Scripts Update Mode User ScriptsHooks for User Scripts 134135 136 Update ProcessDebugupdate Variable Update Process Status and LoggingUpdate Process Sensor and SEL Events 137Required Setup RedBoot Update ProcessUpdate Procedure 138Example CLI Commands Sheet 1 Use Case CLI Command Return139 140 Example CLI Commands Sheet 2CompactPCI Intel CompactPCI* Product InformationIntel IOP310 Processor Chipset 141142 Returning a Defective Product RMA For the Americas143 For Emea For Apac144 145 146 Technical Support and Return for Service Assistance Sales Assistance147 148 CE Certification SafetyEmissions Test Regulations EN 50081-1 EmissionsSafety Precautions Product Safety InformationRegulatory Information Industry Canada Canada151 152