Skip to main content

cluster setup

Contributors
Suggest changes

Setup wizard

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

Description

Note Use of this command to join a node to an existing cluster is deprecated and might be removed in a future release of ONTAP. From a node in the cluster use the system node show-discovered command and then use the cluster add-node command.

The cluster setup command runs the cluster setup wizard, which can be used to either create a cluster or join a node to an existing cluster. When you run the cluster setup wizard, enter the appropriate information at the prompts. You will be asked to provide the following information to create a cluster:

  • Node management interface port, IP address, netmask, default gateway

  • Cluster name

  • Cluster base license key

Note This parameter has been deprecated. It may be removed from a future release of ONTAP.
  • Feature license keys

  • Cluster administrator's password

  • Cluster management interface port, IP address, netmask, default gateway

  • DNS domain names

  • Name server IP addresses

  • Location

You will be asked to provide the following information to join a cluster:

  • Node management interface port, IP address, netmask, default gateway

  • Cluster IP address

The cluster management interface is used for managing the cluster. It provides one IP address to manage the cluster and will fail over to another node, if necessary. This is the preferred IP address for managing the cluster, but you can also manage the cluster by logging in to the node management IP address of a node in the cluster. Since the cluster management interface must be able to fail over, the port role for the interface must be "data" and typically the best choice for an IP address is one on the data network. The node management interface will not fail over, so an IP address on the management network and a port with the role "node management" is the best choice. Alternatively, you can assign an IP address on the data network to the cluster management interface - if that is better in your network topology - but the port must be a data port. The two examples below illustrate the cluster create and cluster join operations, respectively.

Parameters

Examples

An example of using cluster setup to create a cluster with IPv4 addresses is shown below.

node::> cluster setup
Welcome to the cluster setup wizard.

You can enter the following commands at any time:
  "help" or "?" - if you want to have a question clarified,
  "back" - if you want to change previously answered questions, and
  "exit" or "quit" - if you want to quit the cluster setup wizard.
     Any changes you made before quitting will be saved.

You can return to cluster setup at any time by typing "cluster setup".
To accept a default or omit a question, do not enter a value.

This system will send event messages and periodic reports to NetApp Technical
Support. To disable this feature, enter
autosupport modify -support disable
within 24 hours.

Enabling AutoSupport can significantly speed problem determination and
resolution should a problem occur on your system.
For further information on AutoSupport, see:
http://support.netapp.com/autosupport/

Type yes to confirm and continue {yes}: yes

Enter the node management interface port [e0c]:
Enter the node management interface IP address: 192.0.2.66
Enter the node management interface netmask: 255.255.255.192
Enter the node management interface default gateway: 192.0.2.1
The node management interface has been modified to use port e0c with IP address 192.0.2.66.
Use your web browser to complete cluster setup by accessing
https://192.0.2.66

Otherwise, press Enter to complete cluster setup using the command line
interface:
Do you want to create a new cluster or join an existing cluster? {create, join}:
create
Do you intend for this node to be used as a single node cluster? {yes, no} [no]:

Existing cluster interface configuration found:

Port    MTU     IP              Netmask
e0a     9000    169.254.21.189  255.255.0.0
e0b     9000    169.254.29.73   255.255.0.0

Do you want to use this configuration? {yes, no} [yes]:

Enter the cluster administrator's (username "admin") password:

Retype the password:
Step 1 of 5: Create a Cluster
You can type "back", "exit", or "help" at any question.

Enter the cluster name: cluster1

Creating cluster cluster1

Starting cluster support services .

Cluster cluster1 has been created.
Step 2 of 5: Add Feature License Keys
You can type "back", "exit", or "help" at any question.

Enter an additional license key []:
Step 3 of 5: Set Up a Vserver for Cluster Administration
You can type "back", "exit", or "help" at any question.
Enter the cluster management interface port [e0d]:
Enter the cluster management interface IP address: 192.0.2.60
Enter the cluster management interface netmask: 255.255.255.192
Enter the cluster management interface default gateway [192.0.2.1]:
A cluster management interface on port e0d with IP address 192.0.2.60 has been created.  You can use this address to connect to and manage the cluster.

Enter the DNS domain names: data.example.com
Enter the name server IP addresses: 192.0.2.147
DNS lookup for the admin Vserver will use the data.example.com domain.

Step 4 of 5: Configure Storage Failover (SFO)
You can type "back", "exit", or "help" at any question.
SFO is licensed.
SFO will be enabled when the partner joins the cluster.
Step 5 of 5: Set Up the Node
You can type "back", "exit", or "help" at any question.

Where is the controller located []: Sunnyvale
Cluster "cluster1" has been created.

To complete cluster setup, you must join each additional node to the cluster
by running "system node show-discovered" and "cluster add-node" from a node in the cluster.
To complete system configuration, you can use either OnCommand System Manager
or the ONTAP command-line interface.

To access OnCommand System Manager, point your web browser to the cluster
management IP address (https://192.0.2.60).

To access the command-line interface, connect to the cluster management
IP address (for example, ssh admin@192.0.2.60).
cluster1::>

An example of using cluster setup to join a cluster with IPv4 addresses is shown below.

node::> cluster setup
Welcome to the cluster setup wizard.

You can enter the following commands at any time:
  "help" or "?" - if you want to have a question clarified,
  "back" - if you want to change previously answered questions, and
  "exit" or "quit" - if you want to quit the cluster setup wizard.
     Any changes you made before quitting will be saved.

You can return to cluster setup at any time by typing "cluster setup".
To accept a default or omit a question, do not enter a value.

This system will send event messages and periodic reports to NetApp Technical
Support. To disable this feature, enter
autosupport modify -support disable
within 24 hours.

Enabling AutoSupport can significantly speed problem determination and
resolution should a problem occur on your system.
For further information on AutoSupport, see:
http://support.netapp.com/autosupport/

Type yes to confirm and continue {yes}: yes

Enter the node management interface port [e0c]:
Enter the node management interface IP address: 192.0.2.67
Enter the node management interface netmask: 255.255.255.192
Enter the node management interface default gateway: 192.0.2.1
A node management interface on port e0c with IP address 192.0.2.67 has been created.

Use your web browser to complete cluster setup by accessing
https://192.0.2.67

Otherwise, press Enter to complete cluster setup using the command line
interface:
Do you want to create a new cluster or join an existing cluster? {create, join}:
join
Existing cluster interface configuration found:

Port    MTU     IP              Netmask
e0a     9000    169.254.31.170  255.255.0.0
e0b     9000    169.254.115.61  255.255.0.0

Do you want to use this configuration? {yes, no} [yes]:
Step 1 of 3: Join an Existing Cluster
You can type "back", "exit", or "help" at any question.
Enter the IP address of an interface on the private cluster network from the
cluster you want to join: 169.254.115.8

Joining cluster at address 169.254.115.8

This node has joined the cluster cluster1.
Step 2 of 3: Configure Storage Failover (SFO)
You can type "back", "exit", or "help" at any question.
SFO is licensed.
SFO will be enabled when the partner joins the cluster.
Step 3 of 3: Set Up the Node
You can type "back", "exit", or "help" at any question.
This node has been joined to cluster "cluster1".

To complete cluster setup, you must join each additional node to the cluster
by running "system node show-discovered" and "cluster add-node" from a node in the cluster.
To complete system configuration, you can use either OnCommand System Manager
or the ONTAP command-line interface.

To access OnCommand System Manager, point your web browser to the cluster
management IP address (https://192.0.2.60).

To access the command-line interface, connect to the cluster management
IP address (for example, ssh admin@192.0.2.60).
cluster1::>

An example of using cluster setup to create a cluster with IPv6 addresses is shown below.

node::> cluster setup
Welcome to the cluster setup wizard.

You can enter the following commands at any time:
  "help" or "?" - if you want to have a question clarified,
  "back" - if you want to change previously answered questions, and
  "exit" or "quit" - if you want to quit the cluster setup wizard.
     Any changes you made before quitting will be saved.

You can return to cluster setup at any time by typing "cluster setup".
To accept a default or omit a question, do not enter a value.

This system will send event messages and periodic reports to NetApp Technical
Support. To disable this feature, enter
autosupport modify -support disable
within 24 hours.

Enabling AutoSupport can significantly speed problem determination
and resolution, should a problem occur on your system.
For further information on AutoSupport, see:
http://support.netapp.com/autosupport/

Type yes to confirm and continue {yes}: yes

Enter the node management interface port [e0c]:
Enter the node management interface IP address: FD20:8B1E:B255:814E:8E31:DDF2:8224:593D
You are trying to create an IPv6 address. Creating an IPv6 address will enable
IPv6 on this node.

Type yes to confirm and continue {yes, no}: yes
Enter the node management interface prefix length: 64
Enter the node management interface default gateway: FD20:8B1E:B255:814E:0000:0000:0000:0001
A node management interface on port e0c with IP address fd20:8b1e:b255:814e:8e31:ddf2:8224:593d has been created.

Use your web browser to complete cluster setup by accessing
https://[fd20:8b1e:b255:814e:8e31:ddf2:8224:593d]

Otherwise, press Enter to complete cluster setup using the command line
interface:
Do you want to create a new cluster or join an existing cluster? {create, join}:
create
Do you intend for this node to be used as a single node cluster? {yes, no} [no]:
Existing cluster interface configuration found:

Port  MTU  IP    Netmask
e0a  9000  172.31.6.130  255.255.192.0
e0b  9000  172.31.6.131  255.255.192.0

Do you want to use this configuration? {yes, no} [yes]:

Enter the cluster administrator's (username "admin") password:

Retype the password:
Step 1 of 5: Create a Cluster
You can type "back", "exit", or "help" at any question.

Enter the cluster name: cluster1

Creating cluster cluster1

Starting cluster support services ....

Cluster cluster1 has been created.
Step 2 of 5: Add Feature License Keys
You can type "back", "exit", or "help" at any question.

Enter an additional license key []:
Step 3 of 5: Set Up a Vserver for Cluster Administration
You can type "back", "exit", or "help" at any question.
Enter the cluster management interface port [e0d]:
Enter the cluster management interface IP address: FD20:8B1E:B255:814E:4827:F558:6150:8D5F
Enter the cluster management interface prefix length: 64
Enter the cluster management interface default gateway [fd20:8b1e:b255:814e::1]:
A cluster management interface on port e0d with IP address fd20:8b1e:b255:814e:4827:f558:6150:8d5f has been created.  You can use this address to connect to and manage the cluster.

Enter the DNS domain names: data.example.com
Enter the name server IP addresses: FD20:8B1E:B255:814E:8F99:721C:5471:FC1E
DNS lookup for the admin Vserver will use the data.example.com domain.

Step 4 of 5: Configure Storage Failover (SFO)
You can type "back", "exit", or "help" at any question.
SFO will not be enabled on a non-HA system.
Step 5 of 5: Set Up the Node
You can type "back", "exit", or "help" at any question.

Where is the controller located []:
Cluster "cluster1" has been created.

To complete cluster setup, you must join each additional node to the cluster
by running "system node show-discovered" and "cluster add-node" from a node in the cluster.
To complete system configuration, you can use either OnCommand System Manager
or the ONTAP command-line interface.

To access OnCommand System Manager, point your web browser to the cluster
management IP address (https://[fd20:8b1e:b255:814e:4827:f558:6150:8d5f]).

To access the command-line interface, connect to the cluster management
IP address (for example, ssh admin@fd20:8b1e:b255:814e:4827:f558:6150:8d5f).
cluster1::>

An example of using cluster setup to join a cluster with IPv6 addresses is shown below.

node::> cluster setup
Welcome to the cluster setup wizard.

You can enter the following commands at any time:
  "help" or "?" - if you want to have a question clarified,
  "back" - if you want to change previously answered questions, and
  "exit" or "quit" - if you want to quit the cluster setup wizard.
     Any changes you made before quitting will be saved.

You can return to cluster setup at any time by typing "cluster setup".
To accept a default or omit a question, do not enter a value.

This system will send event messages and periodic reports to NetApp Technical
Support. To disable this feature, enter
autosupport modify -support disable
within 24 hours.

Enabling AutoSupport can significantly speed problem determination
and resolution, should a problem occur on your system.
For further information on AutoSupport, see:
http://support.netapp.com/autosupport/

Type yes to confirm and continue {yes}: yes

Enter the node management interface port [e0c]:
Enter the node management interface IP address: FD20:8B1E:B255:814E:3A9F:9EBC:BF57:7A89
You are trying to create an IPv6 address. Creating an IPv6 address will enable
IPv6 on this node.

Type yes to confirm and continue {yes, no}: yes
Enter the node management interface prefix length: 64
Enter the node management interface default gateway: FD20:8B1E:B255:814E:0000:0000:0000:0001
A node management interface on port e0c with IP address fd20:8b1e:b255:814e:3a9f:9ebc:bf57:7a89 has been created.

Use your web browser to complete cluster setup by accessing
https://[fd20:8b1e:b255:814e:3a9f:9ebc:bf57:7a89]

Otherwise, press Enter to complete cluster setup using the command line
interface:
Do you want to create a new cluster or join an existing cluster? {create, join}:
join
Existing cluster interface configuration found:

Port  MTU  IP    Netmask
e0a  9000  172.31.6.251  255.255.192.0
e0b  9000  172.31.6.252  255.255.192.0

Do you want to use this configuration? {yes, no} [yes]:
Step 1 of 3: Join an Existing Cluster
You can type "back", "exit", or "help" at any question.
Enter the IP address of an interface on the private cluster network from the
cluster you want to join: 172.31.6.130

Joining cluster at address 172.31.6.130

Starting cluster support services ....

This node has joined the cluster cluster1.
Step 2 of 3: Configure Storage Failover (SFO)
You can type "back", "exit", or "help" at any question.
SFO will not be enabled on a non-HA system.
Step 3 of 3: Set Up the Node
You can type "back", "exit", or "help" at any question.
This node has been joined to cluster "cluster1".

To complete cluster setup, you must join each additional node to the cluster
by running "system node show-discovered" and "cluster add-node" from a node in the cluster.
To complete system configuration, you can use either OnCommand System Manager
or the ONTAP command-line interface.

To access OnCommand System Manager, point your web browser to the cluster
management IP address (https://[fd20:8b1e:b255:814e:4827:f558:6150:8d5f]).

To access the command-line interface, connect to the cluster management
IP address (for example, ssh admin@fd20:8b1e:b255:814e:4827:f558:6150:8d5f).
cluster1::>