Skip to main content

cluster add-node

Contributors
Suggest changes
PDFs

Expand the cluster by discovering and adding new nodes

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

Description

The cluster add-node command discovers and adds new nodes to the cluster. When the -node-count parameter is specified, the command attempts to add that many nodes to the cluster. The -node-ip parameter can be specified to directly add a node. The -cluster-ips parameter can be specified to directly add one or more nodes in parallel. Only one of the -node-count , -node-ip and -cluster-ips parameters can be provided. The system node show-discovered command displays all the nodes discovered on the local network.

Note The node-count parameter is deprecated and may be removed in a future release of ONTAP. Use the -cluster-ips parameter instead.
Note The node-ip parameter is deprecated and may be removed in a future release of ONTAP. Use the -cluster-ips parameter instead.

Parameters

{ -cluster-ips <IP Address>,…​ - List of Cluster Interface IP Addresses of the Nodes Being Added

This parameter contains a comma separated list of cluster interface IP addresses of the nodes in the cluster you are creating. All the nodes specified in the list will be added to the cluster.

| -retry <true> - Retry a failed cluster add-node operation

Use this parameter to retry the most recently failed cluster add-node command with the originally specified parameters. Retry is not supported if the cluster add-node command was originally run with either the -node-count or -node-ip parameters.

| -node-count <integer> - (DEPRECATED)-Number of Nodes Being Added

Number of nodes to be added to the cluster. If fewer nodes are discovered, all the discovered nodes are added to the cluster and the command will fail since there are fewer nodes than specified. If more nodes are found than the number specified, the command will fail because there is no way to determine which nodes you intend to add to the cluster.

Note The -node-count parameter is supported on non-shared architecture platforms only.
| -node-ip <IP Address> - (DEPRECATED)-Cluster IP Address of Node }

Cluster IP address of the node to add. When this parameter is provided, the command directly adds the node.

[-node-names <text>,…​] - List of Node Names

This parameter contains a comma separated list of node names of all the nodes in the cluster you are creating. The node names must have an one to one correspondence with -cluster-ips parameter. The names provided will be used to rename the nodes once they are added to the cluster.

[-foreground {true|false}] - Foreground Process

When set to false the command runs in the background as a job. The default is true , which causes the command to return after the operation completes.

[-allow-mixed-version-join <true>] - Allow a Node At a Different Version to Join Cluster

This parameter allows nodes with different, but compatible versions of ONTAP to be added to the cluster. A ONTAP best practice is to add nodes to the cluster that are of the same ONTAP version as the nodes in the cluster, but that may not always be possible.

Examples

The following example adds a node using -cluster-ips :

cluster1::> cluster add-node -cluster-ips 1.1.1.1, 2.2.2.2
      Use the 'cluster add-node-status' command to see the progress of the add-node operation.

The following example adds 3 nodes using -node-count .

cluster1::> cluster add-node -node-count 3
      [Job 22] Job succeeded.