Page 3 - Contents
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 3 Contents Contents 1 Document Organization ................................................................................................................ 9 2 Introduction...............................
Page 6 - Figures
6 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification Contents Figures 1 High-Availability CPU Architecture ............................................................................................. 11 2 RSS Processor Board Block Diagram ...............
Page 7 - Revision History
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 7 Contents Revision History Date Revision Description April 2003 002 Removed three demonstration utilities from 10.1.2.7 and removed Interhost Communication section. January 2003 001 Initial release of...
Page 8 - This page intentionally left blank.
8 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification Contents This page intentionally left blank.
Page 9 - Document Organization
Intel ® NetStructure TM ZT 4901 High Availability Software Technical Product Specification 9 Document Organization 1 This document describes the High Availability Software Development Kit for the Intel ® NetStructure™ ZT 4901 I/O Mezzanine Card. Following is a summary of the contents. Chapter 2, “In...
Page 11 - Introduction; Terminology
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 11 Introduction 2 Intel ® High Availability (HA) systems feature built-in redundancy for active system components such as power supplies, system master processor boards, and system alarms. Redundant Ho...
Page 14 - High Availability Hardware Approach
14 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification Introduction Split Mode—Split Mode is a term that refers to a system operating with multiple system master Host boards that each own a single bus segment. Split Mode may refer to either Active/Activ...
Page 15 - Processor Boards
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 15 Introduction Intel’s RH software runs on system master processor boards with bridge mezzanine cards in a PICMG 2.13 compliant RSS backplane to provide redundant system master functionality. This all...
Page 16 - Bridge Mezzanine
16 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification Introduction 2.2.2 Bridge Mezzanine The HASDK driver set works in single and dual bus segment configurations. In order for the dual bus configuration to be supported a bridge mezzanine must be mount...
Page 17 - Backplane
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 17 Introduction 2.2.3 Backplane The RSS system backplane supports two CompactPCI buses accessible by both Redundant Hosts. In Active-Standby mode, the active processor board controls the buses (Active ...
Page 18 - High-Availability Software Approach; Host Application
18 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification Introduction 2.3 High-Availability Software Approach As shown in the Figure 1, “High-Availability CPU Architecture” on page 11 , there are three High- Availability software components: • Host applic...
Page 19 - System Management
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 19 Introduction The design of the application should be made as portable as possible. This requires that the design be implemented in a modular approach that isolates the system management requirements...
Page 20 - Backplane Device Drivers
20 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification Introduction 2.3.3 Backplane Device Drivers Backplane device drivers are a critical component of High Availability system. The drivers need to be robust in their operations as well as to be dynamic ...
Page 21 - Host Application Software; Goals of the Host Application; Serviceability; Redundancy
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 21 Host Application Software 3 Through thoughtful design and the use of a layered development approach, an application can be developed that meets the implied robustness of a highly available system an...
Page 22 - Division of Labor
22 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification Host Application Software System Host in the same chassis. In order for a host application to be capable of maintaining the system’s serviceability, these redundant applications should maintain some...
Page 23 - Development Issues
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 23 Host Application Software The diagram shows that the host application’s need to understand the particular implementation aspects of the platform’s system management is reduced by placing an intermed...
Page 24 - Graceful Switchover; Hardened Applications
24 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification Host Application Software 3.3.2 Graceful Switchover In a Redundant Host environment a graceful switchover is only secondary in importance to data integrity. An effective mechanism is required in ord...
Page 25 - Redundant Host API; IPMI API
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 25 System Management 4 System Management is an all-encompassing term whose definition can vary drastically depending on the type of system that is being developed. System Management can indicate anythi...
Page 26 - Hot Swap API; Slot Control API; Fault Configuration
26 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification System Management The next-generation, high-availability architecture provides this system management infrastructure using IPMI. Through the IPMI API the developer is able to access the status of in...
Page 27 - Isolation Strategies
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 27 System Management • Upper/Lower critical threshold • Upper/Lower non-recoverable threshold Each range can be set independently for each sensor and the ranges can overlap. This area of configuration ...
Page 28 - IPMI RH Channel Commands; RH Channel Enabled; RH Channel Get RH BMC Address
28 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification System Management The RH channel acts as a virtual channel that can respond to Alert Actions. This channel supports IPMI commands like Alert Immediate: • In the Alert Policy Table: Create an entry w...
Page 31 - Device Driver Design
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 31 High Availability CompactPCI Device Drivers 5 This chapter describes the characteristics of highly available software drivers for CompactPCI peripherals in a Redundant Host environment. To fully uti...
Page 32 - Device Driver States; Initialization
32 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification High Availability CompactPCI Device Drivers 5.1.1 Device Driver States There are varying degrees of functionality that are dependent on power modes, operating system Hot Swap implementations, and de...
Page 33 - Adding High-Availability Functionality
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 33 High Availability CompactPCI Device Drivers 5.1.2 Adding High-Availability Functionality Operating in a Redundant Host architecture places additional responsibilities on device drivers beyond those ...
Page 34 - Add Device; Resume Operations
34 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification High Availability CompactPCI Device Drivers • Add Device • Resume Operations • Suspend Operations • Remove Device 5.1.2.1 Add Device Add Device is the device driver call made by the Hot Swap Manager...
Page 35 - Suspend Operations
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 35 High Availability CompactPCI Device Drivers 5.1.2.3 Suspend Operations The counterpart to the Resume Operation callback is the Suspend Operation. The kernel calls the Suspend Operation callback func...
Page 36 - Summary
36 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification High Availability CompactPCI Device Drivers 5.2 Summary The intent of the HA CompactPCI device driver model is to leverage the native device driver infrastructure to supply a robust Hot Swap capabil...
Page 37 - RhSetHostName; RhGetHwDestinationHostAndReset
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 37 Redundant Host API 6 6.1 Intel-Specific APIs 6.1.1 RhSetHostName Prototype: RH_API_DEF HSI_STATUSRhSetHostName( IN RH_HANDLE Handle, IN uint32 Host, IN char HostName[ ]) Arguments: Handle - The hand...
Page 39 - Definitions and Types
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 39 Redundant Host API The following topics specify each of the interface functions. 6.2.1 Definitions and Types The following definitions are provided for terms used in the remaining topics of this cha...
Page 42 - Initialization/Termination; RhEnumerateInstances
42 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification Redundant Host API typedef void * RH_HANDLE; 6.2.2 Initialization/Termination 6.2.2.1 RhEnumerateInstances Prototype: HSI_STATUS RhEnumerateInstances( OUT char *pInstanceID,IN uint32 InstanceIDLengt...
Page 43 - RhOpen
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 43 Redundant Host API An RH infrastructure that implements this function shall return the list of RH Instance IDs only for those RH Systems that it services. If multiple RH infrastructures are present ...
Page 44 - RhClose
44 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification Redundant Host API The current host may be attached to several RH systems. In that case, the parameter Instance ID should be used to specify the RH system that the application wants to work with. Sp...
Page 45 - Domain and Host Information API; RhGetDomainCount
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 45 Redundant Host API Arguments: Handle – the handle of the current session pInstanceID – pointer to the character buffer where the RH Instance ID associated with the given handle is stored as a null-t...
Page 46 - RhGetDomainNumbers
46 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification Redundant Host API Handle – the handle of the current session pCount – pointer to the variable that receives the current number of domains in the system Return Value: HSI_STATUS_SUCCESS returned in ...
Page 47 - RhGetDomainOwnership
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 47 Redundant Host API Other, implementation-defined HSI_STATUS values returned if other errors occurred during execution of this function Synopsis: This function retrieves the list of numbers of known ...
Page 49 - RhGetDomainSlotCount
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 49 Redundant Host API The slot path is stored as a null-terminated sequence of two-character groups. Each group describes one item of the slot path and represents the number (DeviceNumber * 8 + Functio...
Page 50 - RhGetSlotDomain
50 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification Redundant Host API Domain the domain number pSlotNumbersArray pointer to the array where the list of slot numbers for the specified domain is placed ArraySize the size (in items of type PHYSICAL_SLO...
Page 51 - RhGetCurrentHostNumber
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 51 Redundant Host API PhysSlot the physical slot number (represented as combination of Shelf ID and Slot ID) pDomain pointer to the variable where the number of the domain is placed Return Value: HSI_S...
Page 52 - RhGetHostNumbers
52 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification Redundant Host API HSI_STATUS RhGetHostCount( IN RH_HANDLE Handle, OUT uint32 *pHostCount); Arguments: Handle the handle of the current session pHostCount pointer to the variable where the host coun...
Page 53 - RhGetHostName
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 53 Redundant Host API HSI_STATUS_INSUFFICIENT_BUFFER returned if the buffer provided for the array by the caller is too small; in that case, the array isn’t filled in but the location pointed by pActua...
Page 54 - RhSetHostAvailability
54 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification Redundant Host API HSI_STATUS_INSUFFICIENT_BUFFER returned if the buffer OutHostName is too small to store the host name HSI_STATUS_NOT_SUPPORTED returned if this function is not supported by the in...
Page 55 - RhGetHostAvailability
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 55 Redundant Host API returns FALSE. This mode can be used for configuration purposes, for example, to update system software on the host. Setting the status to TRUE brings the host back from the isola...
Page 56 - RhGetDomainAvailabilityToHost; Slot Information API; RhGetPhysicalSlotInformation
56 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification Redundant Host API 6.2.3.14 RhGetDomainAvailabilityToHost Prototype: HSI_STATUS RhGetDomainAvailabilityToHost( IN RH_HANDLE Handle, IN uint32 Host, IN uint32 Domain, OUT BOOLEAN *pAvailable); Argume...
Page 58 - RhGetSlotChildInformation
58 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification Redundant Host API SlotPath The slot path from the root bus to the device. The slot path is stored as a null-terminated sequence of two-character groups. Each group describes one item of the slot pa...
Page 61 - Switchover API; Switchover Scenarios and Theory of Operation
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 61 Redundant Host API This function can be used to enumerate devices nested below physical slots if a PCI-PCI bridge occupies the physical slot. To get information about all devices at the next nesting...
Page 63 - RhPrepareForSwitchover
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 63 Redundant Host API Hence, forced switchover is potentially destructive for the owning host and should be used with care. To perform forced switchover, it is sufficient to call the RhPerformSwitchove...
Page 65 - RhCancelPrepareForSwitchover
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 65 Redundant Host API This function just initiates the software disconnection and does not wait for its completion. The function RhGetDomainSwConnectionStatus can be used to track the progress of the p...
Page 66 - RhGetDomainSwConnectionStatus
66 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification Redundant Host API Synopsis: This function requests domain software connection. It initiates software connection for the specified domains: • Startup of all devices in the domain • Creation of corre...
Page 67 - RhGetSlotSwConnectionStatus
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 67 Redundant Host API Get domain software connection status. This function returns the current state of the specified domain with respect to software connection/disconnection. There exist two stable (D...
Page 68 - RhSetHwDestinationHost
68 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification Redundant Host API HSI_STATUS RhPerformSwitchover( IN RH_HANDLE Handle, IN uint32 DestinationHost, IN uint32 *pDomains, IN uint32 DomainCount, IN BOOLEAN Reset, IN BOOLEAN Hostile ); Arguments: Hand...
Page 70 - RhGetHwDestinationHost; Notification, Reporting and Alarms; RhEnableDomainStateNotification
70 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification Redundant Host API 6.2.5.8 RhGetHwDestinationHost Prototype: HSI_STATUS RhGetHwDestinationHost( IN RH_HANDLE Handle, IN uint32 SourceHost, IN uint32 Domain, OUT uint32 *pDestinationHost ); Arguments...
Page 71 - RhEnableSwitchoverNotification
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 71 Redundant Host API DomainCallback pointer to the callback function that tracks state of the domain SlotCallback - pointer to the optional callback function that tracks state of separate slots during...
Page 72 - RhEnableSwitchoverRequestNotification
72 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification Redundant Host API Callback – pointer to the callback function Context – an opaque context pointer; passed unchanged to the callback function. Systemwide – a Boolean flag; if set to TRUE, notificati...
Page 73 - RhEnableUnsafeSwitchoverNotification
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 73 Redundant Host API Other, implementation-defined HSI_STATUS values returned if other errors occurred during execution of this function Synopsis: This function establishes the callback that is called...
Page 75 - RhDisableNotification
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 75 Redundant Host API SlotPath - the slot path from the root bus to the device; represented as a null-terminated character string BusNumber - the bus number for the device. This value is 16 bit to acco...
Page 79 - imbOpenDriver
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 79 IPMI API 8 8.1 imbOpenDriver Prototype: int imbOpenDriver(void) Parameters: None Returns: Int - 0 for Fail and 1 for Success, sets hDevice Description: Establish a link to the IMB driver. 8.2 imbClo...
Page 80 - imbSendTimedI2cRequest
80 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification IPMI API LPVOID lpvOutBuffer, DWORD cbOutBuffer, LPDWORD lpcbBytesReturned, LPOVERLAPPEDlpoOverlapped ) Parameters: dummy_hDevice - handle of device dwIoControlCode - control code of operation to pe...
Page 81 - imbSendIpmiRequest
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 81 IPMI API ACCESN_STATUS - ACCESN_OK else error status code Description: Sends a request to an I 2 C device 8.5 imbSendIpmiRequest Prototype: ACCESN_STATUS imbSendIpmiRequest ( IMBPREQUESTDATA *pImbRe...
Page 82 - imbIsAsyncMessageAvailable; imbRegisterForAsyncMsgNotification; imbUnregisterForAsyncMsgNotification
82 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification IPMI API Returns: ACCESN_STATUS - ACCESN_OK else error status code Description: This function gets the next available async message with a message ID greater than SeqNo. The message looks like an IM...
Page 83 - imbGetLocalBmcAddr
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 83 IPMI API ACCESN_STATUS imbUnregisterForAsyncMsgNotification (unsigned int *handleId) Parameters: eventId - EventID handle to unregister Returns: ACCESN_STATUS - ACCESN_OK else error status code Desc...
Page 84 - imbGetIpmiVersion
84 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification IPMI API 8.12 imbGetIpmiVersion Prototype: BYTE imbGetIpmiVersion() Parameters: None Returns: BYTE - Current determined IPMI version Description: This function is returns the current IPMI version as...
Page 85 - HsiOpenSlotControl; HsiCloseSlotControl
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 85 Slot Control API 9 9.1 HsiOpenSlotControl Prototype: HSI_STATUS HsiOpenSlotControl( OUT HSI_SLOT_CONTROL_HANDLE *pHandle); Arguments: PHandle - pointer to the location where this function places the...
Page 86 - HsiGetSlotCount
86 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification Slot Control API Return Value: HSI_STATUS_SUCCESS if successful HSI_STATUS_INVALID_PARAMETER returned if the handle passed as a parameter is invalid Other HSI_STATUS values returned if other errors ...
Page 87 - HsiGetBoardHealthy
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 87 Slot Control API HSI_STATUS HsiGetBoardPresent( IN HSI_SLOT_CONTROL_HANDLE Handle, IN UINT32 Slot, OUT BOOLEAN *pPresent ) Arguments: Handle - The handle of the current session Slot - The physical s...
Page 88 - HsiGetSlotPower
88 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification Slot Control API Slot - The physical slot number pHealthy - Pointer to the location where the board health status is placed: TRUE means the board is present and healthy; FALSE means the board is not...
Page 89 - HsiSetSlotPower
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 89 Slot Control API HSI_STATUS_INVALID_PARAMETER returned if the physical slot number does not correspond to any actual slot or if the handle is invalid Other HSI_STATUS values returned if other errors...
Page 90 - HsiSetSlotReset
90 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification Slot Control API HSI_STATUS HsiGetSlotReset( IN HSI_SLOT_CONTROL_HANDLE Handle, IN UINT32 Slot, OUT BOOLEAN *pReset ); Arguments: Handle - The handle of the current session Slot - The physical slot ...
Page 91 - HsiGetSlotM66Enable
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 91 Slot Control API Reset - The new reset state for the slot: TRUE means the slot is placed in the reset state; FALSE means the slot is taken out of the reset state Return Value: HSI_STATUS_SUCCESS if ...
Page 92 - HsiSetSlotM66Enable
92 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification Slot Control API HSI_STATUS_INVALID_PARAMETER returned if the physical slot number does not correspond to any actual slot or if the handle is invalid Other HSI_STATUS values returned if other errors...
Page 93 - HsiSetSlotEventCallback
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 93 Slot Control API This function controls the state of the M66EN signal line for the specified slot (reflecting whether or not 66 MHz operation is enabled for the specified slot), depending on the val...
Page 95 - Demonstration Utilities; Functional Description; User Interface
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 95 Demonstration Utilities 10 The purpose of the demonstration utility is to demonstrate and expose the main functionality and features of the HSSDK driver set, the Application Programming Interface (A...
Page 96 - Software Initiated Handovers
96 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification Demonstration Utilities • Cluster A Standby Host is a host that does not control a bus domain. A Standby Host is referred to as being in Standby mode. An Active Host is a host that owns at least one...
Page 97 - Switchover Functions
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 97 Demonstration Utilities 10.1.2.4 Switchover Functions The RHDemo exposes the following functionality: • Prepare for Switchover • Cancel Prepare for Switchover • Get Domain Software Connection Status...
Page 98 - IPMI Interface
98 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification Demonstration Utilities • Enable Switchover Request Notification • Enable Unsafe Switchover Notification • Disable Notification 10.1.3 IPMI Interface The IPMI interface is an important element of th...
Page 99 - Hot Swap Interface; HS Functional Description
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 99 Demonstration Utilities 10.1.4 Hot Swap Interface The basic purpose of the CompactPCI hot swap functionality is to allow orderly insertion or extraction of CompactPCI boards without affecting operat...
Page 100 - Slot Information Structure
100 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification Demonstration Utilities The following information is displayed: • Slot path • Vendor ID • Device ID • SubsystemVendor ID • SubsystemDevice ID • Class code D • Sub class code • Programming interface...
Page 101 - Slot State; Slot Control Interface
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 101 Demonstration Utilities • Slot state flags If the slot is not empty, the following fields are also present: • Vendor ID • Device ID • Subsystem vendor ID • Subsystem ID • Revision ID • Class, subcl...
Page 103 - Software Installation; Linux; Installing the Redundant Host Software Kit
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 103 Software Installation Software Installation A A.1 Linux The Redundant Host software package in Linux is broken out into two RPM packages. To achieve full Hot Swap Redundant Host capability, both pa...
Page 104 - Installing RH Source RPM; Source Installation; Patching and Rebuilding an RH-Enabled Kernel
104 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification Software Installation 2. Patch and rebuild the kernel with Redundant Host Support, then copy this kernel image to the / usr/src/redhat/BUILD/CompactPCI-RH-1.0/kernel_patches directory as “linux-<...
Page 105 - Making RH Configuration Changes; Configuring the Redundant Host Infrastructure
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 105 Software Installation CONFIG_RH options also must be enabled. The Redundant Host Software is dependant on both the Hot Swap support and IPMI drivers to be enabled. bash# make dep bash# make install...
Page 107 - Redundant Host Function Return Values B
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 107 Redundant Host Function Return Values B HSI_STATUS_SUCCESS The specified operation completed successfully. HSI_STATUS_BUS_NOT_FOUND The operation failed because the required bus was not found. HSI_...
Page 113 - HSK Driver Object Declaration
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 113 HSK Device Driver Interface for VxWorks* 5.4 C The knowledge required to recompile the VxWorks kernel, as well as understand how the HSK device driver integrates with VxWorks, requires a high degre...
Page 114 - HSK Device Information Structure
114 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification HSK Device Driver Interface for VxWorks* 5.4 struct _RH_HSK_DRV_OBJ { CB_RH_ADD_DEVICE AddDevice; CB_RH_PNP StartDevice; CB_RH_PNP StopDevice; CB_RH_PNP RemoveDevice; CB_RH_PNP SurpriseRemoval; PRH...
Page 115 - HSK Driver Instantiation Code Segment
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 115 HSK Device Driver Interface for VxWorks* 5.4 UINT8 BaseClass; UINT16 SubVendorID; UINT16 SubSystemID; } RH_COMPAT_DEVICE, *PRH_COMPAT_DEVICE; C.3 HSK Driver Instantiation Code Segment The following...
Page 116 - Redundant Host-Aware Callback Definitions
116 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification HSK Device Driver Interface for VxWorks* 5.4 A driver can have itself removed from the HSK Manager’s registry by calling the rhHskUnregisterDriver routine. Use the RH driver object as an input para...
Page 117 - HSI_STATUS StartDevice; HSI_STATUS StopDevice
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 117 HSK Device Driver Interface for VxWorks* 5.4 C.4.2 HSI_STATUS StartDevice StartDevice is called for a device driver to commence or resume activity with its associated device. Before this callback i...
Page 118 - HSI_STATUS RemoveDevice; HSI_STATUS SurpriseRemoval
118 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification HSK Device Driver Interface for VxWorks* 5.4 Pointer to a device object. This data is a device context allowing the device driver to identify the specific device whose state is changing to stopped....
Page 119 - RH-Aware Message Registration Definitions; HSI_STATUS rhHskRegisterMsgCallback
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 119 HSK Device Driver Interface for VxWorks* 5.4 Syntax ( PRH_DEVICE_OBJ deviceobject ) Parameters deviceobject Pointer to a device object. This data is a device context allowing the device driver to i...
Page 120 - int rhHskUnregisterMsgCallback; Process Packet Callback Definition
120 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification HSK Device Driver Interface for VxWorks* 5.4 Parameters pci A PCI location structure. This structure contains the PCI bus, device, and function location of the device being associated with the mess...
Page 121 - RH-Aware Send Message Definition; HSI_STATUS rhHskSendMessage
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 121 HSK Device Driver Interface for VxWorks* 5.4 C.6.1 RH_HSK_RH_PROCESS_PACKET RH_HSK_RH_PROCESS_PACKET is called when a message packet is being redirected to a device driver for synchronization purpo...
Page 122 - Alternate HS_CSR Interfaces
122 High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification HSK Device Driver Interface for VxWorks* 5.4 pPackett Pointer to a data packet being sent to the specified device driver. It is the responsibility of the device driver to validate the packet conten...
Page 125 - Design Guideline for Peripheral VendorsE; Non Bus Mastering Peripheral
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 125 Design Guideline for Peripheral VendorsE The following topics present guidelines for designing a device driver for use in the Intel NetStructure Redundant Host environment. E.1 Non Bus Mastering Pe...
Page 129 - RH Switchover on OS Crash
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 129 RH Switchover on OS Crash G The High-Availability RH architecture enables the system master board to perform a switchover to the backup host in the event of a system crash. Under the Linux* operati...
Page 131 - Data Sheet Reference
High Availability Software for the Intel ® NetStructure TM ZT 4901 Technical Product Specification 131 Data Sheet Reference H H.1 CompactPCI Information about CompactPCI specifications is available from PICMG* (PCI Industrial Computers Manufacturers Group): https://www.picmg.org/compactpci.stm H.2 U...
Page 133 - Index; architecture
Intel ® NetStructure TM ZT 4901 High Availability Software Technical Product Specification 133 Index Aactivation 32API hot swap 26, 77IMPI 25redundant host 25, 37slot control 26, 85switchover 61 architecture high availability CPU 11 Bbackplane 17, 20baseboard management 26bridge mezzanine 16Cchannel...
Page 134 - API
134 Intel ® NetStructure TM ZT 4901 High Availability Software Technical Product Specification imbOpenDriver 79imbRegisterForAsyncMsgNotification 82imbSendIpmiRequest 81imbSendTimedI2cRequest 80imbSetLocalBmcAddr 83imbUnregisterForAsyncMsgNotification 82Initialization 32int rhHskUnregisterMsgCallbac...
Page 135 - HSK device driver 113
Intel ® NetStructure TM ZT 4901 High Availability Software Technical Product Specification 135 slot control API 26software 21 division of labor 22portability 21redundancy 21serviceability 21 switchover 24, 97, 129 forced 62fully cooperative 61hardware initiated 63hostile 63partially cooperative 62 s...