Skip to content

Commit 215307a

Browse files
authored
Merge pull request #312688 from paulth1/nfs-30-support-for-blob-storage
{AQ} edit pass: Nfs 30 support for blob storage
2 parents 22ec1f4 + 8d73c78 commit 215307a

5 files changed

Lines changed: 232 additions & 256 deletions
Lines changed: 21 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Known issues with NFS 3.0 in Azure Blob Storage
2+
title: Known Issues with NFS 3.0 in Azure Blob Storage
33
titleSuffix: Azure Storage
44
description: Learn about limitations and known issues of Network File System (NFS) 3.0 protocol support for Azure Blob Storage.
55
author: normesta
@@ -8,73 +8,61 @@ ms.service: azure-blob-storage
88
ms.topic: concept-article
99
ms.date: 03/04/2024
1010
ms.author: normesta
11-
# Customer intent: As a storage administrator, I want to understand the limitations and known issues of NFS 3.0 support for Azure Blob Storage, so that I can make informed decisions about enabling it and managing my storage environment effectively.
11+
# Customer intent: As a storage administrator, I want to understand the limitations and known issues of NFS 3.0 support for Azure Blob Storage so that I can make informed decisions about enabling it and managing my storage environment effectively.
1212
---
1313

1414
# Known issues with Network File System (NFS) 3.0 protocol support for Azure Blob Storage
1515

1616
This article describes limitations and known issues of Network File System (NFS) 3.0 protocol support for Azure Blob Storage.
1717

1818
> [!IMPORTANT]
19-
> Because you must enable the hierarchical namespace feature of your account to use NFS 3.0, all of the known issues that are described in the [Known issues with Azure Data Lake Storage](data-lake-storage-known-issues.md) article also apply to your account.
19+
> Because you must enable the hierarchical namespace feature of your account to use NFS 3.0, all the known issues that are described in the [Known issues with Azure Data Lake Storage](data-lake-storage-known-issues.md) article also apply to your account.
2020
2121
## NFS 3.0 support
2222

2323
- NFS 3.0 support can't be enabled on existing storage accounts.
24-
2524
- NFS 3.0 support can't be disabled in a storage account after you enable it.
26-
27-
- Geo-Redundant Storage (GRS) is supported only for unplanned failover scenarios and isn't supported for planned failover.
28-
29-
- Geo-zone-redundant storage (GZRS) and Read-access geo-redundant storage (RA-GRS) redundancy options aren't supported when you create an NFS 3.0 storage account.
30-
31-
- Access control lists (ACLs) can't be used to authorize an NFS 3.0 request. In fact, if the ACL or a blob or directory contains an entry for a named user or group, that file becomes inaccessible on the client for nonroot users. You have to remove these entries to restore access to nonroot users on the client. For information about how to remove an ACL entry for named users and groups, see [How to set ACLs](data-lake-storage-access-control.md#how-to-set-acls).
32-
25+
- Geo-redundant storage is supported only for unplanned failover scenarios and isn't supported for planned failover.
26+
- Geo-zone-redundant storage and read-access geo-redundant storage redundancy options aren't supported when you create an NFS 3.0 storage account.
27+
- Access control lists (ACLs) can't be used to authorize an NFS 3.0 request. If the ACL or a blob or directory contains an entry for a named user or group, that file becomes inaccessible on the client for nonroot users. You have to remove these entries to restore access to nonroot users on the client. For information about how to remove an ACL entry for named users and groups, see [How to set ACLs](data-lake-storage-access-control.md#how-to-set-acls).
3328
- NFS 3.0 enabled accounts don't support [Azure Data Lake Storage vaulted backup](/azure/backup/azure-data-lake-storage-backup-support-matrix).
3429

3530
## NFS 3.0 features
3631

37-
The following NFS 3.0 features aren't yet supported.
38-
39-
- NFS 3.0 over UDP. Only NFS 3.0 over TCP is supported.
40-
41-
- Locking files with Network Lock Manager (NLM). Mount commands must include the `-o nolock` parameter.
42-
43-
- Mounting subdirectories. You can only mount the root directory (Container).
44-
45-
- Listing mounts (For example: by using the command `showmount -a`).
46-
47-
- Listing exports (For example: by using the command `showmount -e`).
48-
49-
- Hard link.
32+
The following NFS 3.0 features aren't yet supported:
5033

34+
- Using NFS 3.0 over UDP. Only NFS 3.0 over TCP is supported.
35+
- Locking files with Network Lock Manager. Mount commands must include the `-o nolock` parameter.
36+
- Mounting subdirectories. You can only mount the root directory (container).
37+
- Listing mounts (for example, by using the command `showmount -a`).
38+
- Listing exports (for example, by using the command `showmount -e`).
39+
- Using hard links.
5140
- Exporting a container as read-only.
5241

5342
## NFS 3.0 clients
5443

55-
Windows client for NFS isn't yet supported. However, there's a workaround available that uses the Windows Subsystem for Linux (WSL 2) to mount storage by using the NFS 3.0 protocol. See the [BlobNFS-wsl2](https://github.com/Azure/BlobNFS-wsl2/tree/develop) project on GitHub.
44+
Windows client for NFS isn't yet supported. A workaround is available that uses the Windows Subsystem for Linux (WSL 2) to mount storage by using the NFS 3.0 protocol. For more information, see the [BlobNFS-wsl2](https://github.com/Azure/BlobNFS-wsl2/tree/develop) project on GitHub.
5645

5746
## Blob Storage features
5847

59-
When you enable NFS 3.0 protocol support, some Blob Storage features are fully supported, but some features might be supported only at the preview level or not yet supported at all.
48+
When you enable NFS 3.0 protocol support, some Azure Blob Storage features are fully supported, but some features might be supported only at the preview level or not yet supported at all.
6049

6150
To see how each Blob Storage feature is supported in accounts that have NFS 3.0 support enabled, see [Blob Storage feature support for Azure Storage accounts](storage-feature-support-in-storage-accounts.md).
6251

6352
> [!NOTE]
64-
> Static websites is an example of a partially supported feature because the configuration page for static websites does not yet appear in the Azure portal for accounts that have NFS 3.0 support enabled. You can enable static websites only by using PowerShell or Azure CLI.
53+
> Static websites are an example of a partially supported feature. The configuration page for static websites doesn't yet appear in the Azure portal for accounts that have NFS 3.0 support enabled. You can enable static websites only by using Azure PowerShell or the Azure CLI.
6554
6655
## Blob Storage events
6756

68-
The names of NFS operations don't appear in resource logs or in responses returned by the Event Grid. Only block blob operations appear. When your application makes a request by using the NFS 3.0 protocol, that request is translated into combination of block blob operations. For example, NFS 3.0 read Remote Procedure Call (RPC) requests are translated into Get Blob operation. NFS 3.0 write RPC requests are translated into a combination of Get Block List, Put Block, and Put Block List.
57+
The names of NFS operations don't appear in resource logs or in responses returned by Azure Event Grid. Only block blob operations appear. When your application makes a request by using the NFS 3.0 protocol, that request is translated into combination of block blob operations. For example, NFS 3.0 read remote procedure call (RPC) requests are translated into a `Get Blob` operation. NFS 3.0 write RPC requests are translated into a combination of `Get Block List`, `Put Block`, and `Put Block List`.
6958

70-
Storage Events aren't supported for NFS specific operations. However, if you're performing blob or data lake storage operations on NFS enabled account, then the events shall get created based on the API being called.
59+
Storage events aren't supported for NFS specific operations. If you perform blob or data lake storage operations on an NFS-enabled account, the events get created based on the API being called.
7160

7261
## Group membership in an NFS share
7362

74-
Files and directories that you create in an NFS share always inherit the group ID of the parent directory regardless of whether the Set Group Identification (SGID) is set on the parent directory.
63+
Files and directories that you create in an NFS share always inherit the group ID of the parent directory regardless of whether the Set Group ID is set on the parent directory.
7564

76-
## See also
65+
## Related content
7766

7867
- [Network File System (NFS) 3.0 protocol support for Azure Blob Storage](network-file-system-protocol-support.md)
79-
- [Mount Blob storage by using the Network File System (NFS) 3.0 protocol](network-file-system-protocol-support-how-to.md)
80-
68+
- [Mount Blob storage by using the Network File System (NFS) 3.0 protocol](network-file-system-protocol-support-how-to.md)

0 commit comments

Comments
 (0)