FailoverPeriod

Specifies a number of hours during which a maximum number of failover attempts, specified by FailoverThreshold, can occur. The following table summarizes the attributes of the FailoverPeriod property.

Attribute Value
Data type DWORD
Access Read/write
Structure CLUSPROP_DWORD
Minimum 0
Maximum 1193
Default 6

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 FailoverPeriod is set to 1, then a node can tolerate two failover attempts of the group within any 1-hour interval. More than three failover attempts can occur, as long as they occur over an interval that is greater than 1 hour.

FailoverPeriod has a maximum value of 1193 hours. If a value for FailoverPeriod is not specified, the default value is 6 hours.

Examples

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

DWORD          FailoverPeriodData = 5;
CLUSPROP_DWORD FailoverPeriodValue;

FailoverPeriodValue.Syntax.dw = CLUSPROP_SYNTAX_LIST_VALUE_DWORD;
FailoverPeriodValue.cbLength  = sizeof(DWORD);
FailoverPeriodValue.dw        = FailoverPeriodData;

Requirements

Minimum supported client
None supported
Minimum supported server
Windows Server 2008 Enterprise, Windows Server 2008 Datacenter

See also

CLUSPROP_DWORD

FailoverThreshold

RestartPeriod