Manuals
/
Intel
/
Computer Equipment
/
Network Router
Intel
ZT 4901
manual
Demonstration Utilities
Models:
ZT 4901
1
102
136
136
Download
136 pages
35.65 Kb
99
100
101
102
103
104
105
106
Install
Data Sheet Reference
Disconnecting
Fault Configuration
Development Issues
RhGetHwDestinationHostAndReset
VxWorks Tornado II Setup
Ipmi RH Channel Commands
HsiGetSlotPower
Serviceability
Page 102
Image 102
Demonstration Utilities
102
High Availability Software for the Intel
®
NetStructure
TM
ZT 4901
Technical Product Specification
Page 101
Page 103
Page 102
Image 102
Page 101
Page 103
Contents
Technical Product Specification
Intel NetStructureTM ZT 4901 High Availability Software
Page
Contents
Hot Swap API
Demonstration Utilities
Figures
Tables
Revision History
Date Revision Description
This page intentionally left blank
Document Organization
Document Organization
Introduction
Terminology
Following terms are commonly used in this document
Introduction
Introduction
High Availability Hardware Approach
Processor Boards
PCI
CIC
RSS Processor Board Block Diagram
Bridge Mezzanine
RSS Host with Bridge Mezzanine Block Diagram
Backplane
High-Availability Software Approach
Host Application
Host application System Management Backplane Device Drivers
System Management
Backplane Device Drivers
Goals of the Host Application
Serviceability
Host Application Software
Portability
Division of Labor
Host Application Software
Development Issues
Graceful Switchover
Hardened Applications
Code Modularity
System Management
Redundant Host API
Ipmi API
Hot Swap API
Fault Configuration
Baseboard Management Controller Firmware Enhancements
Slot Control API
Isolation Strategies
Channel Definitions for ZT
Ipmi RH Channel Commands
RH Channel Enabled
RH Channel Get RH BMC Address
Request Response
This page intentionally left blank
High Availability CompactPCI Device Drivers
Device Driver Design
Quiesced
Device Driver States
Initialization
Activation
Device
Adding High-Availability Functionality
Find
Removed
Add Device
Resume Operations
Suspend Operations
Remove Device
Driver Synchronization
Summary
Intel-Specific APIs
RhGetHwDestinationHostAndReset
Redundant Host API
RhSetHostName
Hsistatussuccess
Redundant Host PICMG* 2.12 APIs
Redundant Host API
Hsistatusinvalidparameter
Definitions and Types
Following topics specify each of the interface functions
Minoralarm Majoralarm Criticalalarm Rhalarmseverity
RESETREQUIRED, Resetnotrequired Unknown Rhslotneedsreset
Hsistatusno Datadetected
Initialization/Termination
RhEnumerateInstances
Hsistatusinsufficientbuffer
InstanceId
RhOpen
RhOpen Char *InstanceId Optional OUT Rhhandle *pHandle
RhEnumerateInstances
RhClose in Rhhandle Handle
RhClose
RhGetInstanceID
Handle
RhGetDomainCount
Handle Handle of the current session PInstanceID
Domain and Host Information API
RhGetDomainCount Rhhandle Handle OUT uint32 *pCount
RhGetDomainNumbers
Handle Handle of the current session PCount
System
RhGetDomainOwnership
RhGetDomainSlotPath
Character
Domain is written as a null-terminated string
SlotPathLength
HSISTATUSINSUFFICIENTBUFFER, this is the minimum
RhGetDomainSlotCount
RhGetDomainSlots
Is placed
RhGetSlotDomain
RhGetCurrentHostNumber
RhGetHostCount
RhGetCurrentHostNumber Rhhandle Handle OUT uint32 *pHost
RhGetHostNumbers
RhGetHostCount Rhhandle Handle OUT uint32 *pHostCount
Handle Handle of the current session PHostCount
RhGetHostName
RhSetHostAvailability
False
RhGetHostAvailability
Slot Information API
RhGetDomainAvailabilityToHost
RhGetPhysicalSlotInformation
Rhslotdescriptor
Hsinosuchdevice
If the specified slot is empty
Devices directly placed in the physical slots
+ FunctionNumber for the corresponding PCI-PCI bridge
RhGetSlotChildInformation
SlotPath
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 bridge
PCI buses in the system
Switchover API
Switchover Scenarios and Theory of Operation
Partially Cooperative Switchover
RhPrepareForSwitchover
Hostile Switchover
Hsistatusrequestdenied
RhCancelPrepareForSwitchover
Hsistatussuccess returned in the case of success
RhGetDomainSwConnectionStatus
RhPerformSwitchover
RhGetSlotSwConnectionStatus
Invalid session handle or the specified slot does not exist
Value Rhnodestinationhost means no host should own
RhSetHwDestinationHost
Handle Handle of the current session DestinationHost
Specified domains
Rhnodestinationhost means no host owns the domains
Notification, Reporting and Alarms
RhEnableDomainStateNotification
RhGetHwDestinationHost
RhEnableSwitchoverNotification
Disconnecting
During software connection and disconnection
RhEnableSwitchoverRequestNotification
Switchovers in which it participates
RhEnableUnsafeSwitchoverNotification
Device in unsafe state
Indicates is the depth of the device below the physical slot
RhDisableNotification
Handle Handle of the current session NotificationType
Hot Swap API
Hot Swap API
ImbOpenDriver
ImbCloseDriver
ImbDeviceIoControl
Dword
ImbSendTimedI2cRequest
Lpvoid
Lpdword
ImbSendIpmiRequest
ImbGetAsyncMessage
Accesnstatus
ImbUnregisterForAsyncMsgNotification
ImbIsAsyncMessageAvailable
ImbRegisterForAsyncMsgNotification
EventId EventID handle returned once registered
ImbGetLocalBmcAddr
ImbSetLocalBmcAddr
Byte
ImbGetIpmiVersion
Byte imbGetIpmiVersion
Current determined Ipmi version
HsiCloseSlotControl
Slot Control API
HsiOpenSlotControl
Hsistatusnomemory
HsiGetSlotCount
HsiGetBoardPresent
Slot Control API
HsiGetBoardHealthy
Hsistatusnodatadetected
HsiGetSlotPower
Healthy
HsiSetSlotPower
HsiGetSlotReset
HsiSetSlotReset
Hsistatusnotimplemented
Slot Physical slot number
HsiGetSlotM66Enable
False 66 MHz operation is not enabled for the slot
Hsiapidef Hsistatus
HsiSetSlotM66Enable
Function
HsiSetSlotEventCallback
Handle Handle of the current session Callback
Returned if the arguments or handle is invalid
Void *HSISLOTEVENTCALLBACK
Hsisloteventinfostruct
Hsisloteventinfo
User Interface
Demonstration Utilities
Functional Description
RH Interface
Hardware Initiated Failovers
Multiple Mode Capabilities
Software Initiated Handovers
Demonstration Utilities
Host Domain Enumeration and Association
Switchover Functions
Notification, Reporting and Alarms
Slot Information
Fault Configuration
Ipmi Interface
Isolation Strategy
Hot Swap Interface
HS Functional Description
Slot Information Structure
PCI Tree Information Retrieval Flags
Slot Control Interface
Slot State
Demonstration Utilities
Software Installation
Installing the Redundant Host Software Kit
Linux
Patching and Rebuilding an RH-Enabled Kernel
Installing RH Source RPM
Source Installation
Software Installation
1 /lib/modules/priBptd.o
Configuring the Redundant Host Infrastructure
Making RH Configuration Changes
2 /lib/modules/slotcntrl.o
VxWorks Tornado II Setup
3 /CompactPCI-RH-1.0/app/lib
4 /CompactPCI-RH-1.0/app/bin
RedundantHostFunctionReturnValuesB
Redundant Host Function Return Values
Hsistatusnosuchbridge
Hsistatusnosysrhtablefound
Hsistatusobjectdoesnotexist
Hsistatusnotavailible
Hsistatusnotready
Hsistatusoperationaborted
Hsistatusunsupportedplatform
Hsistatusunabletosendpacket
Hsistatusunsuccessfultranslation
Hsistatusuptinsertionfailed
This page intentionally left blank
HSK Device Driver Interface for VxWorks
HSK Driver Object Declaration
HSK Device Information Structure
HSK Device Driver Interface for VxWorks
HSK Driver Instantiation Code Segment
Compatlistcheckdevice
Redundant Host-Aware Callback Definitions
Prhdeviceobj AddDevice
Prhdeviceobj deviceobject
Hsistatus StartDevice
Hsistatus StopDevice
Hsistatussuccess if successful otherwise Hsistatusfailure
Hsistatus RemoveDevice
Hsistatus SurpriseRemoval
RH-Aware Message Registration Definitions
Hsistatus rhHskRegisterMsgCallback
Process Packet Callback Definition
Int rhHskUnregisterMsgCallback
Pcilocation pci
UINT8* pBuf, int iLen, Pvoid pContext
RH-Aware Send Message Definition
Hsistatus rhHskSendMessage
Length in bytes of the data packet being sent
Alternate Hscsr Interfaces
PPackett
RH Device Driver Interface for Linux
RH Device Driver Interface for Linux
Bus Mastering DMA Capable Peripheral
Design Guideline for Peripheral VendorsE
Non Bus Mastering Peripheral
Support for Unmodified Standard Drivers
Design Guideline for Peripheral Vendors
Porting ZT 5550 HA Applications to Picmg
Category ZT 5550 Functions Redundant Host Functions
Uting
Porting ZT 5550 HA Applications to Picmg
HAGetEthernetRo
HASetEthernetRou
RH Switchover on OS Crash
RH Switchover on OS Crash
User Documentation VxWorks
Data Sheet Reference
CompactPCI
Wind River* VxWorks Programmer’s Guide is available at
Data Sheet Reference
Index
Impi
Ipmi API
Page
This page intentionally left blank
Top
Page
Image
Contents