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