Redundant Host API

HSI_STATUS

RhSetHwDestinationHost(

IN RH_HANDLE Handle,

IN uint32 SourceHost,

IN uint32 *pDomains,

IN uint32 DomainCount,

IN uint32 DestinationHost,

IN BOOLEAN Reset );

Arguments:

 

Handle –

the handle of the current session

SourceHost –

the number of the host for which domain destination is specified

pDomains –

the array of domain numbers identifying the group of domains that is

 

passed to the specified destination host if the source host fails and

 

hardware-initiated switchover takes place for it

DomainCount

the size of the array pDomains

DestinationHost

the number of the host that owns the specified domains if the source host

 

fails and hardware-initiated switchover takes place for it; value

 

RH_NO_DESTINATION_HOST means “no host owns the domains”

Reset

if TRUE, the PCI buses of domains are reset after the switchover

Return Value:

 

HSI_STATUS_SUCCESS returned in the case of success

HSI_STATUS_INVALID_PARAMETER

invalid session handle or invalid parameters (wrong or non-existent host or domain numbers)

HSI_STATUS_REQUEST_DENIED

the request for the specified domains by the current host has been denied

HSI_STATUS_NOT_SUPPORTED

returned if this function is not supported by the infrastructure

Other, implementation-defined HSI_STATUS values

returned if other errors occurred during execution of this function

Synopsis:

This function is used to specify the destination host that obtains specified domains if a hardware- initiated switchover occurs due to the failure of the source host. In the case of such failure, domains owned by that host should be transferred to some other host; this function specifies the destination host on a per-domain group basis.

If this function is not called before the hardware-initiated switchover actually takes place, the domain is either passed to some predefined host or left unattached to any host. This predefined arrangement is specified by some entity beyond the scope of this specification (like BIOS or hardware default). However, the function RhGetHwDestinationHost can be used to obtain this predefined arrangement, even if RhSetHwDestinationHost has not yet been called for this domain/ host pair.

High Availability Software for the Intel® NetStructureTM ZT 4901 Technical Product Specification

69

Page 69
Image 69
Intel ZT 4901 manual Rhnodestinationhost means no host owns the domains