This topic has not yet been rated - Rate this topic

RestartThreshold

Specifies the maximum number of restart attempts that can be made on a resource within an interval defined by the RestartPeriod property before the Cluster service initiates the action specified by the RestartAction property. The following table summarizes the attributes of the RestartThreshold property:

AttributeValue

Data type

DWORD

Access

Read/write

Structure

CLUSPROP_DWORD

Minimum

0

Maximum

0xFFFFFFFF

Default

3

 

Remarks

When a resource does fails, the Cluster service attempts to restart the resource (unless the RestartAction property is set to ClusterResourceDontRestart).

The RestartPeriod and RestartThreshold properties work together to limit restart attempts. For example, if the RestartPeriod property is set to 200 milliseconds, and the RestartThreshold property is set to two retry attempts, then the Cluster service tolerates two restart failures within any 200 millisecond interval. More than two failures can occur, as long as they occur over an interval that is greater than 200 milliseconds. On the third restart failure within the 200 millisecond interval, the Cluster service considers the resource to have failed and may, depending on the RestartAction property, attempt to fail over the resource's group to another node.

Examples

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


DWORD          RestartThresholdData = 5;
CLUSPROP_DWORD RestartThresholdValue;

RestartThresholdValue.Syntax.dw = CLUSPROP_SYNTAX_LIST_VALUE_DWORD;
RestartThresholdValue.cbLength =  sizeof(DWORD);
RestartThresholdValue.dw =        RestartThresholdData;


Requirements

Minimum supported client

None supported [desktop apps only]

Minimum supported server

Windows 2000 Server Advanced Server, Windows 2000 Server Datacenter [desktop apps only]

See also

Resource Common Properties
CLUSPROP_DWORD
RestartAction
RestartPeriod

 

 

Send comments about this topic to Microsoft

Build date: 11/28/2012

Community Additions

ADD
© 2013 Microsoft. All rights reserved.