Share via

3.2.4.1.1 Querying the State of a Cluster Node

  • Article

The state of a node in a cluster is determined by the cluster using implementation-specific mechanisms and methods between servers. In order to query that state, a client SHOULD follow the procedure that is specified in this section. As a prerequisite for this procedure, a client MUST establish an RPC connection to a cluster node, as specified in section 3.2.3.

  1. Call the ApiOpenNode (section 3.1.4.1.67 for protocol version 2, or 3.1.4.2.67 for protocol version 3) method indicating the computer name of the node whose state is to be queried. The client SHOULD interpret failure of this method as the node having state ClusterNodeDown, as specified in the ApiGetNodeState (section 3.1.4.1.69 for protocol version 2, or 3.1.4.2.69 for protocol version 3) method.

  2. Call the ApiGetNodeState method indicating the HNODE_RPC context handle obtained in the previous step. The client SHOULD interpret failure of this method as the node having state ClusterNodeDown (see the ApiGetNodeState method); otherwise, the client SHOULD conclude that the state of the node is that returned by the ApiGetNodeState method.

  3. Call the ApiCloseNode (section 3.1.4.1.68 for protocol version 2, or 3.1.4.2.68 for protocol version 3) method indicating the HNODE_RPC context handle that was obtained in the previous call to ApiOpenNode.