Skip to content

Why can't I mount my Amazon EFS file system on my Amazon EC2 instance?

3 minute read
0

I tried to mount an Amazon Elastic File System (Amazon EFS) file system on my Amazon Elastic Compute Cloud (Amazon EC2) instance. However, the mount failed.

Resolution

Troubleshoot EFS file system mount failure

For a list of mount issues and resolutions, see Troubleshooting mount issues.

To confirm that your instance adheres to the file system mount requirements, run the AWSSupport-CheckAndMountEFS runbook.

Before you run the automation, make sure that your service role for Automation has the correct AWS Identity and Access Management (IAM) permissions. For more information, see the Required IAM permissions section of AWSSupport-CheckAndMountEFS.

Run the automation document and configure the following settings for Input parameters:

  • (Optional) For AutomationAssumeRole, enter the Amazon Resource Name (ARN) of the role for the automation to perform the actions for you.
  • For InstanceId, enter the ID of the instance that you want to mount the file system on.
  • For EfsId, enter the ID of the file system that you want to mount.
  • For Region, enter the AWS Region where the instance and file system are located.
  • For Action, choose Check to verify only the prerequisites. Or, choose CheckandMount to verify the prerequisites, and then mount the file system.
  • (Optional) For MountTargetIP, enter the mount target's IP address.
    Note: In environments where you deactivated DNS, you can use your IP address to mount. You can also use this option for environments that use a DNS provider other than Amazon Route 53.
  • (Optional) For MountOptions, choose the options that you want to use when you mount the file system. If you specify the tls option, then make sure to upgrade stunnel for your target instance.
  • (Optional) For MountPoint, enter the directory where you want to mount the file system.
    Note: If you select Check for Action, then don't enter a directory.

After the automation completes, review the Outputs section for detailed information about the items that you must manually update. The output includes information about the following elements:

Troubleshoot Amazon EFS storage that didn't automatically mount

If Amazon EFS storage failed to automatically mount, then see Why doesn't my Amazon EFS file system automatically mount when I reboot my Amazon EC2 instance?

Troubleshoot connections where the Amazon EFS server doesn't respond

If you receive the server not responding error, then see How do I troubleshoot the error "nfs: server 127.0.0.1 not responding" when I mount my Amazon EFS file system?

Troubleshoot Amazon EFS performance issues

If you experience slow performance when you try to mount your file system, then see Why is my Amazon EFS file system performance slow?

To identify the best throughput mode for your workload, see What is the right throughput mode for my workload in Amazon EFS?

Related information

Recommended NFS mount settings

Performance summary

Run an automated operation powered by Systems Manager Automation

Setting up Automation

AWS OFFICIALUpdated 6 months ago