cluster setup
Setup wizard
Availability: This command is available to cluster administrators at the admin privilege level.
Description
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
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::>