Manuals / Intel / Computer Equipment / Network Router

Intel ZT 4901 manual Revision History, Date Revision Description

Models: ZT 4901

1 136

Download 136 pages 35.65 Kb

Page 7

Contents

Revision History

	Date	Revision	Description

	April 2003	002	Removed three demonstration utilities from 10.1.2.7 and
	April 2003	002	removed Interhost Communication section.
			removed Interhost Communication section.

	January 2003	001	Initial release of this document

High Availability Software for the Intel® NetStructureTM ZT 4901 Technical Product Specification

7

Image 7

Intel ZT 4901 manual Revision History, Date Revision Description

Contents

Intel NetStructureTM ZT 4901 High Availability Software Technical Product SpecificationPage Contents Hot Swap API Demonstration Utilities Tables FiguresDate Revision Description Revision HistoryThis page intentionally left blank Document Organization Document Organization Terminology IntroductionFollowing terms are commonly used in this document Introduction Introduction High Availability Hardware Approach PCI Processor BoardsCIC Bridge Mezzanine RSS Processor Board Block DiagramBackplane RSS Host with Bridge Mezzanine Block DiagramHost Application High-Availability Software ApproachHost application System Management Backplane Device Drivers System Management Backplane Device Drivers Portability ServiceabilityHost Application Software Goals of the Host ApplicationHost Application Software Division of LaborDevelopment Issues Hardened Applications Graceful SwitchoverCode Modularity Redundant Host API System ManagementIpmi API Slot Control API Fault ConfigurationBaseboard Management Controller Firmware Enhancements Hot Swap APIChannel Definitions for ZT Isolation StrategiesRH Channel Enabled Ipmi RH Channel CommandsRH Channel Get RH BMC Address Request Response This page intentionally left blank Device Driver Design High Availability CompactPCI Device DriversActivation Device Driver StatesInitialization QuiescedRemoved Adding High-Availability FunctionalityFind DeviceResume Operations Add DeviceRemove Device Suspend OperationsDriver Synchronization Summary RhSetHostName RhGetHwDestinationHostAndResetRedundant Host API Intel-Specific APIsHsistatusinvalidparameter Redundant Host PICMG* 2.12 APIsRedundant Host API HsistatussuccessFollowing topics specify each of the interface functions Definitions and TypesMinoralarm Majoralarm Criticalalarm Rhalarmseverity RESETREQUIRED, Resetnotrequired Unknown Rhslotneedsreset Hsistatusinsufficientbuffer Initialization/TerminationRhEnumerateInstances Hsistatusno DatadetectedRhEnumerateInstances RhOpenRhOpen Char *InstanceId Optional OUT Rhhandle *pHandle InstanceIdHandle RhCloseRhGetInstanceID RhClose in Rhhandle HandleRhGetDomainCount Rhhandle Handle OUT uint32 *pCount Handle Handle of the current session PInstanceIDDomain and Host Information API RhGetDomainCountHandle Handle of the current session PCount RhGetDomainNumbersSystem RhGetDomainSlotPath RhGetDomainOwnershipHSISTATUSINSUFFICIENTBUFFER, this is the minimum Domain is written as a null-terminated stringSlotPathLength CharacterRhGetDomainSlots RhGetDomainSlotCountIs placed RhGetSlotDomain RhGetHostCount RhGetCurrentHostNumberRhGetCurrentHostNumber Rhhandle Handle OUT uint32 *pHost RhGetHostCount Rhhandle Handle OUT uint32 *pHostCount RhGetHostNumbersHandle Handle of the current session PHostCount RhGetHostName False RhSetHostAvailabilityRhGetHostAvailability RhGetDomainAvailabilityToHost Slot Information APIRhGetPhysicalSlotInformation Devices directly placed in the physical slots HsinosuchdeviceIf the specified slot is empty RhslotdescriptorBy two characters from the set ‘0’..’9’, ‘A’..’F’ RhGetSlotChildInformationSlotPath + FunctionNumber for the corresponding PCI-PCI bridgeIf there are no child devices below the specified bridge Handle Handle of the current session PhysSlotPCI buses in the system Switchover Scenarios and Theory of Operation Switchover APIPartially Cooperative Switchover Hostile Switchover RhPrepareForSwitchoverHsistatusrequestdenied Hsistatussuccess returned in the case of success RhCancelPrepareForSwitchoverRhGetDomainSwConnectionStatus RhGetSlotSwConnectionStatus RhPerformSwitchoverInvalid session handle or the specified slot does not exist Specified domains RhSetHwDestinationHostHandle Handle of the current session DestinationHost Value Rhnodestinationhost means no host should ownRhnodestinationhost means no host owns the domains RhEnableDomainStateNotification Notification, Reporting and AlarmsRhGetHwDestinationHost Disconnecting RhEnableSwitchoverNotificationDuring software connection and disconnection Switchovers in which it participates RhEnableSwitchoverRequestNotificationRhEnableUnsafeSwitchoverNotification Indicates is the depth of the device below the physical slot Device in unsafe stateRhDisableNotification Handle Handle of the current session NotificationType Hot Swap API Hot Swap API ImbCloseDriver ImbOpenDriverImbDeviceIoControl Lpdword ImbSendTimedI2cRequestLpvoid DwordImbGetAsyncMessage ImbSendIpmiRequestAccesnstatus EventId EventID handle returned once registered ImbIsAsyncMessageAvailableImbRegisterForAsyncMsgNotification ImbUnregisterForAsyncMsgNotificationImbSetLocalBmcAddr ImbGetLocalBmcAddrCurrent determined Ipmi version ImbGetIpmiVersionByte imbGetIpmiVersion ByteHsistatusnomemory Slot Control APIHsiOpenSlotControl HsiCloseSlotControlHsiGetBoardPresent HsiGetSlotCountSlot Control API Hsistatusnodatadetected HsiGetBoardHealthyHealthy HsiGetSlotPowerHsiGetSlotReset HsiSetSlotPowerHsistatusnotimplemented HsiSetSlotResetSlot Physical slot number False 66 MHz operation is not enabled for the slot HsiGetSlotM66EnableHsiapidef Hsistatus HsiSetSlotM66Enable Returned if the arguments or handle is invalid HsiSetSlotEventCallbackHandle Handle of the current session Callback FunctionHsisloteventinfostruct Void *HSISLOTEVENTCALLBACKHsisloteventinfo RH Interface Demonstration UtilitiesFunctional Description User InterfaceDemonstration Utilities Multiple Mode CapabilitiesSoftware Initiated Handovers Hardware Initiated FailoversSlot Information Switchover FunctionsNotification, Reporting and Alarms Host Domain Enumeration and AssociationIpmi Interface Fault ConfigurationIsolation Strategy HS Functional Description Hot Swap InterfacePCI Tree Information Retrieval Flags Slot Information StructureSlot State Slot Control InterfaceDemonstration Utilities Installing the Redundant Host Software Kit Software InstallationLinux Software Installation Installing RH Source RPMSource Installation Patching and Rebuilding an RH-Enabled Kernel2 /lib/modules/slotcntrl.o Configuring the Redundant Host InfrastructureMaking RH Configuration Changes 1 /lib/modules/priBptd.o3 /CompactPCI-RH-1.0/app/lib VxWorks Tornado II Setup4 /CompactPCI-RH-1.0/app/bin RedundantHostFunctionReturnValuesB Redundant Host Function Return Values Hsistatusnosysrhtablefound HsistatusnosuchbridgeHsistatusoperationaborted HsistatusnotavailibleHsistatusnotready HsistatusobjectdoesnotexistHsistatusuptinsertionfailed HsistatusunabletosendpacketHsistatusunsuccessfultranslation HsistatusunsupportedplatformThis page intentionally left blank HSK Driver Object Declaration HSK Device Driver Interface for VxWorksHSK Device Driver Interface for VxWorks HSK Device Information StructureCompatlistcheckdevice HSK Driver Instantiation Code SegmentPrhdeviceobj AddDevice Redundant Host-Aware Callback DefinitionsHsistatussuccess if successful otherwise Hsistatusfailure Hsistatus StartDeviceHsistatus StopDevice Prhdeviceobj deviceobjectHsistatus SurpriseRemoval Hsistatus RemoveDeviceHsistatus rhHskRegisterMsgCallback RH-Aware Message Registration DefinitionsInt rhHskUnregisterMsgCallback Process Packet Callback DefinitionPcilocation pci Length in bytes of the data packet being sent RH-Aware Send Message DefinitionHsistatus rhHskSendMessage UINT8* pBuf, int iLen, Pvoid pContextPPackett Alternate Hscsr InterfacesRH Device Driver Interface for Linux RH Device Driver Interface for Linux Support for Unmodified Standard Drivers Design Guideline for Peripheral VendorsENon Bus Mastering Peripheral Bus Mastering DMA Capable PeripheralDesign Guideline for Peripheral Vendors Category ZT 5550 Functions Redundant Host Functions Porting ZT 5550 HA Applications to PicmgHASetEthernetRou Porting ZT 5550 HA Applications to PicmgHAGetEthernetRo UtingRH Switchover on OS Crash RH Switchover on OS Crash Wind River* VxWorks Programmer’s Guide is available at Data Sheet ReferenceCompactPCI User Documentation VxWorksData Sheet Reference Impi IndexIpmi API Page This page intentionally left blank