Manuals / Intel / Computer Equipment / Network Router

Intel ZT 4901 manual RH Switchover on OS Crash

Models: ZT 4901

1 136

Download 136 pages 35.65 Kb

Page 130

RH Switchover on OS Crash

This page intentionally left blank.

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

Image 130

Intel ZT 4901 manual RH Switchover on OS Crash

Contents

Technical Product Specification Intel NetStructureTM ZT 4901 High Availability SoftwarePage Contents Hot Swap API Demonstration Utilities Figures TablesRevision History Date Revision DescriptionThis 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 RSS Processor Board Block Diagram Bridge MezzanineRSS Host with Bridge Mezzanine Block Diagram BackplaneHost Application High-Availability Software ApproachHost application System Management Backplane Device Drivers System Management Backplane Device Drivers Goals of the Host Application ServiceabilityHost Application Software PortabilityDivision of Labor Host Application SoftwareDevelopment Issues Hardened Applications Graceful SwitchoverCode Modularity Redundant Host API System ManagementIpmi API Hot Swap API Fault ConfigurationBaseboard Management Controller Firmware Enhancements Slot Control APIIsolation Strategies Channel Definitions for ZTRH Channel Enabled Ipmi RH Channel CommandsRH Channel Get RH BMC Address Request Response This page intentionally left blank High Availability CompactPCI Device Drivers Device Driver DesignQuiesced Device Driver StatesInitialization ActivationDevice Adding High-Availability FunctionalityFind RemovedAdd Device Resume OperationsRemove Device Suspend OperationsDriver Synchronization Summary Intel-Specific APIs RhGetHwDestinationHostAndResetRedundant Host API RhSetHostNameHsistatussuccess Redundant Host PICMG* 2.12 APIsRedundant Host API HsistatusinvalidparameterDefinitions and Types Following topics specify each of the interface functionsMinoralarm Majoralarm Criticalalarm Rhalarmseverity RESETREQUIRED, Resetnotrequired Unknown Rhslotneedsreset Hsistatusno Datadetected Initialization/TerminationRhEnumerateInstances HsistatusinsufficientbufferInstanceId RhOpenRhOpen Char *InstanceId Optional OUT Rhhandle *pHandle RhEnumerateInstancesRhClose in Rhhandle Handle RhCloseRhGetInstanceID HandleRhGetDomainCount Handle Handle of the current session PInstanceIDDomain and Host Information API RhGetDomainCount Rhhandle Handle OUT uint32 *pCountHandle Handle of the current session PCount RhGetDomainNumbersSystem RhGetDomainOwnership RhGetDomainSlotPathCharacter Domain is written as a null-terminated stringSlotPathLength HSISTATUSINSUFFICIENTBUFFER, this is the minimumRhGetDomainSlots RhGetDomainSlotCountIs placed RhGetSlotDomain RhGetHostCount RhGetCurrentHostNumberRhGetCurrentHostNumber Rhhandle Handle OUT uint32 *pHost RhGetHostCount Rhhandle Handle OUT uint32 *pHostCount RhGetHostNumbersHandle Handle of the current session PHostCount RhGetHostName RhSetHostAvailability FalseRhGetHostAvailability RhGetDomainAvailabilityToHost Slot Information APIRhGetPhysicalSlotInformation Rhslotdescriptor HsinosuchdeviceIf the specified slot is empty Devices directly placed in the physical slots+ FunctionNumber for the corresponding PCI-PCI bridge RhGetSlotChildInformationSlotPath By two characters from the set ‘0’..’9’, ‘A’..’F’Handle Handle of the current session PhysSlot If there are no child devices below the specified bridgePCI buses in the system Switchover API Switchover Scenarios and Theory of OperationPartially Cooperative Switchover RhPrepareForSwitchover Hostile SwitchoverHsistatusrequestdenied RhCancelPrepareForSwitchover Hsistatussuccess returned in the case of successRhGetDomainSwConnectionStatus RhGetSlotSwConnectionStatus RhPerformSwitchoverInvalid session handle or the specified slot does not exist Value Rhnodestinationhost means no host should own RhSetHwDestinationHostHandle Handle of the current session DestinationHost Specified domainsRhnodestinationhost means no host owns the domains RhEnableDomainStateNotification Notification, Reporting and AlarmsRhGetHwDestinationHost Disconnecting RhEnableSwitchoverNotificationDuring software connection and disconnection RhEnableSwitchoverRequestNotification Switchovers in which it participatesRhEnableUnsafeSwitchoverNotification Device in unsafe state Indicates is the depth of the device below the physical slotRhDisableNotification Handle Handle of the current session NotificationType Hot Swap API Hot Swap API ImbCloseDriver ImbOpenDriverImbDeviceIoControl Dword ImbSendTimedI2cRequestLpvoid LpdwordImbGetAsyncMessage ImbSendIpmiRequestAccesnstatus ImbUnregisterForAsyncMsgNotification ImbIsAsyncMessageAvailableImbRegisterForAsyncMsgNotification EventId EventID handle returned once registeredImbGetLocalBmcAddr ImbSetLocalBmcAddrByte ImbGetIpmiVersionByte imbGetIpmiVersion Current determined Ipmi versionHsiCloseSlotControl Slot Control APIHsiOpenSlotControl HsistatusnomemoryHsiGetBoardPresent HsiGetSlotCountSlot Control API HsiGetBoardHealthy HsistatusnodatadetectedHsiGetSlotPower HealthyHsiSetSlotPower HsiGetSlotResetHsistatusnotimplemented HsiSetSlotResetSlot Physical slot number False 66 MHz operation is not enabled for the slot HsiGetSlotM66EnableHsiapidef Hsistatus HsiSetSlotM66Enable Function HsiSetSlotEventCallbackHandle Handle of the current session Callback Returned if the arguments or handle is invalidHsisloteventinfostruct Void *HSISLOTEVENTCALLBACKHsisloteventinfo User Interface Demonstration UtilitiesFunctional Description RH InterfaceHardware Initiated Failovers Multiple Mode CapabilitiesSoftware Initiated Handovers Demonstration UtilitiesHost Domain Enumeration and Association Switchover FunctionsNotification, Reporting and Alarms Slot InformationIpmi Interface Fault ConfigurationIsolation Strategy Hot Swap Interface HS Functional DescriptionSlot Information Structure PCI Tree Information Retrieval FlagsSlot Control Interface Slot StateDemonstration Utilities Installing the Redundant Host Software Kit Software InstallationLinux Patching and Rebuilding an RH-Enabled Kernel Installing RH Source RPMSource Installation Software Installation1 /lib/modules/priBptd.o Configuring the Redundant Host InfrastructureMaking RH Configuration Changes 2 /lib/modules/slotcntrl.o3 /CompactPCI-RH-1.0/app/lib VxWorks Tornado II Setup4 /CompactPCI-RH-1.0/app/bin RedundantHostFunctionReturnValuesB Redundant Host Function Return Values Hsistatusnosuchbridge HsistatusnosysrhtablefoundHsistatusobjectdoesnotexist HsistatusnotavailibleHsistatusnotready HsistatusoperationabortedHsistatusunsupportedplatform HsistatusunabletosendpacketHsistatusunsuccessfultranslation HsistatusuptinsertionfailedThis page intentionally left blank HSK Device Driver Interface for VxWorks HSK Driver Object DeclarationHSK Device Information Structure HSK Device Driver Interface for VxWorksHSK Driver Instantiation Code Segment CompatlistcheckdeviceRedundant Host-Aware Callback Definitions Prhdeviceobj AddDevicePrhdeviceobj deviceobject Hsistatus StartDeviceHsistatus StopDevice Hsistatussuccess if successful otherwise HsistatusfailureHsistatus RemoveDevice Hsistatus SurpriseRemovalRH-Aware Message Registration Definitions Hsistatus rhHskRegisterMsgCallbackInt rhHskUnregisterMsgCallback Process Packet Callback DefinitionPcilocation pci UINT8* pBuf, int iLen, Pvoid pContext RH-Aware Send Message DefinitionHsistatus rhHskSendMessage Length in bytes of the data packet being sentAlternate Hscsr Interfaces PPackettRH Device Driver Interface for Linux RH Device Driver Interface for Linux Bus Mastering DMA Capable Peripheral Design Guideline for Peripheral VendorsENon Bus Mastering Peripheral Support for Unmodified Standard DriversDesign Guideline for Peripheral Vendors Porting ZT 5550 HA Applications to Picmg Category ZT 5550 Functions Redundant Host FunctionsUting Porting ZT 5550 HA Applications to PicmgHAGetEthernetRo HASetEthernetRouRH Switchover on OS Crash RH Switchover on OS Crash User Documentation VxWorks Data Sheet ReferenceCompactPCI Wind River* VxWorks Programmer’s Guide is available atData Sheet Reference Index ImpiIpmi API Page This page intentionally left blank