Skip to main content

cluster modify

Contributors
Suggest changes
PDFs

Modify cluster node membership attributes

Availability: This command is available to cluster administrators at the advanced privilege level.

Description

The cluster modify command modifies the cluster attributes of a node, including its eligibility to participate in the cluster.

At the advanced privilege level, you can use the command to specify whether a node holds epsilon. Epsilon is an extra fractional vote that enables quorum to form using slightly weaker requirements. For example, two out of four eligible nodes are sufficient to form quorum if one of those two nodes holds epsilon.

Parameters

-node {<nodename>|local} - Node

Use this parameter to specify the name of the node to modify. If you do not specify a node, the command runs on the local node.

[-epsilon {true|false}] - Epsilon (privilege: advanced)

Use this parameter with the value true to specify that the node holds Epsilon in the cluster. Use this parameter with the value false to specify that the node does not hold Epsilon in the cluster. In a cluster, only one node can be designated as Epsilon at any given time. You can designate a node as Epsilon to add weight to its voting in a cluster with an even number of nodes.

[-eligibility {true|false}] - Eligibility (privilege: advanced)

Use this parameter with the value true to specify that the node is eligible to participate in the cluster. Use this parameter with the value false to specify that the node is not eligible to participate in the cluster.

If you modify a node as ineligible to participate in the cluster, the command prompts you for confirmation before it runs.

[-skip-quorum-check-before-eligible <true>] - Skip Quorum Check Before Setting Node Eligible (privilege: advanced)

If this parameter is specified, quorum checks will be skipped prior to setting a node eligible. When setting a node to eligible, the operation will continue even if there is a possible data outage due to a quorum issue.

[-skip-quorum-check-before-ineligible <true>] - Skip Quorum Check Before Setting Node Ineligible (privilege: advanced)

If this parameter is specified, quorum checks will be skipped prior to setting a node ineligible. When setting a node to ineligible, the operation will continue even if there is a possible data outage due to a quorum issue.

Examples

This example modifies a node to make it eligible to participate in the cluster.

cluster1::*> cluster modify -node node3 -eligibility true

The following example removes epsilon from the node named node0 and adds it to the node named node1:

cluster1::*> cluster modify -node node0 -epsilon false
cluster1::*> cluster modify -node node1 -epsilon true