ONTAP 9.14.1 commands

cluster join

(DEPRECATED)-Join an existing cluster using the specified member’s IP address or by cluster name

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


This command is deprecated and may be removed in a future release of Data ONTAP. Use cluster add-node from a node in the cluster instead.

The cluster join command adds a node to an existing cluster. Use the cluster create command to create a cluster if one does not already exist.

Note that a cluster network interface must be configured for the cluster before other nodes can join the cluster.


{ -clusteripaddr <IP Address> - IP Address of a Cluster Interface from a Node in the Cluster

Use this parameter to specify the IP address of a cluster interface. This must be the IP address of a cluster interface of a node that is already in the cluster. This parameter is mutually exclusive with the -cluster-name parameter.

| -cluster-name <text> - (DEPRECATED)-Cluster Name of the Cluster to Join }

Deprecated. Use this parameter to specify the name of an existing cluster to join.

[-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 Data ONTAP to join the cluster. A Data ONTAP best practice is to join nodes to the cluster that are of the same Data ONTAP version as the nodes in the cluster, but that may not always be possible.

[-node-name <text>] - Name to Use for the Node in the Cluster

This parameter specifies the name that the node will have when we join it to the cluster.

-cluster-admin-user <text> - Cluster Admin User on the Cluster to Join

Use this parameter to specify the username of a user with the "admin" role, for example the user "admin".


The following example joins the local node to a cluster. The IP address is the address of a cluster interface of a node that already belongs to the cluster.

node::> cluster join -clusteripaddr
Top of Page