Set Up ONTAP
Set Up ONTAP
ONTAP 9
NetApp
October 31, 2023
It is only necessary to use the ONTAP CLI to set up your cluster if you are running ONTAP 9.7 or earlier on a
MetroCluster configuration. Beginning in ONTAP 9.13.1, on the AFF A800 and FAS8700 platforms, you can
also use the ONTAP CLI to create and configure new clusters in IPv6-only networking environments. If you
need to use IPv6 in ONTAP 9.13.0 and earlier, or on other platforms in ONTAP 9.13.1 and later, you can use
System Manager to create new clusters using IPv4 and then convert to IPv6.
If you are configuring a FlexArray on non-NetApp disks, you need to use the ONTAP CLI to configure root
volumes on the array LUNs, and then use the Cluster Setup wizard to set up your cluster. For more
information, see the FlexArray Virtualization installation and requirements documentation.
The cluster setup worksheet enables you to record the values that you need during the cluster setup process.
If a default value is provided, you can use that value or else enter your own.
System defaults
The system defaults are the default values for the private cluster network. It is best to use these default values.
However, if they do not meet your requirements, you can use the table to record your own values.
For clusters configured to use network switches, each cluster switch must use the 9000 MTU
size.
1
Types of information Your values
Cluster interface IP addresses (for each cluster
network port on each node)
Cluster information
Cluster name
.-_
You can find license keys for your initial or add-on software orders at the NetApp Support Site under My
Support > Software Licenses.
2
Types of information Your values
Cluster management interface port
Example: 192.0.2.66
Example: 255.255.255.0
Example: 64
3
Types of information Your values
Name server IP addresses
Example: 192.0.2.66
Example: 255.255.255.0
4
Types of information Your values
Node management interface netmask length (IPv6)
Example: 64
In ONTAP 9.6 and earlier, System Manager does not support deployments that require IPv6
5
networking.
◦ MetroCluster setup support is for MetroCluster IP configurations with two nodes at each site.
In ONTAP 9.7 and earlier, System Manager does not support new cluster setup for MetroCluster
configurations.
Windows System
You should connect your Windows computer to the same subnet as the controllers. This will automatically
assign a node-management IP address to your system.
Step
1. From the Windows system, open the Network drive to discover the nodes.
2. Double-click the node to launch the cluster setup wizard.
Other systems
You should configure the node-management IP address for one of the nodes in your cluster. You can use this
node-management IP address to launch the cluster set up wizard.
See Creating the cluster on the first node for information about assigning a node-management IP address.
Steps
1. On a web browser, enter the node-management IP address that you have configured: "https://node-
management-IP"
2. Initialize the storage system by configuring the cluster management network and node management IP
addresses for all the nodes.
Steps
6
1. Click Dashboard and then click Prepare Storage.
Configure protocols
Depending on the licenses enabled on your cluster, you can enable the desired protocols on your cluster. You
then create network interfaces using which you can access the storage.
Steps
1. Click Dashboard and then click Configure Protocols.
◦ Enable iSCSI or FC for SAN access.
◦ Enable NFS or SMB for NAS access.
◦ Enable NVMe for FC-NVMe access.
Provision Storage
You can now provision storage. The options you see depends on the licenses that are installed.
Steps
1. Click Dashboard and then click Provision Storage.
◦ To provision SAN access, click Add LUNs.
◦ To provision NAS access, click Add Volumes.
◦ To provision NVMe storage, click Add Namespaces.
7
Set up a cluster with the CLI
Create the cluster on the first node
You use the Cluster Setup wizard to create the cluster on the first node. The wizard helps
you to configure the cluster network that connects the nodes, create the cluster admin
storage virtual machine (SVM), add feature license keys, and create the node
management interface for the first node.
Before you begin
• You should have installed, cabled and powered on your new storage system according to the installation
and setup instructions for your platform model.
See the AFF and FAS documentation.
• Cluster network interfaces should be configured on each node of the cluster for intra-cluster
communication.
• If you are configuring IPv6 on your cluster, IPv6 should be configured on the Base Management Controller
(BMC) so that you can access the system using SSH.
Steps
1. Power on all the nodes you are adding to the cluster. This is required to enable discovery for your cluster
setup.
2. Connect to the console of the first node.
The node boots, and then the Cluster Setup wizard starts on the console.
Beginning in ONTAP 9.13.1, you can assign IPv6 addresses for management LIFs on A800 and FAS8700
platforms. For ONTAP releases earlier than 9.13.1, or for 9.13.1 and later on other platforms, you must
assign IPv4 addresses for management LIFs, then convert to IPv6 after you complete cluster setup.
8
7. Accept the system defaults or enter your own values.
8. After setup is completed, log in to the cluster and verify that the cluster is active and the first node is
healthy by entering the ONTAP CLI command: cluster show
The following example shows a cluster in which the first node (cluster1-01) is healthy and eligible to
participate:
You can access the Cluster Setup wizard to change any of the values you entered for the admin SVM or
node SVM by using the cluster setup command.
You can only join one node to the cluster at a time. When you start to join a node to the cluster, you must
complete the join operation for that node, and the node must be part of the cluster before you can start to join
the next node.
Best Practice: If you have a FAS2720 with 24 or fewer NL-SAS drives, you should verify that the storage
configuration default is set to active/passive to optimize performance.
For more information, see Setting up an active-passive configuration on nodes using root-data partitioning
9
3. Follow the instructions on the screen to assign an IP address to the node.
Beginning in ONTAP 9.13.1, you can assign IPv6 addresses for management LIFs on A800 and FAS8700
platforms. For ONTAP releases earlier than 9.13.1, or for 9.13.1 and later on other platforms, you must
assign IPv4 addresses for management LIFs, then convert to IPv6 after you complete cluster setup.
The following example shows a cluster after the second node (cluster1-02) has been joined to the cluster:
You can access the Cluster Setup wizard to change any of the values you entered for the admin SVM or
node SVM by using the cluster setup command.
10
2. Set privilege to advanced:
Use the format prefix::id in the address parameter to construct the IPv6 address manually.
network ping6
11
Check your cluster with Active IQ Config Advisor
After you have joined all the nodes to your new cluster, you should run Active IQ Config
Advisor to validate your configuration and check for common configuration errors.
Config Advisor is a web-based application that you install on your laptop, virtual machine or a server, and
works across Windows, Linux, and Mac platforms.
Config Advisor runs a series of commands to validate your installation and check the overall health of the
configuration, including the cluster and storage switches.
You synchronize the time across the cluster by associating the cluster with one or more NTP servers.
1. Verify that the system time and time zone is set correctly for each node.
All nodes in the cluster should be set to the same time zone.
a. Use the cluster date show command to display the current date, time, and time zone for each node.
12
cluster1::> cluster date show
Node Date Time zone
------------ ------------------- -----------------
cluster1-01 01/06/2015 09:35:15 America/New_York
cluster1-02 01/06/2015 09:35:15 America/New_York
cluster1-03 01/06/2015 09:35:15 America/New_York
cluster1-04 01/06/2015 09:35:15 America/New_York
4 entries were displayed.
b. Use the cluster date modify command to change the date or time zone for all of the nodes.
This example changes the time zone for the cluster to be GMT:
2. Use the cluster time-service ntp server create command to associate the cluster with your NTP server.
◦ To set up your NTP server without symmetric authentication enter the following command: cluster
time-service ntp server create -server server_name
◦ To set up your NTP server with symmetric authentication, enter the following command: cluster
time-service ntp server create -server server_ip_address -key-id key_id
This example assumes that DNS has been configured for the cluster. If you have not configured DNS,
you must specify the IP address of the NTP server:
3. Verify that the cluster is associated with an NTP server: cluster time-service ntp server show
Related information
System administration
13
Commands for managing symmetric authentication on NTP servers
Beginning with ONTAP 9.5, Network Time Protocol (NTP) version 3 is supported. NTPv3
includes symmetric authentication using SHA-1 keys which increases network security.
Configure an NTP server with symmetric cluster time-service ntp server create
authentication -server server_ip_address -key-id
key_id
Enable symmetric authentication for an existing NTP cluster time-service ntp server modify
server -server server_name -key-id key_id
Configure a shared NTP key cluster time-service ntp key create -id
shared_key_id -type shared_key_type
-value shared_key_value
Configure an NTP server with an unknown key ID cluster time-service ntp server create
-server server_name -key-id key_id
Configure a server with a key ID not configured on the cluster time-service ntp server create
NTP server. -server server_name -key-id key_id
14
System configuration task Resource
Configure networking: Setting up the network
SAN administration
Set up an ASA
All SAN Arrays (ASAs) follow the same setup procedure as non-ASA systems.
System Manager guides you through the procedures necessary to initialize your cluster, create a local tier,
configure protocols, and provision storage for your ASA.
Host settings for setting up All SAN Arrays (ASAs) are the same as those for all other SAN hosts.
You can download the NetApp Host Utilities software for your specific hosts from the support site.
You can identify an ASA system using System Manager or using the ONTAP command line interface (CLI).
15
• From the System Manager dashboard: Click Cluster > Overview and then select the system node.
The "All SAN Array" value returns as true for ASA systems.
Related information
• Technical Report 4968: NetApp All-SAN Array Data Availability and Integrity
• Technical Report 4080: Best Practices for Scalable SAN ONTAP 9
ASA support for SAN protocols and nodes per cluster are as follows:
9.7 • FC 4
• iSCSI
Beginning with ONTAP 9.8, persistent ports are enabled by default on All SAN Arrays (ASAs) that are
configured to use the FC protocol. Persistent ports are only available for FC and require zone membership
identified by World Wide Port Name (WWPN).
Persistent ports reduce the impact of takeovers by creating a shadow LIF on the corresponding physical port of
the HA partner. When a node is taken over, the shadow LIF on the partner node assumes the identity of the
original LIF, including the WWPNe. Before the status of path to the taken over node is changed to faulty, the
shadow LIF appears as an Active/Optimized path to the host MPIO stack, and I/O is shifted. This reduces I/O
16
disruption because the host always sees the same number of paths to the target, even during storage failover
operations.
For persistent ports, the following FCP port characteristics should be identical within the HA pair:
If any of these characteristics are not identical within the HA pair, the following EMS message is generated:
EMS : scsiblade.lif.persistent.ports.fcp.init.error
For more information on persistent ports, see NetApp Technical Report 4080: Best Practices for Scalable SAN
ONTAP 9.
17
Copyright information
Copyright © 2023 NetApp, Inc. All Rights Reserved. Printed in the U.S. No part of this document covered by
copyright may be reproduced in any form or by any means—graphic, electronic, or mechanical, including
photocopying, recording, taping, or storage in an electronic retrieval system—without prior written permission
of the copyright owner.
Software derived from copyrighted NetApp material is subject to the following license and disclaimer:
THIS SOFTWARE IS PROVIDED BY NETAPP “AS IS” AND WITHOUT ANY EXPRESS OR IMPLIED
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
AND FITNESS FOR A PARTICULAR PURPOSE, WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL
NETAPP BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
NetApp reserves the right to change any products described herein at any time, and without notice. NetApp
assumes no responsibility or liability arising from the use of products described herein, except as expressly
agreed to in writing by NetApp. The use or purchase of this product does not convey a license under any
patent rights, trademark rights, or any other intellectual property rights of NetApp.
The product described in this manual may be protected by one or more U.S. patents, foreign patents, or
pending applications.
LIMITED RIGHTS LEGEND: Use, duplication, or disclosure by the government is subject to restrictions as set
forth in subparagraph (b)(3) of the Rights in Technical Data -Noncommercial Items at DFARS 252.227-7013
(FEB 2014) and FAR 52.227-19 (DEC 2007).
Data contained herein pertains to a commercial product and/or commercial service (as defined in FAR 2.101)
and is proprietary to NetApp, Inc. All NetApp technical data and computer software provided under this
Agreement is commercial in nature and developed solely at private expense. The U.S. Government has a non-
exclusive, non-transferrable, nonsublicensable, worldwide, limited irrevocable license to use the Data only in
connection with and in support of the U.S. Government contract under which the Data was delivered. Except
as provided herein, the Data may not be used, disclosed, reproduced, modified, performed, or displayed
without the prior written approval of NetApp, Inc. United States Government license rights for the Department
of Defense are limited to those rights identified in DFARS clause 252.227-7015(b) (FEB 2014).
Trademark information
NETAPP, the NETAPP logo, and the marks listed at http://www.netapp.com/TM are trademarks of NetApp, Inc.
Other company and product names may be trademarks of their respective owners.
18