Skip to main content

cluster create

Contributors
Suggest changes
PDFs

Create a cluster

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

Description

The cluster create command creates a cluster with one or more nodes. When the -node-count parameter is specified, the command attempts to add that many nodes to the cluster. The -cluster-ips parameter can be specified to add one or more nodes in parallel. Only one of the -node-count and -cluster-ips parameters can be provided.

Note that single-node clusters do not require configuring the cluster network. A cluster network interface must be configured before other nodes can join the cluster.

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

Parameters

[-license <License Code V2>] - (DEPRECATED)-Base License
Note This parameter is deprecated and may be removed in a future release of ONTAP.

Use this optional parameter to specify the base license for the cluster. Obtain this value from your sales or support representative.

-clustername <text> - Cluster Name

Use this parameter to specify the name of the cluster you are creating.

  • The name must contain only the following characters: A-Z, a-z, 0-9, "-" or "_".

  • The first character must be one of the following characters: A-Z or a-z.

  • The last character must be one of the following characters: A-Z, a-z or 0-9.

  • The maximum supported length is 44 characters.

  • The system reserves the following names: "all", "cluster", "local" and "localhost".

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

| [-node-count <integer>] - (DEPRECATED)-Node Count

Use this parameter to specify the number of nodes in the cluster you are creating.

  • -node-count parameter is supported on non-shared architecture platforms only.

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

| -retry <true> - Retry a failed cluster create operation }

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

Examples

The following example creates a cluster named cluster1

cluster1::> cluster create -clustername cluster1

The following example creates a cluster named cluster1 with node-count 4 on a non-shared architecture platform.

cluster1::> cluster create -clustername cluster1 -node-count 4