Instruction/ maintenance manual of the product ZT 4901 Intel
Go to page of 136
Intel ® NetS tructure TM ZT 4901 High A vailability Software Technical Product Specification April 20 03 Order N umber: 273856-00 2.
2 High Avail ability Software f or the Inte l ® NetStructu re TM ZT 4901 Tec hnical Product Specification INFORMA TION I N THIS DOCUMENT IS PRO VIDED IN CONNE CTION WITH INTEL ® PRODUCTS. NO LICENSE, EXPRESS O R IMPLIED, BY ESTOPPEL O R OTHERWI SE, TO ANY INTELLECTUAL PROP ER TY RIGHTS IS GRANTED BY THIS DOCUMENT .
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 3 Contents Contents 1 Document Organ i zation ................ ............. ................... ................... ............. .................
4 High Avail ability Software f or the Inte l ® NetStructu re TM ZT 4901 Tec hnical Product Specification Contents 5.1.2.4 Remove Device .............. ............. ................... .................... ............. ....... 35 5.1.2.5 Driver Synchroniz ation .
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 5 Contents 8.2 imbCloseDr iver .............. .................... ............. ................... ................... ............. .............
6 High Avail ability Software f or the Inte l ® NetStructu re TM ZT 4901 Tec hnical Product Specification Contents Figures 1 High-Av ailabilit y CPU Architec ture .. ................... ................... ............. .................... .........
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 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 Comm unication section.
8 High Avail ability Software f or the Inte l ® NetStructu re TM ZT 4901 Tec hnical Product Specification Contents This p a ge int e ntionally left b l ank.
Intel ® NetS tructure TM ZT 4901 H igh Availabili ty Software Techn ical Product Specificatio n 9 Document Organization 1 This document describ e s th e Hig h A vailability So ftware Development Kit for the Intel ® NetStructur e™ ZT 4901 I/O Mezzanine Card.
10 Intel ® NetStructure TM ZT 490 1 High Availabi lity Software Technica l Product Specificatio n Document Organizati on Appendix G , “R H S witch over on OS Crash,” des cribes how the High-A vai.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 11 Introduction 2 Intel ® High A vailability (HA) sy stems feature built-in redu ndan cy for active system components such as power supplies, sys tem master process or boards, and system alarms.
12 H igh Availabi lity Softwa re for t he Intel ® NetStructure TM ZT 4901 Technical Produc t Specificati on Introduction Appli cation— Application-specific code, not includin g application-specific device drivers.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 13 Introduction Handover— A type of switchover that is initiated by the Active Host, resulting .
14 H igh Availabi lity Softwa re for t he Intel ® NetStructure TM ZT 4901 Technical Produc t Specificati on Introduction Spli t Mode— Split Mo de is a term that refer s to a system oper atin g with multiple system master Host boards that each own a s ingle bus segment.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 15 Introduction Intel’ s RH software run s on system master processor b o ards with bridge mezzanine cards in a PICMG 2.13 compliant RSS backp lane to provide redundant sys tem master functionality .
16 H igh Availabi lity Softwa re for t he Intel ® NetStructure TM ZT 4901 Technical Produc t Specificati on Introduction 2.2.2 B ridge Mezzani n e The HASDK driver set work s in single and dual bus segment conf igur atio ns. In order for the dual bus configu ration to be supported a b ridge mezzanine must be moun t ed on the processor b oard.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 17 Introduction 2.2.3 Backplane The RSS system b ackplane supports two CompactPCI buses acces s ible by both Redundant Hosts.
18 H igh Availabi lity Softwa re for t he Intel ® NetStructure TM ZT 4901 Technical Produc t Specificati on Introduction 2.3 High-A vailabilit y Software Approach As shown in th e Figure 1 , “Hig h.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 19 Introduction The design of the ap plication should be made as por t able as poss i ble. This requires that the design be implemented in a modular approach that isolates the s ystem management requirements from the host application.
20 H igh Availabi lity Softwa re for t he Intel ® NetStructure TM ZT 4901 Technical Produc t Specificati on Introduction 2.3.3 Backplane Device Drivers Backplane device d rivers are a critical component of High A vailability system.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 21 Host Application Software 3 Through tho ughtful design and the u s e of a layered development appro ach, an application can be developed that meets the imp l ied robustness of a highly available system and also is a porta ble entity .
22 H igh Availabi lity Softwa re for t he Intel ® NetStructure TM ZT 4901 Technical Produc t Specificati on Host Application Softwa re System Host in the sa me chassis. In order for a ho st application to be capable of maintainin g the system’ s serviceability , these redundant applications should maintain some level of synchroni zation.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 23 Host Application Software The diagram shows that the host app lication’ s need to understand.
24 H igh Availabi lity Softwa re for t he Intel ® NetStructure TM ZT 4901 Technical Produc t Specificati on Host Application Softwa re 3.3.2 Graceful Switchover In a Redundan t Host environment a graceful s wit chover is only secondary in importance to d ata integrity .
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 25 System Management 4 System Management is an all-encompassing term whose defin i tion can var y drastically depending on the typ e of system that is being develope d.
26 H igh Availabi lity Softwa re for t he Intel ® NetStructure TM ZT 4901 Technical Produc t Specificati on System Management The next-generation , high-availability architecture pr ovides this system m anagement infrastruc ture using IPMI.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 27 Syst em Manage ment • Upper/Lower critical thre s hold • Upper/Low er non-recoverable t hreshold Each range can b e set independently for each sens or and the ranges can o v erlap.
28 H igh Availabi lity Softwa re for t he Intel ® NetStructure TM ZT 4901 Technical Produc t Specificati on System Management The RH channel acts as a v irtual channel that can respond to Alert Actions .
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 29 Syst em Manage ment Request - - Response 1 Completion Code 2 RH BMC Address.
30 H igh Availabi lity Softwa re for t he Intel ® NetStructure TM ZT 4901 Technical Produc t Specificati on System Management This p a ge int e ntionally left b l ank.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 31 High Availability CompactPCI Device Drivers 5 This chapter describes the characteristics of highly available software drivers f or CompactPCI peripherals i n a Redundant Host environment.
32 H igh Availabi lity Softwa re for t he Intel ® NetStructure TM ZT 4901 Technical Produc t Specificati on High Availability Compac tPCI Device Dri vers 5.1 .1 Devi ce Dr i v er St at e s There are varying degrees of functionality that are depen d ent on power modes, operating system Hot Swap implementations, and dev i ce characteristics.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 33 High Availability CompactP CI Device Dri vers 5.
34 H igh Availabi lity Softwa re for t he Intel ® NetStructure TM ZT 4901 Technical Produc t Specificati on High Availability Compac tPCI Device Dri vers • Add Device • Resume Operati ons • Suspend Oper ations • Remove Device 5.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 35 High Availability CompactP CI Device Dri vers 5.1.2.3 Suspend Operations The counterpart to the Resu me Operation callback is the Suspend Op eration .
36 H igh Availabi lity Softwa re for t he Intel ® NetStructure TM ZT 4901 Technical Produc t Specificati on High Availability Compac tPCI Device Dri vers 5.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 37 Redundant Host API 6 6.1 Intel-Specific APIs 6.
38 H igh Availabi lity Softwa re for t he Intel ® NetStructure TM ZT 4901 Technical Produc t Specificati on Redundant Host API OUT BOOL*pbReset ); Arg ument s : Handle – the handle of the current s.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 39 Redundant Host API The following topics specify each of the interface functions. 6.2.1 Defin itions and T ypes The following definitions are provided f or terms used in th e remaining topics of this chapter .
40 H igh Availabi lity Softwa re for t he Intel ® NetStructure TM ZT 4901 Technical Produc t Specificati on Redundant Host API RH Instance ID. A host can be a member o f several RH systems si multaneously , similar to multi- homed hosts in n etw orking.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 41 Redundant Host API typedef void (*RH_SLOT_STATE_CALLBACK) ( IN uint32 Domain, IN PHYSICAL_SLOT.
42 H igh Availabi lity Softwa re for t he Intel ® NetStructure TM ZT 4901 Technical Produc t Specificati on Redundant Host API typedef void * RH_HANDLE; 6.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 43 Redundant Host API An RH infrastructu re that implements this func tion shal l return the list o f RH Instance IDs only for those RH Systems that it serv i ces.
44 H igh Availabi lity Softwa re for t he Intel ® NetStructure TM ZT 4901 Technical Produc t Specificati on 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 app lication wants to work with.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 45 Redundant Host API Arguments : Handle – the h andle of the current session pInstanceID – p.
46 H igh Availabi lity Softwa re for t he Intel ® NetStructure TM ZT 4901 Technical Produc t Specificati on Redundant Host API Handle – the handle of the current session pCount – pointer to the v.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 47 Redundant Host API Other , implementation-defined HSI_ST A TUS values returned if oth er error.
48 H igh Availabi lity Softwa re for t he Intel ® NetStructure TM ZT 4901 Technical Produc t Specificati on Redundant Host API HSI_ ST A TUS RhGetDomainS lotPath ( IN RH_HANDLE Handle, IN uint3 2 Hos.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 49 Redundant Host API The slot path is st ored as a null-terminated s equence of two-character gr oups.
50 H igh Availabi lity Softwa re for t he Intel ® NetStructure TM ZT 4901 Technical Produc t Specificati on Redundant Host API Domain the domain number pSlotNumber s Array pointer t o the array where.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 51 Redundant Host API PhysSlot the physical slot number (represented as comb i nation of Shelf ID.
52 H igh Availabi lity Softwa re for t he Intel ® NetStructure TM ZT 4901 Technical Produc t Specificati on Redundant Host API HSI_ ST A TUS RhGetHos tCount( IN RH_HANDLE Handle, OUT uint32 *pHostCou.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 53 Redundant Host API HSI_ST A TUS_I NSUFFICIENT _BUFFER returned if the buffer provided for the .
54 H igh Availabi lity Softwa re for t he Intel ® NetStructure TM ZT 4901 Technical Produc t Specificati on Redundant Host API HSI_ ST A TUS_ INSUF FICIEN T_BU FFER returned if the buffer OutHostName.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 55 Redundant Host API returns F ALSE. This mod e can be used for conf i guration purposes, f o r example, to update system software on the hos t.
56 H igh Availabi lity Softwa re for t he Intel ® NetStructure TM ZT 4901 Technical Produc t Specificati on Redundant Host API 6.2.3.1 4 RhGetDomainA vailabilityT oHost Proto type : HSI_ ST A TUS RhG.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 57 Redundant Host API PhysSlo t obtains i nformation for g iven physical s l ot nu mber pInfoBuf .
58 H igh Availabi lity Softwa re for t he Intel ® NetStructure TM ZT 4901 Technical Produc t Specificati on Redundant Host API SlotPath The slot path f rom t he root bu s to th e device. The s lot p ath is st ored as a null-termin ated sequence of two-chara ct er gro ups.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 59 Redundant Host API OUT RH_SLOT_DESCRIP T OR *pInfoBuffer , IN uint32 I nfoBufferSize, OUT uint.
60 High Availabili ty Softwar e for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation Redundant Host API OwningHost The n umber of the host that curr ently owns the domain this d.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 61 Redundant Host API This funct ion can be used to enumerate devices nest ed below physical slots if a PCI-PCI bridge occupies t he phys ical slot.
62 High Availabili ty Softwar e for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation Redundant Host API Software connection is the inv erse action to software disconnecti on: it st arts the drivers for PCI devices in the domai n and resu m e s n ormal operation.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 63 Redundant Host API Hence, forced sw itchover is pot entially destructiv e for the owning hos t and should be u sed with care. T o perf orm for ced switch over , it is sufficient to call the RhPerformSwi tchover function.
64 High Availabili ty Softwar e for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation Redundant Host API IN uint3 2 DestinationHost , IN uint3 2 Timeo ut, IN BOOLEAN Persist ); A.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 65 Redundant Host API This function just initiates th e software disconnection and does not wait f or its completion. The function RhGetDomainSwConn ecti onStatus can be u s ed to track the p rogress of the pending disconn ection.
66 High Availabili ty Softwar e for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation Redundant Host API Syno psis : This function requests dom ain software connection.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 67 Redundant Host API Get domain software conn ection status. This function return s the current state of the specified domain with respect to softwar e conn ection/disconnection.
68 High Availabili ty Softwar e for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation Redundant Host API HSI_ ST A TUS RhPerformS witchover( IN RH_HANDLE Handle, IN uint3 2 Desti.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 69 Redundant Host API HSI_ST A TUS RhSetHwDestin ationHost( IN RH_HANDLE Handle, IN ui nt32 So ur.
70 High Availabili ty Softwar e for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation Redundant Host API 6.2.5.8 RhG etHwDestinationHos t Proto type : HSI_ ST A TUS RhGetHwDestin.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 71 Redundant Host API DomainCallback pointer to the callback function that tracks state of the do.
72 High Availabili ty Softwar e for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation Redundant Host API Callback – pointer to the c allback function Context – an opaque contex t pointer; passed unchang ed to the callback function.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 73 Redundant Host API Other , implementation-defined HSI_ST A TUS values returned if other errors.
74 High Availabili ty Softwar e for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation Redundant Host API The corresponding callback can be used to handle this situation. The callback is called with the bus lock held. Parameters to the callb ack inclu de a lis t of en trie s id entifying domain devices in unsafe states.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 75 Redundant Host API SlotPath - the slot path fro m the root bus to the device; represented as a null- terminated character string BusNumber - the bus number f or the device.
76 High Availabili ty Softwar e for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation Redundant Host API HSI_ ST A TUS RhDisableNo tification( IN RH_HANDLE Handle IN RH_NOTIFICA .
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 77 Hot Swap API 7 See the Intel ® NetS tructure ™ Hot S wap Kit for L inux 2.4 Softw are Manual for a detailed description of the p rov ided Ho t Swap API supported by this softwar e ins tallati on.
78 High Availabili ty Softwar e for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation Hot Swap API This p a ge int e ntionally left b l ank.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 79 IPMI API 8 8.1 imbOpenDriver Protot ype: int imbOp enDriver(voi d) Parameters: None Returns: Int - 0 for Fail and 1 for Success, sets hDevice Description: Establish a link to the IMB dr i ver .
80 High Availabili ty Softwar e for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation IPMI API LPVOID lpvOutBuffer , DWORD cbOutBu ffer , LPDWORD lpcbBytesR eturned, LPOVERLAPPED.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 81 IPMI API ACCESN_ST A TUS - ACCESN_OK else error status cod e Description : Sends a r equest to an I 2 C devic e 8.
82 High Availabili ty Softwar e for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation IPMI API Ret urns : ACCESN_ST A TUS - ACCESN_OK else error status code Description : This function gets the next available async message with a message ID greater than SeqNo.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 83 IPMI API ACCESN_ S T A TUS imbUnregi sterForAsyncMsgN otification (u nsigned int *h andleId) P.
84 High Availabili ty Softwar e for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation IPMI API 8.12 imbGetIpmiV ersion Proto type : BYTE imbGetIpmiV er sion() Parameters : Non e .
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 85 Slot Control API 9 9.1 HsiOpenSlotContro l Pro totype : HSI_ST A TUS HsiOpenSlotC ontrol( OUT .
86 High Availabili ty Softwar e for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation Slot Control API Ret urn V alu e : HSI_ST A TUS_SUCCESS if successful HSI_ST A TUS_INV ALID_.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 87 Slot Control API HSI_ST A TUS HsiGetBoardPresent( IN HSI_SLOT_CONTROL_HANDLE Handle, IN UINT32.
88 High Availabili ty Softwar e for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation Slot Control API Slot - The p hysical slot number pHealthy - Pointer to th e location where .
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 89 Slot Control API HSI_ST A T US_INV ALID_P ARAMETER returned if the p hysical slot number does .
90 High Availabili ty Softwar e for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation Slot Control API HSI_ ST A TUS HsiGetSlo tReset( IN HSI_SLOT_CONTROL_HANDLE Handle, IN UINT3.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 91 Slot Control API Reset - The new reset state for the slo t : TRUE means the slot is pl aced in.
92 High Availabili ty Softwar e for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation Slot Control API HSI_ST A TUS_INV ALID_P ARAMETER returned if the ph ys ical slot numbe r do.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 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 value of the parameter M66Enable.
94 High Availabili ty Softwar e for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation Slot Control API The callback function h as the following prototype: VOID (*HSI_SLOT_EVENT_C.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 95 Demonstration Utilities 10 The purpose of the demonstration utilit y is to demonstrate and exp.
96 High Availabili ty Softwar e for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation Demonstration Utilities • Clust er A Standby Host is a host that does not cont rol a bus domain. A S t andby Host is referred to as being in Standby mode.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 97 Demonstration Utilitie s 10.1.2.4 Swi t chover Functions The RHDemo exposes the followin g fun.
98 High Availabili ty Softwar e for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation Demonstration Utilities • Enable Switchover Requ est Notification • Enable Unsafe Switchover Notification • Disable Notif icatio n 10.1.3 IPMI Inter face The IPMI interface is an i mportant element of the RSS system architecture.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 99 Demonstration Utilitie s 10.1.4 Hot Swap I nterface The basic purpose of the Com pact PCI hot swap functionality is to allow orderly insertion or extraction of CompactPCI b oards without affecting o peration of the system involved .
100 High Availabili ty Softwa re for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation Demonstration Utilities The following info rmati on is displayed: • Slot p ath • V endo.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 101 Demonstration Utilitie s • Slot state flags If the slot is not emp ty , the following field.
102 High Availabili ty Softwa re for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation Demonstration Utilities.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 103 Software Installat ion Software Installation A A.1 Lin ux The Redund ant Host software package in Linu x is broken out into two R PM packages. T o achieve full Hot Swap Redundant Host capability , both packages must be installed.
104 High Availabili ty Softwa re for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation Software Inst allation 2. Patch and rebuild the kernel with Redundant Host Support, then copy this kernel image to the / usr/src/r edhat/BUILD/Compact PCI-RH-1.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 105 Software Installat ion CONFIG_RH options also must be enabled. The Redun dant Host Soft w are is dependant on both the Hot Swap suppo rt and IPMI drivers to be enabled.
106 High Availabili ty Softwa re for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation Software Inst allation A.4.3 /Comp actPCI-RH-1.0/ app /lib After building all the pro ject s in the application subdirectory , this directory contain s the following sh ar ed ob ject modu les an d libr ary: • libIpmiApi .
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 107 Redundant Host Function Return V alues B HSI_ST A TUS_SUCCESS The specified operation com pleted successf ully . HSI_ST A TUS_BUS_NOT_FOUND Th e operation failed because the required bus was no t found.
108 High Availabili ty Softwa re for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation Redundant Host Function Return V alues HSI_ST A TUS_DEVICE_SEARCH_F A ILED The search fo r this device failed to be resolved.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 109 Redundant Host Function Return V alues HSI_ST A TUS_INV ALID_P ARAMETER The specified o peration could not be completed becaus e one or more input parameters were not v alid .
110 High Availabili ty Softwa re for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation Redundant Host Function Return V alues HSI_ST A TUS_NOT_A V AILIBLE The specified operation coul d not be completed because neces s ary functionality was not available at the time of the call.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 111 Redundant Host Function Return V alues HSI_ST A TUS_UNABLE_TO_SEND_P ACKET The Redundant Host was unsuccessful in s ending an inter- Host message between the redu nd ant sy ste m master s.
112 High Availabili ty Softwa re for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation Redundant Host Function Return V alues This p a ge int e ntionally left b l ank.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 113 HSK Device Driver Interface for VxW orks* 5.
114 High Availabili ty Softwa re for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation HSK Dev ice Driver Int erface for VxWorks* 5 .
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 115 HSK Devi ce Driver Int erface for VxWorks* 5.4 UINT8 BaseClass; UINT16 SubVendorID; UINT16 SubSystemID; } RH_COMPAT_DEVICE, * PRH_COMPAT_DEVICE; C.
116 High Availabili ty Softwa re for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation HSK Dev ice Driver Int erface for VxWorks* 5 .4 A driver can h ave itself removed fro m the HSK Manager ’ s regi stry by calling the rhHskUnregisterDriver rou tine.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 117 HSK Devi ce Driver Int erface for VxWorks* 5.4 C.4.2 HSI_ ST A TUS St artDevice StartDevice is called fo r a device driv er to commence or resume activity with its associated d evice.
118 High Availabili ty Softwa re for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation HSK Dev ice Driver Int erface for VxWorks* 5 .4 Pointer to a device object. This data is a device context allowing the device driver to iden tif y the specific device whose state is changing to stopp ed .
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 119 HSK Devi ce Driver Int erface for VxWorks* 5.
120 High Availabili ty Softwa re for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation HSK Dev ice Driver Int erface for VxWorks* 5 .4 Parameters pci A PCI location structure. This structure contains the PCI bus, dev i ce, and fun cti on location of the device being associated with the mes s age callback routine.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 121 HSK Devi ce Driver Int erface for VxWorks* 5.4 C.6.1 RH_HSK_RH_PROCESS_P ACKET RH_HSK_RH_PROCESS_P ACKET is called when a message pack et is being redirected to a device driver fo r synchronization purpo s es.
122 High Availabili ty Softwa re for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation HSK Dev ice Driver Int erface for VxWorks* 5 .4 pPackett Pointer to a data packet being sent to the specified device dri ver . It is the responsibilit y of the device driver to validate th e packet contents.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 123 RH Device Driver Interface for Linux* 2.4 D The High-A vai lability RH architecture leverages.
124 High Availabili ty Softwa re for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation RH Device Dri ver Interf ace for Lin ux* 2.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 125 Design Guideline for Peripheral V endorsE The following topics present guidelines for desig ning a device driver for use in the Intel NetStructure Redundant Host environmen t.
126 High Availabili ty Softwa re for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation Design Guideline for Peripheral V endors This p a ge int e ntionally left b l ank.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 127 Porting ZT 5550 HA Applications to PICMG 2.12 F The PICMG 2.12 base API (described in Chap ter 6 ) and IPMI replace the f unction ality of the Host Controll er API used wit h the ZT 5550 sy stem master boar d.
128 High Availabili ty Softwa re for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation Porting ZT 5550 HA Applications to PICMG 2.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 129 RH Switchover on OS Crash G The High-A vailab ility RH architecture enables the system master board to perform a switchover to the backup ho s t in the even t of a system crash.
130 High Availabili ty Softwa re for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation RH Switcho ver on OS Crash This p a ge int e ntionally left b l ank.
High Availa bility Software for the Intel ® Net Structure TM ZT 4 901 Technical Product Specification 131 Data Sheet Reference H H.1 Com pactPCI Information ab out CompactPCI specifications is available from PI C MG* (PCI Industrial Computers Manufactu rers Group): https://www .
132 High Availabili ty Softwa re for the Intel ® Ne tStructure TM ZT 49 01 Technical Product Specifi cation Data Sheet Refer ence This p a ge int e ntionally left b l ank.
Intel ® NetS tructure TM ZT 4901 H igh Availabili ty Software Techn ical Product Specificatio n 133 Index A activation 32 API hot swap 26, 77 IMPI 25 redundant host 25, 37 slot control 26, 85 switcho.
134 Int el ® NetStructure TM ZT 4 901 Hig h Availab ility Software Tec hnical Product Specification imbOpenDriver 79 imbRegisterForAsyncMsgNotification 82 imbSendIpmiRequest 81 imbSendTimedI2cRequest.
Intel ® NetS tructure TM ZT 4901 H igh Availabili ty Software Techn ical Product Specificatio n 135 slot control API 26 software 21 division of labor 22 portability 21 redundancy 21 serviceability 21.
136 Int el ® NetStructure TM ZT 4 901 Hig h Availab ility Software Tec hnical Product Specification This p a ge int e ntionally left b l ank..
An important point after buying a device Intel ZT 4901 (or even before the purchase) is to read its user manual. We should do this for several simple reasons:
If you have not bought Intel ZT 4901 yet, this is a good time to familiarize yourself with the basic data on the product. First of all view first pages of the manual, you can find above. You should find there the most important technical data Intel ZT 4901 - thus you can check whether the hardware meets your expectations. When delving into next pages of the user manual, Intel ZT 4901 you will learn all the available features of the product, as well as information on its operation. The information that you get Intel ZT 4901 will certainly help you make a decision on the purchase.
If you already are a holder of Intel ZT 4901, but have not read the manual yet, you should do it for the reasons described above. You will learn then if you properly used the available features, and whether you have not made any mistakes, which can shorten the lifetime Intel ZT 4901.
However, one of the most important roles played by the user manual is to help in solving problems with Intel ZT 4901. Almost always you will find there Troubleshooting, which are the most frequently occurring failures and malfunctions of the device Intel ZT 4901 along with tips on how to solve them. Even if you fail to solve the problem, the manual will show you a further procedure – contact to the customer service center or the nearest service center
