Create an NFS Export

IN THIS ARTICLE 

This article explains how you can use Qumulo Core to create an NFS Export. For more information about working with NFS, see Enabling and Using NFSv4.1 on a Qumulo Cluster and Managing File Access Permissions Using NFSv4.1 Access Control Lists (ACLs).

REQUIREMENTS

• Admin privileges required
• Cluster running Qumulo Core

DETAILS

NFS Exports Page Overview

In the Web UI, hover over Sharing and click NFS Exports from the dropdown.

A list of NFS Exports will display with the following details:

• Exports: Name of the NFS Export
• File system path: The directory path of the NFS Export
• Allowed IPs: Details whether all or some of the IPs are allowed access
• User Mapping: Displays whether User Mapping is enabled
• Read-only: Displays whether Read-only access is configured
• Actions: Displays available actions for the export (edit/delete)

Create an NFS Export

Click Create on the NFS Exports page.

Fill in the following fields:

• File system path: The directory path of the NFS Export
• Create new directory if it doesn't exist
• Export path: The NFS Export name that the client will mount to
• Description: A description of the export (optional)

Host Access Rules

The Host Access Rules section allows you to specify one or multiple rules that govern how hosts access the export. By default, a rule is created for each export that includes no restrictions on access. Configure the following fields based on the needs of your deployment.

• Allowed IPs: A list of IP addresses that the export can be restricted to—this list can be a single IP, a range of IP addresses, or an entire subnet. Only the specified IPs will have access to the NFS export. By default, all IPs are allowed.
  
• Read-only: Enables the Export to have read-only access. This feature is disabled by default.
• User Mapping: User Mapping converts the incoming username or UID of an NFS user into the value specified in the NFS export's settings.
  • In Qumulo Core 3.0.3 or below, you can specify a username using the drop-down menu provided for each option.
  • In Qumulo Core 3.0.4 or above, you can specify either a username or a UID by typing in “uid:” followed by the identifier. Once “uid:” is entered, a Group Mapping field will appear so that you can enter the GID. A GID is required if using a UID for user mapping. The GID doesn’t need to be prepended with anything, since the text box already indicates that it only accepts GIDs.

NOTE: In Qumulo Core 3.0.4 or above, you can add more than one Host Access Rule by clicking + Add a Host Access Rule. Host access rules will be enforced in the order in which they appear, starting from the top of the page. To prevent unintended results, list IP-specific rules at the top of the list and subnet-wide rules at the bottom.

Click Save to create the new export and add it to the NFS Exports page.

Edit or Delete an NFS Export

• To Edit an existing NFS Export, click the pencil icon next to the listing on the NFS Exports page
• Delete an NFS Export by clicking the trashcan icon 
  
  
  
  
• Confirm the delete of an NFS export by selecting Yes, Delete Export when prompted or click Cancel
  
  

RESOLUTION 

You should now be able to successfully create an NFS Export in Qumulo Core

ADDITIONAL RESOURCES

Video: Create an NFS Export

QQ CLI: NFS Exports

Like what you see? Share this article with your network!