TestabilityExtensions.StartNodeAsync Method (FabricClient.ClusterManagementClient, String, BigInteger, CompletionMode, CancellationToken)

Article
04/18/2016
2 minutes to read

Starts a cluster node.

Namespace: System.Fabric.Testability
Assembly: System.Fabric.Testability (in System.Fabric.Testability.dll)

Syntax

public static Task<StartNodeResult> StartNodeAsync(
    this FabricClient.ClusterManagementClient clusterManagementClient,
    string nodeName,
    BigInteger nodeInstance,
    CompletionMode completionMode,
    CancellationToken token
)

Parameters

clusterManagementClient
Type: System.Fabric.FabricClient.ClusterManagementClient

The source FabricClient.ClusterManagementClient on which this action is invoked.

nodeName
Type: System.String

The node name of the node to start.

nodeInstance
Type: System.Numerics.BigInteger

The node instance ID of the node, before it was stopped. If this is not specified, or is set to 0, this is ignored. If this is set to -1, the system will internally determine this value.

completionMode
Type: System.Fabric.Testability.CompletionMode

If set to Verify, the system will check that the node started, and the API will not return until it has. If set to DoNotVerify, the API returns once the node start has been initiated.

token
Type: System.Threading.CancellationToken

The cancellation token.

Return Value

Type: System.Threading.Tasks.Task<StartNodeResult>

A task with information representing the target node.

Exceptions

Exception	Condition
FabricException	The ErrorCode property will indicate the reason. If the ErrorCode is InvalidArgument, nodeName or nodeInstance is invalid. If the errorCode is InstanceIdMismatch, the nodeInstance provided does not match the instance of the node that was stopped. If the ErrorCode is NodeHasNotStoppedYet, there is a currently pending stop operation on this node.
TimeoutException	The operation timed out.
ArgumentNullException	An argument with a value of null was passed in.

Remarks

A cluster node is a process, not an virtual or physical machine.