AWS DataSync
User Guide

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.

Creating a Location for NFS

DataSync supports the NFS v3, NFS v4.0, and NFS v4.1 protocols.

To create an NFS location

  1. Open the AWS DataSync console at https://console.aws.amazon.com/datasync/.

  2. In the navigation pane, choose Locations. The locations that you previously created appear in the list of locations.

  3. acquan

    On the Locations page, choose Create location.

  4. For Location type, choose NFS. You configure this location as a source or destination later.

  5. For Agents, choose the agent that you want to use. If you have previously created agents, the agents appear in the list. The agent connects to your on-premises NFS server and makes it easier to securely transfer data between the on-premises location and AWS.

  6. For NFS server, provide the DNS name or IP address of the NFS server.

    DataSync automatically chooses the NFS version that it uses to read from an NFS location. If you need to force DataSync to use a specific NFS version, use the optional Version parameter for the NfsMountOptions API operation.

  7. For Mount path, enter the mount path for your NFS location.

  8. (Optional) For Key and Value, enter a key and value to tag your NFS location. A tag is a key-value pair that helps you manage, filter, and search for your locations.

  9. When you are done, choose Create location.

For detailed information about these NFS location settings, see NFS Location Settings.

NFS Location Settings

Following, you can find descriptions for the configuration settings for NFS locations in DataSync.

Agent

An agent is a VM that is deployed in your on-premises environment to connect to your on-premises location. An agent makes it easier to securely transfer data between the on-premises location and AWS. You can use an agent for more than one location.

If a task is using multiple agents, all the agents need to have the status Available for the task to run. If you use multiple agents for a source location, the status of all the agents must be Available for the task to run. Agents are automatically updated by AWS on a regular basis, using a mechanism that doesn't interrupt your tasks.

NFS server

The name of the NFS server, the IP address or DNS name of the NFS server. An agent that is installed on-premises uses this name to mount the NFS server in a network.

Mount path

The mount path for your NFS file system. This path must be a path that's exported by the NFS server, or a subdirectory of an exported path. This path should be such that it can be mounted by other NFS clients in your network. For information about how to resolve mount path issues, see Your Task Status Is Unavailable and Status Indicates a Mount Error.

To transfer all the data in the folder you specified, DataSync needs to have permissions to read all the data. To ensure this, either configure the NFS export with no_root_squash, or ensure that the permissions for all of the files you want DataSync to allow read access for all users. Doing either enables the agent to read the files. For the agent to access directories, you must additionally enable all execute access.

Tag

A tag is a key-value pair that helps you manage, filter, and search for your location. Adding a tag is optional. We recommend using tags for naming your resources.

Note

DataSync supports the NFS v3, NFS v4.0, and NFS v4.1 protocols. DataSync automatically chooses the NFS version that it uses when reading from an NFS location. If you need to force DataSync to use a specific NFS version, see You Need DataSync to Use a Specific NFS or SMB Version to Mount Your Share.

On this page: