FailoverThreshold

Specifies the maximum number of failover attempts that can be made on a group within a time interval defined by FailoverPeriod. The following table summarizes the attributes of the FailoverThreshold property.

Remarks

If the Cluster service exceeds the number of failover attempts specified by FailoverThreshold within the time interval specified by FailoverPeriod, it stops trying to fail over the group.

For example, if FailoverThreshold is set to 2 and RestartPeriod is set to 1, a node can tolerate 2 failover attempts of the group within any 1-hour interval. More than 3 failover attempts can occur, as long as they occur over an interval that is greater than 1 hour.

If a value for FailoverThreshold is not specified, the default value is the number of nodes in the cluster minus 1. This is represented as 0xFFFFFFFF.

Windows Server 2003 and Windows 2000 Server:  

The default value is 10.

Examples

The property value portion of a property list entry for FailoverThreshold can be set with the following example code:

DWORD          FailoverThresholdData = 5;
CLUSPROP_DWORD FailoverThresholdValue;

FailoverThresholdValue.Syntax.dw = CLUSPROP_SYNTAX_LIST_VALUE_DWORD;
FailoverThresholdValue.cbLength  = sizeof(DWORD);
FailoverThresholdValue.dw        = FailoverThresholdData;

Requirements

See also

CLUSPROP_DWORD

FailoverPeriod

RestartPeriod

Send comments about this topic to Microsoft

Build date: 11/28/2012