Manuals / Intel / Computer Equipment / Network Router

Intel ZT 4901 Switchover Functions, Host Domain Enumeration and Association, Slot Information

Models: ZT 4901

1 136

Download 136 pages 35.65 Kb

Page 97

Demonstration Utilities

10.1.2.4Switchover Functions

The RHDemo exposes the following functionality:

•Prepare for Switchover

•Cancel Prepare for Switchover

•Get Domain Software Connection Status

•Get Slot Software Connection Status

•Perform Switchover

•Set Hardware Concession Host

•Get Hardware Concession Host

10.1.2.5Host Domain Enumeration and Association

The RHDemo enumerates hosts and domains, reports host-domain associations and returns useful data on the domains, hosts and slots. It covers the following functions:

•Get Domain Count

•Get Domain Numbers

•Get Domain Ownership

•Get Domain Slot Path

•Get Domain Slot Count

•Get Domain Slots

•Get Slot Domain

•Get Current Host Number

•Get Host Count

•Get Host Numbers

•Get Host Name

•Get Host Availability

•Get Domain Availability to Host

10.1.2.6Slot Information

The RHDemo returns the following device information on the system slots:

•Physical slot information

•Slot Child Information

10.1.2.7Notification, Reporting and Alarms

The RHDemo reports the following switchover notifications, alarms and other events:

•Enable Domain State Notification

•Enable Switchover Notification

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

97

Image 97

Intel ZT 4901 manual Switchover Functions, Host Domain Enumeration and Association, Slot Information

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 Host Application Software ServiceabilityGoals of the Host Application PortabilityHost Application Software Division of LaborDevelopment Issues Hardened Applications Graceful SwitchoverCode Modularity Redundant Host API System ManagementIpmi API Baseboard Management Controller Firmware Enhancements Fault ConfigurationHot Swap API Slot Control 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 DriversInitialization Device Driver StatesQuiesced ActivationFind Adding High-Availability FunctionalityDevice RemovedResume Operations Add DeviceRemove Device Suspend OperationsDriver Synchronization Summary Redundant Host API RhGetHwDestinationHostAndResetIntel-Specific APIs RhSetHostNameRedundant Host API Redundant Host PICMG* 2.12 APIsHsistatussuccess HsistatusinvalidparameterFollowing topics specify each of the interface functions Definitions and TypesMinoralarm Majoralarm Criticalalarm Rhalarmseverity RESETREQUIRED, Resetnotrequired Unknown Rhslotneedsreset RhEnumerateInstances Initialization/TerminationHsistatusno Datadetected HsistatusinsufficientbufferRhOpen Char *InstanceId Optional OUT Rhhandle *pHandle RhOpenInstanceId RhEnumerateInstancesRhGetInstanceID RhCloseRhClose in Rhhandle Handle HandleDomain and Host Information API Handle Handle of the current session PInstanceIDRhGetDomainCount RhGetDomainCount Rhhandle Handle OUT uint32 *pCountHandle Handle of the current session PCount RhGetDomainNumbersSystem RhGetDomainSlotPath RhGetDomainOwnershipSlotPathLength Domain is written as a null-terminated stringCharacter 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 False RhSetHostAvailabilityRhGetHostAvailability RhGetDomainAvailabilityToHost Slot Information APIRhGetPhysicalSlotInformation If the specified slot is empty HsinosuchdeviceRhslotdescriptor Devices directly placed in the physical slotsSlotPath RhGetSlotChildInformation+ FunctionNumber for the corresponding PCI-PCI bridge By two characters from the set ‘0’..’9’, ‘A’..’F’If 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 Handle Handle of the current session DestinationHost RhSetHwDestinationHostValue Rhnodestinationhost means no host should own Specified domainsRhnodestinationhost 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 Lpvoid ImbSendTimedI2cRequestDword LpdwordImbGetAsyncMessage ImbSendIpmiRequestAccesnstatus ImbRegisterForAsyncMsgNotification ImbIsAsyncMessageAvailableImbUnregisterForAsyncMsgNotification EventId EventID handle returned once registeredImbSetLocalBmcAddr ImbGetLocalBmcAddrByte imbGetIpmiVersion ImbGetIpmiVersionByte Current determined Ipmi versionHsiOpenSlotControl Slot Control APIHsiCloseSlotControl HsistatusnomemoryHsiGetBoardPresent HsiGetSlotCountSlot Control API Hsistatusnodatadetected HsiGetBoardHealthyHealthy HsiGetSlotPowerHsiGetSlotReset HsiSetSlotPowerHsistatusnotimplemented HsiSetSlotResetSlot Physical slot number False 66 MHz operation is not enabled for the slot HsiGetSlotM66EnableHsiapidef Hsistatus HsiSetSlotM66Enable Handle Handle of the current session Callback HsiSetSlotEventCallbackFunction Returned if the arguments or handle is invalidHsisloteventinfostruct Void *HSISLOTEVENTCALLBACKHsisloteventinfo Functional Description Demonstration UtilitiesUser Interface RH InterfaceSoftware Initiated Handovers Multiple Mode CapabilitiesHardware Initiated Failovers Demonstration UtilitiesNotification, Reporting and Alarms Switchover FunctionsHost Domain Enumeration and Association Slot InformationIpmi 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 Source Installation Installing RH Source RPMPatching and Rebuilding an RH-Enabled Kernel Software InstallationMaking RH Configuration Changes Configuring the Redundant Host Infrastructure1 /lib/modules/priBptd.o 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 Hsistatusnosysrhtablefound HsistatusnosuchbridgeHsistatusnotready HsistatusnotavailibleHsistatusobjectdoesnotexist HsistatusoperationabortedHsistatusunsuccessfultranslation HsistatusunabletosendpacketHsistatusunsupportedplatform HsistatusuptinsertionfailedThis 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 DefinitionsHsistatus StopDevice Hsistatus StartDevicePrhdeviceobj deviceobject Hsistatussuccess if successful otherwise HsistatusfailureHsistatus SurpriseRemoval Hsistatus RemoveDeviceHsistatus rhHskRegisterMsgCallback RH-Aware Message Registration DefinitionsInt rhHskUnregisterMsgCallback Process Packet Callback DefinitionPcilocation pci Hsistatus rhHskSendMessage RH-Aware Send Message DefinitionUINT8* pBuf, int iLen, Pvoid pContext Length in bytes of the data packet being sentPPackett Alternate Hscsr InterfacesRH Device Driver Interface for Linux RH Device Driver Interface for Linux Non Bus Mastering Peripheral Design Guideline for Peripheral VendorsEBus Mastering DMA Capable Peripheral Support for Unmodified Standard DriversDesign Guideline for Peripheral Vendors Category ZT 5550 Functions Redundant Host Functions Porting ZT 5550 HA Applications to PicmgHAGetEthernetRo Porting ZT 5550 HA Applications to PicmgUting HASetEthernetRouRH Switchover on OS Crash RH Switchover on OS Crash CompactPCI Data Sheet ReferenceUser Documentation VxWorks Wind River* VxWorks Programmer’s Guide is available atData Sheet Reference Impi IndexIpmi API Page This page intentionally left blank