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