NFS Configuration Express Guide: Ontap 9
NFS Configuration Express Guide: Ontap 9
Contents
Deciding whether to use this guide ............................................................. 4
NFS configuration workflow ....................................................................... 5
Creating an aggregate .................................................................................................. 5
Deciding where to provision the new volume ............................................................. 6
Creating a new NFS-enabled SVM ............................................................. 7
Creating a new SVM with an NFS volume and export ............................................... 7
Opening the export policy of the SVM root volume (Creating a new NFS-
enabled SVM) ...................................................................................................... 11
Configuring LDAP (Creating a new NFS-enabled SVM) ......................................... 12
Verifying NFS access from a UNIX administration host .......................................... 14
Configuring and verifying NFS client access (Creating a new NFS-enabled
SVM) ................................................................................................................... 15
Configuring NFS access to an existing SVM ............................................ 17
Adding NFS access to an existing SVM ................................................................... 17
Opening the export policy of the SVM root volume(Configuring NFS access to
an existing SVM) ................................................................................................. 19
Configuring LDAP (Configuring NFS access to an existing SVM ) ........................ 20
Verifying NFS access from a UNIX administration host .......................................... 23
Configuring and verifying NFS client access (Configuring NFS access to an
existing SVM) ..................................................................................................... 24
Adding an NFS volume to an NFS-enabled SVM ................................... 26
Creating and configuring a volume ........................................................................... 26
Creating an export policy for the volume .................................................................. 27
Verifying NFS access from a UNIX administration host .......................................... 29
Configuring and verifying NFS client access (Adding an NFS volume to an
NFS-enabled SVM) ............................................................................................. 30
Where to find additional information ....................................................... 32
Copyright .................................................................................................... 33
Trademark .................................................................................................. 34
How to send comments about documentation and receive update
notifications ............................................................................................ 35
4
• You want to use best practices, not explore every available option.
• You want to use OnCommand System Manager, not the ONTAP command-line interface or an
automated scripting tool.
Cluster management using System Manager
• Your data network uses the default IPspace, the default broadcast domain, and the default failover
group.
If your data network is flat, using these default objects ensures that LIFs will fail over correctly in
the event of a link failure. If you are not using the default objects, you should refer to the Network
Management Guide for information on how to configure LIF path failover.
• UNIX file permissions will be used to secure the new volume.
If this guide is not suitable for your situation, you should see the following documentation instead:
• NFS management
• NetApp Technical Report 4067: NFS Best Practice and Implementation Guide
• NetApp Technical Report 4073: Secure Unified Authentication
• NetApp Technical Report 3580: NFSv4 Enhancements and Best Practices Guide: Data ONTAP
Implementation
• NetApp Technical Report 4379: Name Services Best Practices Guide
• NetApp Documentation: OnCommand Workflow Automation (current releases)
OnCommand Workflow Automation enables you to run prepackaged workflows that automate
management tasks such as the workflows described in Express Guides.
5
Creating an aggregate
If you do not want to use an existing aggregate, you can create a new aggregate to provide physical
storage to the volume which you are provisioning.
Steps
3. Click Create.
4. Follow the instructions on the screen to create the aggregate using the default RAID-DP
configuration, and then click Create.
Result
The aggregate is created with the specified configuration and added to the list of aggregates in the
Aggregates window.
Choices
• If you want to provision a volume on a new SVM, create a new NFS-enabled SVM.
Creating a new NFS-enabled SVM
You must choose this option if NFS is not enabled on an existing SVM.
• If you want to provision a volume on an existing SVM on which NFS is enabled but not
configured, configure NFS access on the existing SVM.
Configuring NFS access on an existing SVM
You should choose this option if you created the SVM for SAN access by using the relevant
Express Guide.
• If you want to provision a volume on an existing SVM that is fully configured for NFS access,
add an NFS volume to the NFS-enabled SVM.
Adding an NFS volume to an NFS-enabled SVM
7
Steps
1. Creating a new SVM with an NFS volume and export on page 7
2. Opening the export policy of the SVM root volume (Creating a new NFS-enabled SVM) on page
11
3. Configuring LDAP (Creating a new NFS-enabled SVM) on page 12
4. Verifying NFS access from a UNIX administration host on page 14
5. Configuring and verifying NFS client access (Creating a new NFS-enabled SVM) on page 15
• Your network must be configured and the relevant physical ports must be connected to the
network.
• You must know which of the following networking components the SVM will use:
◦ The node and the specific port on that node where the data logical interface (LIF) will be
created
◦ The subnet from which the data LIF's IP address will be provisioned, or optionally the specific
IP address you want to assign to the data LIF
◦ NIS information, if your site uses NIS for name services or name mapping
• The subnet must be routable to all external servers required for services such as Network
Information Service (NIS), Lightweight Directory Access Protocol (LDAP), Active Directory
(AD), and DNS.
• Any external firewalls must be appropriately configured to allow access to network services.
• The time on the AD domain controllers, clients, and SVM must be synchronized to within five
minutes of each other.
Steps
2. Click Create.
3. In the Storage Virtual Machine (SVM) Setup dialog box, create the SVM:
b. Select all the protocols that you have licenses for and that you will eventually use on the
SVM, even if you do not want to configure all the protocols immediately.
If CIFS access is required eventually, you must select CIFS now so that CIFS and NFS clients
can share the same data LIF.
d. Optional: If you enabled the CIFS protocol, change the security style to UNIX.
Selecting the CIFS protocol sets the security style to NTFS by default.
e. Optional: Select the root aggregate to contain the SVM root volume.
The aggregate that you select for the root volume does not determine the location of the data
volume. The aggregate for the data volume is selected automatically when you provision
storage in a later step.
f. Optional: In the DNS Configuration area, ensure that the default DNS search domain and
name servers are the ones that you want to use for this SVM.
4. In the Data LIF Configuration section of the Configure CIFS/NFS protocol page, specify the
details of the LIF that clients will use to access data:
a. Assign an IP address to the LIF automatically from a subnet you specify or manually enter the
address.
b. Click Browse and select a node and port that will be associated with the LIF.
6. If your site uses NIS for name services or name mapping, specify the domain and IP addresses of
the NIS servers.
a. For Export Name, type a name that will be both the export name and the beginning of the
volume name.
b. Specify a size for the volume that will contain the files.
You do not have to specify the aggregate for the volume because it is automatically located on
the aggregate with the most available space.
c. In the Permission field, click Change, and specify an export rule that gives NFSv3 access to a
UNIX administration host, including Superuser access.
10 | NFS Configuration Express Guide
Example
You can create a 10 GB volume named Eng, export it as Eng, and add a rule that gives the
“admin_host” client full access to the export, including Superuser access.
• A data LIF named after the SVM with the suffix “_nfs_lif1”
• An NFS server
• A volume that is located on the aggregate with the most available space and has a name that
matches the name of the export and ends in the suffix “_NFS_volume”
9. For all other protocol configuration pages that are displayed, click Skip and configure the
protocol later.
10. When the SVM Administration page is displayed, configure or defer configuring a separate
administrator for this SVM:
• Enter the requested information and then click Submit & Continue.
11. Review the Summary page, record any information you might require later and then click OK.
NFS clients need to know the IP address of the data LIF.
Creating a new NFS-enabled SVM | 11
Result
A new SVM is created with an NFS server containing a new volume that is exported for an
administrator.
Steps
4. Select the export policy named default, which is applied to the SVM root volume.
6. In the Create Export Rule dialog box, create a rule that opens access to all clients for NFS
clients:
a. In the Client Specification field, enter 0.0.0.0/0 so that the rule applies to all clients.
c. Select NFSv3.
d. Clear all the check boxes except the UNIX check box under Read-Only.
e. Click OK.
12 | NFS Configuration Express Guide
Result
NFSv3 clients can now access any volumes created on the SVM.
Steps
c. In the General tab of the Create LDAP Client window, type the name of the LDAP client
configuration, such as vs0client1.
e. Click Binding, and specify the authentication level, the Bind user and password, the base DN,
and the port.
Creating a new NFS-enabled SVM | 13
b. Click Edit.
c. Ensure that the client you just created is selected in LDAP client name.
6. Give LDAP priority over other sources of user information, such as Network Information Service
(NIS) and local users and groups:
d. Under Name Service Switch, specify LDAP as the preferred name service switch source for
the database types.
LDAP is the primary source of user information for name services and name mapping on this
SVM.
• The client system must have an IP address that is allowed by the export rule you specified earlier.
• You must have the login information for the root user.
Steps
3. Create and mount a new folder using the IP address of the SVM:
Example
The following commands create a folder named test1, mount the vol1 volume at the 192.0.2.130
IP address on the test1 mount folder, and change to the new test1 directory:
4. Create a new file, verify that it exists, and write text to it:
a. Enter touch filename to create a test file.
c. Enter cat >filename, type some text, and then press Ctrl+D to write text to the test file.
Example
Result
You have confirmed that you have enabled NFS access to the SVM.
Steps
1. Decide which clients and users or groups will be given access to the share.
2. On a UNIX administration host, use the root user to set UNIX ownership and permissions on the
volume.
3. In System Manager, add rules to the export policy to permit NFS clients to access the share.
a. Select the storage virtual machine (SVM), and click SVM Settings.
c. Select the export policy with the same name as the volume.
16 | NFS Configuration Express Guide
d. In the Export Rules tab, click Add, and specify a set of clients.
e. Select 2 for the Rule Index so that this rule executes after the rule that allows access to the
administration host.
f. Select NFSv3.
g. Specify the access details that you want, and click OK.
Example
You can give full read/write access to clients by typing the subnet 10.1.1.0/24 as the Client
Specification, and selecting all the access check boxes except Allow Superuser Access.
4. On a UNIX client, log in as one of the users who now has access to the volume, and verify that
you can mount the volume and create a file.
17
Steps
1. Adding NFS access to an existing SVM on page 17
2. Opening the export policy of the SVM root volume(Configuring NFS access to an existing SVM)
on page 19
3. Configuring LDAP (Configuring NFS access to an existing SVM ) on page 20
4. Verifying NFS access from a UNIX administration host on page 23
5. Configuring and verifying NFS client access (Configuring NFS access to an existing SVM) on
page 24
• You must know which of the following networking components the SVM will use:
◦ The node and the specific port on that node where the data logical interface (LIF) will be
created
◦ The subnet from which the data LIF's IP address will be provisioned, or optionally the specific
IP address you want to assign to the data LIF
• Any external firewalls must be appropriately configured to allow access to network services.
Steps
1. Navigate to the area where you can configure the protocols of the SVM:
a. Assign an IP address to the LIF automatically from a subnet you specify or manually enter the
address.
b. Click Browse and select a node and port that will be associated with the LIF.
18 | NFS Configuration Express Guide
3. If your site uses NIS for name services or name mapping, specify the domain and IP addresses of
the NIS servers and select the database types for which you want to add the NIS name service
source.
If NIS services are not available, do not attempt to configure it. Improperly configured NIS
services can cause datastore access issues.
a. For Export Name, type a name that will be both the export name and the beginning of the
volume name.
b. Specify a size for the volume that will contain the files.
You do not have to specify the aggregate for the volume because it is automatically located on
the aggregate with the most available space.
c. In the Permission field, click Change, and specify an export rule that gives NFSv3 access to a
UNIX administration host, including Superuser access.
Configuring NFS access to an existing SVM | 19
Example
You can create a 10 GB volume named Eng, export it as Eng, and add a rule that gives the
“admin_host” client full access to the export, including Superuser access.
Steps
4. Select the export policy named default, which is applied to the SVM root volume.
6. In the Create Export Rule dialog box, create a rule that opens access to all clients for NFS
clients:
a. In the Client Specification field, enter 0.0.0.0/0 so that the rule applies to all clients.
c. Select NFSv3.
d. Clear all the check boxes except the UNIX check box under Read-Only.
e. Click OK.
Result
NFSv3 clients can now access any volumes created on the SVM.
Steps
c. In the General tab of the Create LDAP Client window, type the name of the LDAP client
configuration, such as vs0client1.
e. Click Binding, and specify the authentication level, the Bind user and password, the base DN,
and the port.
b. Click Edit.
c. Ensure that the client you just created is selected in LDAP client name.
22 | NFS Configuration Express Guide
6. Give LDAP priority over other sources of user information, such as Network Information Service
(NIS) and local users and groups:
d. Under Name Service Switch, specify LDAP as the preferred name service switch source for
the database types.
LDAP is the primary source of user information for name services and name mapping on this
SVM.
Configuring NFS access to an existing SVM | 23
• The client system must have an IP address that is allowed by the export rule you specified earlier.
• You must have the login information for the root user.
Steps
3. Create and mount a new folder using the IP address of the SVM:
a. Enter mkdir /mnt/folder to create a new folder.
Example
The following commands create a folder named test1, mount the vol1 volume at the 192.0.2.130
IP address on the test1 mount folder, and change to the new test1 directory:
4. Create a new file, verify that it exists, and write text to it:
c. Enter cat >filename, type some text, and then press Ctrl+D to write text to the test file.
Example
Result
You have confirmed that you have enabled NFS access to the SVM.
Steps
1. Decide which clients and users or groups will be given access to the share.
2. On a UNIX administration host, use the root user to set UNIX ownership and permissions on the
volume.
3. In System Manager, add rules to the export policy to permit NFS clients to access the share.
a. Select the storage virtual machine (SVM), and click SVM Settings.
c. Select the export policy with the same name as the volume.
d. In the Export Rules tab, click Add, and specify a set of clients.
e. Select 2 for the Rule Index so that this rule executes after the rule that allows access to the
administration host.
f. Select NFSv3.
g. Specify the access details that you want, and click OK.
Example
You can give full read/write access to clients by typing the subnet 10.1.1.0/24 as the Client
Specification, and selecting all the access check boxes except Allow Superuser Access.
Configuring NFS access to an existing SVM | 25
4. On a UNIX client, log in as one of the users who now has access to the volume, and verify that
you can mount the volume and create a file.
26
Steps
1. Creating and configuring a volume on page 26
2. Creating an export policy for the volume on page 27
3. Verifying NFS access from a UNIX administration host on page 29
4. Configuring and verifying NFS client access (Adding an NFS volume to an NFS-enabled SVM)
on page 30
Steps
3. If you want to change the default name, which ends in a date and time stamp, specify a new name,
such as vol1.
6. Click Create.
Any new volume created in System Manager is mounted by default at the root volume using the
volume name as the junction name. NFS clients use the junction path and the junction name when
mounting the volume.
7. Optional: If you do not want the volume to be located at the root of the SVM, modify the place of
the new volume in the existing namespace:
c. Click Mount.
d. In the Mount Volume dialog box, specify the volume, the name of its junction path, and the
junction path on which you want the volume mounted.
Adding an NFS volume to an NFS-enabled SVM | 27
Example
If you want to organize certain volumes under a main volume named “data”, you can move the
new volume “vol1” from the root volume to the “data” volume.
a. In the Volume window, select the volume you just created, and click Edit.
The Edit Volume dialog box is displayed, showing the volume's current security style, which
is inherited from the security style of the SVM root volume.
Steps
a. In the Policies pane, click Export Policies and then click Create.
c. Under Export Rules, click Add to add a rule to the new policy.
28 | NFS Configuration Express Guide
4. In the Create Export Rule dialog box, create a rule that allows an administrator full access to the
export through all protocols:
a. Specify the IP address or client name, such as admin_host, from which the exported volume
will be administered.
b. Select NFSv3.
c. Ensure that all Read/Write access details are selected, as well as Allow Superuser Access.
The new export policy is created, along with its new rule.
5. Apply the new export policy to the new volume so that the administrator host can access the
volume:
Related tasks
Verifying NFS access from a UNIX administration host on page 14
Adding an NFS volume to an NFS-enabled SVM | 29
• The client system must have an IP address that is allowed by the export rule you specified earlier.
• You must have the login information for the root user.
Steps
3. Create and mount a new folder using the IP address of the SVM:
a. Enter mkdir /mnt/folder to create a new folder.
Example
The following commands create a folder named test1, mount the vol1 volume at the 192.0.2.130
IP address on the test1 mount folder, and change to the new test1 directory:
4. Create a new file, verify that it exists, and write text to it:
c. Enter cat >filename, type some text, and then press Ctrl+D to write text to the test file.
Example
Result
You have confirmed that you have enabled NFS access to the SVM.
Steps
1. Decide which clients and users or groups will be given access to the share.
2. On a UNIX administration host, use the root user to set UNIX ownership and permissions on the
volume.
3. In System Manager, add rules to the export policy to permit NFS clients to access the share.
a. Select the storage virtual machine (SVM), and click SVM Settings.
c. Select the export policy with the same name as the volume.
d. In the Export Rules tab, click Add, and specify a set of clients.
e. Select 2 for the Rule Index so that this rule executes after the rule that allows access to the
administration host.
f. Select NFSv3.
g. Specify the access details that you want, and click OK.
Example
You can give full read/write access to clients by typing the subnet 10.1.1.0/24 as the Client
Specification, and selecting all the access check boxes except Allow Superuser Access.
Adding an NFS volume to an NFS-enabled SVM | 31
4. On a UNIX client, log in as one of the users who now has access to the volume, and verify that
you can mount the volume and create a file.
32
NFS configuration
You can further configure NFS access using the following comprehensive guides and technical
reports:
• NFS management
Describes how to configure and manage file access using the NFS protocol.
• NetApp Technical Report 4067: NFS Best Practice and Implementation Guide
Serves as an NFSv3 and NFSv4 operational guide and provides an overview of ONTAP operating
system with a focus on NFSv4.
• NetApp Technical Report 3580: NFSv4 Enhancements and Best Practices Guide: Data ONTAP
Implementation
Describes the best practices that should be followed while implementing NFSv4 components on
AIX, Linux, or Solaris clients attached to systems running ONTAP.
• Data protection
Describes how to create a load-sharing mirror to protect the SVM root volume, which is a
NetApp best practice for NAS-enabled SVMs. Also describes how to quickly recover from
volume failures or losses by promoting the SVM root volume from a load-sharing mirror
33
Copyright
Copyright © 2019 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.
Data contained herein pertains to a commercial item (as defined in FAR 2.101) and is proprietary to
NetApp, Inc. The U.S. Government has a non-exclusive, non-transferrable, non-sublicensable,
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).
34
Trademark
NETAPP, the NETAPP logo, and the marks listed on the NetApp Trademarks page are trademarks of
NetApp, Inc. Other company and product names may be trademarks of their respective owners.
http://www.netapp.com/us/legal/netapptmlist.aspx
35