Skip to content

Commit ff0b181

Browse files
committed
add clear steps to NFS mount article
1 parent f4fdeb0 commit ff0b181

File tree

1 file changed

+43
-35
lines changed

1 file changed

+43
-35
lines changed

articles/storage/files/storage-files-how-to-mount-nfs-shares.md

Lines changed: 43 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,13 @@
11
---
22
title: Mount an NFS Azure file share on Linux
3-
description: Learn how to mount a Network File System (NFS) Azure file share on Linux, including prerequisites and mount options.
3+
description: Learn how to mount a Network File System (NFS) Azure file share on Linux, including configuring network security and mount options.
44
author: khdownie
55
ms.service: azure-file-storage
66
ms.custom: linux-related-content
77
ms.topic: how-to
8-
ms.date: 05/09/2024
8+
ms.date: 10/14/2024
99
ms.author: kendownie
10+
ms.custom: references_regions
1011
---
1112

1213
# Mount NFS Azure file shares on Linux
@@ -25,25 +26,30 @@ Azure file shares can be mounted in Linux distributions using either the Server
2526

2627
[!INCLUDE [files-nfs-limitations](../../../includes/files-nfs-limitations.md)]
2728

28-
### Regional availability
29+
## Regional availability
2930

30-
[!INCLUDE [files-nfs-regional-availability](~/reusable-content/ce-skilling/azure/includes/files-nfs-regional-availability.md)]
31+
NFS Azure file shares are supported in all the same regions that support premium file storage. See [Azure products available by region](https://azure.microsoft.com/explore/global-infrastructure/products-by-region/?products=storage&regions=all).
3132

32-
## Prerequisites
33+
## Step 1: Create an NFS Azure file share
3334

34-
- [Create an NFS share](storage-files-how-to-create-nfs-shares.md).
35-
- Open port 2049 on the client you want to mount your NFS share to.
35+
If you haven't already done so, [create an NFS Azure file share](storage-files-how-to-create-nfs-shares.md).
3636

37-
> [!IMPORTANT]
38-
> NFS shares can only be accessed from trusted networks.
37+
## Step 2: Configure network security
3938

40-
- Either [create a private endpoint](storage-files-networking-endpoints.md#create-a-private-endpoint) (recommended) or [restrict access to your public endpoint](storage-files-networking-endpoints.md#restrict-public-endpoint-access).
41-
- To enable hybrid access to an NFS Azure file share, use one of the following networking solutions:
42-
- [Configure a Point-to-Site (P2S) VPN on Linux for use with Azure Files](storage-files-configure-p2s-vpn-linux.md).
43-
- [Configure a Site-to-Site VPN for use with Azure Files](storage-files-configure-s2s-vpn.md).
44-
- Configure [ExpressRoute](../../expressroute/expressroute-introduction.md).
39+
NFS shares can only be accessed from trusted networks. Currently, the only way to secure the data in your storage account is by using a virtual network and other network security settings. Any other tools used to secure data, including account key authorization, Microsoft Entra security, and access control lists (ACLs) can't be used to authorize an NFSv4.1 request.
4540

46-
## Disable secure transfer
41+
> [!IMPORTANT]
42+
> The NFSv4.1 protocol runs on port 2049. If you're connecting from an on-premises network, make sure that your client allows outgoing communication through those ports. If you've granted access to specific VNets, make sure that any network security groups associated with those VNets don't contain security rules that block incoming communication through those ports.
43+
44+
To use NFS Azure file shares, you must either [create a private endpoint](storage-files-networking-endpoints.md#create-a-private-endpoint) (recommended) or [restrict access to your public endpoint](storage-files-networking-endpoints.md#restrict-public-endpoint-access).
45+
46+
To enable hybrid access to an NFS Azure file share, use one of the following networking solutions:
47+
48+
- [Configure a Point-to-Site (P2S) VPN](storage-files-configure-p2s-vpn-linux.md).
49+
- [Configure a Site-to-Site VPN](storage-files-configure-s2s-vpn.md).
50+
- Configure [ExpressRoute](../../expressroute/expressroute-introduction.md).
51+
52+
Azure Files doesn't currently support encryption-in-transit with the NFS protocol and relies instead on network-level security. Therefore, you'll need to disable secure transfer on your storage account.
4753

4854
1. Sign in to the [Azure portal](https://portal.azure.com/) and access the storage account containing the NFS share you created.
4955
1. Select **Configuration**.
@@ -52,24 +58,13 @@ Azure file shares can be mounted in Linux distributions using either the Server
5258

5359
:::image type="content" source="media/storage-files-how-to-mount-nfs-shares/disable-secure-transfer.png" alt-text="Screenshot of storage account configuration screen with secure transfer disabled." lightbox="media/storage-files-how-to-mount-nfs-shares/disable-secure-transfer.png":::
5460

55-
## Mount options
61+
## Step 3: Mount an NFS Azure file share
5662

57-
The following mount options are recommended or required when mounting NFS Azure file shares.
63+
You can mount the share using the Azure portal. You can also create a record in the **/etc/fstab** file to automatically mount the share every time the Linux server or VM boots.
5864

59-
| **Mount option** | **Recommended value** | **Description** |
60-
|******************|***********************|*****************|
61-
| `vers` | 4 | Required. Specifies which version of the NFS protocol to use. Azure Files only supports NFS v4.1. |
62-
| `minorversion` | 1 | Required. Specifies the minor version of the NFS protocol. Some Linux distros don't recognize minor versions on the `vers` parameter. So instead of `vers=4.1`, use `vers=4,minorversion=1`. |
63-
| `sec` | sys | Required. Specifies the type of security to use when authenticating an NFS connection. Setting `sec=sys` uses the local UNIX UIDs and GIDs that use AUTH_SYS to authenticate NFS operations. |
64-
| `rsize` | 1048576 | Recommended. Sets the maximum number of bytes to be transferred in a single NFS read operation. Specifying the maximum level of 1048576 bytes will usually result in the best performance. |
65-
| `wsize` | 1048576 | Recommended. Sets the maximum number of bytes to be transferred in a single NFS write operation. Specifying the maximum level of 1048576 bytes will usually result in the best performance. |
66-
| `noresvport` | n/a | Recommended. Tells the NFS client to use a non-privileged source port when communicating with an NFS server for the mount point. Using the `noresvport` mount option helps ensure that your NFS share has uninterrupted availability after a reconnection. Using this option is strongly recommended for achieving high availability. |
67-
| `actimeo` | 30-60 | Recommended. Specifying `actimeo` sets all of `acregmin`, `acregmax`, `acdirmin`, and `acdirmax` to the same value. Using a value lower than 30 seconds can cause performance degradation because attribute caches for files and directories expire too quickly. We recommend setting `actimeo` between 30 and 60 seconds. |
65+
### Mount an NFS share using the Azure portal
6866

69-
## Mount an NFS share using the Azure portal
70-
71-
> [!NOTE]
72-
> You can use the `nconnect` Linux mount option to improve performance for NFS Azure file shares at scale. For more information, see [Improve NFS Azure file share performance](nfs-performance.md#nconnect).
67+
You can use the `nconnect` Linux mount option to improve performance for NFS Azure file shares at scale. For more information, see [Improve NFS Azure file share performance](nfs-performance.md#nconnect).
7368

7469
1. Once the file share is created, select the share and select **Connect from Linux**.
7570
1. Enter the mount path you'd like to use, then copy the script.
@@ -79,7 +74,7 @@ The following mount options are recommended or required when mounting NFS Azure
7974

8075
You have now mounted your NFS share.
8176

82-
## Mount an NFS share using /etc/fstab
77+
### Mount an NFS share using /etc/fstab
8378

8479
If you want the NFS file share to automatically mount every time the Linux server or VM boots, create a record in the **/etc/fstab** file for your Azure file share. Replace `YourStorageAccountName` and `FileShareName` with your information.
8580

@@ -89,7 +84,21 @@ If you want the NFS file share to automatically mount every time the Linux serve
8984

9085
For more information, enter the command `man fstab` from the Linux command line.
9186

92-
### Validate connectivity
87+
### Mount options
88+
89+
The following mount options are recommended or required when mounting NFS Azure file shares.
90+
91+
| **Mount option** | **Recommended value** | **Description** |
92+
|******************|***********************|*****************|
93+
| `vers` | 4 | Required. Specifies which version of the NFS protocol to use. Azure Files only supports NFSv4.1. |
94+
| `minorversion` | 1 | Required. Specifies the minor version of the NFS protocol. Some Linux distros don't recognize minor versions on the `vers` parameter. So instead of `vers=4.1`, use `vers=4,minorversion=1`. |
95+
| `sec` | sys | Required. Specifies the type of security to use when authenticating an NFS connection. Setting `sec=sys` uses the local UNIX UIDs and GIDs that use AUTH_SYS to authenticate NFS operations. |
96+
| `rsize` | 1048576 | Recommended. Sets the maximum number of bytes to be transferred in a single NFS read operation. Specifying the maximum level of 1048576 bytes will usually result in the best performance. |
97+
| `wsize` | 1048576 | Recommended. Sets the maximum number of bytes to be transferred in a single NFS write operation. Specifying the maximum level of 1048576 bytes will usually result in the best performance. |
98+
| `noresvport` | n/a | Recommended. Tells the NFS client to use a non-privileged source port when communicating with an NFS server for the mount point. Using the `noresvport` mount option helps ensure that your NFS share has uninterrupted availability after a reconnection. Using this option is strongly recommended for achieving high availability. |
99+
| `actimeo` | 30-60 | Recommended. Specifying `actimeo` sets all of `acregmin`, `acregmax`, `acdirmin`, and `acdirmax` to the same value. Using a value lower than 30 seconds can cause performance degradation because attribute caches for files and directories expire too quickly. We recommend setting `actimeo` between 30 and 60 seconds. |
100+
101+
## Step 4: Validate connectivity
93102

94103
If your mount failed, it's possible that your private endpoint wasn't set up correctly or isn't accessible. For details on confirming connectivity, see [Verify connectivity](storage-files-networking-endpoints.md#verify-connectivity).
95104

@@ -271,7 +280,6 @@ To mount an NFS Azure file share snapshot to a Linux VM (NFS client) and restore
271280

272281
The files and directories from the snapshot should now be available in the `/media/nfs/restore` directory.
273282

274-
## Next steps
283+
## Next step
275284

276-
- Learn more about Azure Files with [Planning for an Azure Files deployment](storage-files-planning.md).
277-
- If you experience any issues, see [Troubleshoot NFS Azure file shares](/troubleshoot/azure/azure-storage/files-troubleshoot-linux-nfs?toc=/azure/storage/files/toc.json).
285+
- If you experience any issues, see [Troubleshoot NFS Azure file shares](/troubleshoot/azure/azure-storage/files-troubleshoot-linux-nfs?toc=/azure/storage/files/toc.json).

0 commit comments

Comments
 (0)