Skip to main content

cluster join

Contributors
Suggest changes

(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.

Description

Note This command is deprecated and may be removed in a future release of 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.

Parameters

{ -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 ONTAP to join the cluster. A ONTAP best practice is to join nodes to the cluster that are of the same 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".

Examples

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

node::> cluster join -clusteripaddr 192.0.2.66