Skip to content

Commit f226cdd

Browse files
authored
Merge pull request #95485 from MicrosoftDocs/master
Merge master to live Sunday 4:00 PM
2 parents bc193bc + 215622c commit f226cdd

11 files changed

+86
-8
lines changed

articles/azure-netapp-files/TOC.yml

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -47,10 +47,12 @@
4747
href: azure-netapp-files-set-up-capacity-pool.md
4848
- name: Delegate a subnet to Azure NetApp Files
4949
href: azure-netapp-files-delegate-subnet.md
50-
- name: Create an NFS volume for Azure NetApp Files
51-
href: azure-netapp-files-create-volumes.md
5250
- name: Create an SMB volume for Azure NetApp Files
5351
href: azure-netapp-files-create-volumes-smb.md
52+
- name: Create an NFS volume for Azure NetApp Files
53+
href: azure-netapp-files-create-volumes.md
54+
- name: Configure NFSv4.1 default domain for Azure NetApp Files
55+
href: azure-netapp-files-configure-nfsv41-domain.md
5456
- name: Configure export policy for an NFS volume
5557
href: azure-netapp-files-configure-export-policy.md
5658
- name: Manage volumes
Lines changed: 71 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,71 @@
1+
---
2+
title: Configure NFSv4.1 default domain for Azure NetApp Files | Microsoft Docs
3+
description: Describes how to configure the NFS client for using NFSv4.1 with Azure NetApp Files.
4+
documentationcenter: ''
5+
author: b-juche
6+
manager: ''
7+
editor: ''
8+
9+
ms.assetid:
10+
ms.service: azure-netapp-files
11+
ms.workload: storage
12+
ms.tgt_pltfrm: na
13+
ms.devlang: na
14+
ms.topic: conceptual
15+
ms.date: 11/08/2019
16+
ms.author: b-juche
17+
---
18+
# Configure NFSv4.1 default domain for Azure NetApp Files
19+
20+
NFSv4 introduces the concept of an authentication domain. Azure NetApp Files currently supports root-only user mapping from the service to the NFS client. To use the NFSv4.1 functionality with Azure NetApp Files, you need to update the NFS client.
21+
22+
## Default behavior of user/group mapping
23+
24+
Root mapping defaults to the `nobody` user because the NFSv4 domain is set to `localdomain`. When you mount an Azure NetApp Files NFSv4.1 volume as root, you will see file permissions as follows:
25+
26+
![Default behavior of user/group mapping for NFSv4.1](../media/azure-netapp-files/azure-netapp-files-nfsv41-default-behavior-user-group-mapping.png)
27+
28+
As the above example shows, the user for `file1` should be `root`, but it maps to `nobody` by default. This article shows you how to set the `file1` user to `root`.
29+
30+
## Steps
31+
32+
1. Edit the `/etc/idmapd.conf` file on the NFS client.
33+
Uncomment the line `#Domain` (that is, remove the `#` from the line), and change the value `localdomain` to `defaultv4iddomain.com`.
34+
35+
Initial configuration:
36+
37+
![Initial configuration for NFSv4.1](../media/azure-netapp-files/azure-netapp-files-nfsv41-initial-config.png)
38+
39+
Updated configuration:
40+
41+
![Updated configuration for NFSv4.1](../media/azure-netapp-files/azure-netapp-files-nfsv41-updated-config.png)
42+
43+
2. Unmount any currently mounted NFS volumes.
44+
3. Update the `/etc/idmapd.conf` file.
45+
4. Restart the `rpcbind` service on your host (`service rpcbind restart`), or simply reboot the host.
46+
5. Mount the NFS volumes as required.
47+
48+
See [Mount or unmount a volume for Windows or Linux virtual machines](azure-netapp-files-mount-unmount-volumes-for-virtual-machines.md).
49+
50+
The following example shows the resulting user/group change:
51+
52+
![Resulting configuration for NFSv4.1](../media/azure-netapp-files/azure-netapp-files-nfsv41-resulting-config.png)
53+
54+
As the example shows, the user/group has now changed from `nobody` to `root`.
55+
56+
## Behavior of other (non-root) users and groups
57+
58+
Azure NetApp Files supports local users (users created locally on a host) who have permissions associated with files or folders in NFSv4.1 volumes. However, the service does not currently support mapping the users/groups across multiple nodes. Therefore, users created on one host do not map by default to users created on another host.
59+
60+
In the following example, `Host1` has three existing test user accounts (`testuser01`, `testuser02`, `testuser03`):
61+
62+
![Resulting configuration for NFSv4.1](../media/azure-netapp-files/azure-netapp-files-nfsv41-host1-users.png)
63+
64+
On `Host2`, note that the test user accounts have not been created, but the same volume is mounted on both hosts:
65+
66+
![Resulting configuration for NFSv4.1](../media/azure-netapp-files/azure-netapp-files-nfsv41-host2-users.png)
67+
68+
## Next step
69+
70+
[Mount or unmount a volume for Windows or Linux virtual machines](azure-netapp-files-mount-unmount-volumes-for-virtual-machines.md)
71+

articles/azure-netapp-files/azure-netapp-files-create-volumes.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ ms.workload: storage
1313
ms.tgt_pltfrm: na
1414
ms.devlang: na
1515
ms.topic: conceptual
16-
ms.date: 10/12/2019
16+
ms.date: 11/08/2019
1717
ms.author: b-juche
1818
---
1919
# Create an NFS volume for Azure NetApp Files
@@ -38,7 +38,7 @@ A subnet must be delegated to Azure NetApp Files.
3838
Support for UNIX mode bits (read, write, and execute) is available for NFSv3 and NFSv4.1. Root-level access is required on the NFS client to mount NFS volumes.
3939

4040
* Local user/group and LDAP support for NFSv4.1
41-
Currently, NFSv4.1 supports root access to volumes only.
41+
Currently, NFSv4.1 supports root access to volumes only. See [Configure NFSv4.1 default domain for Azure NetApp Files](azure-netapp-files-configure-nfsv41-domain.md).
4242

4343
## Best practice
4444

@@ -110,6 +110,7 @@ A subnet must be delegated to Azure NetApp Files.
110110

111111
## Next steps
112112

113+
* [Configure NFSv4.1 default domain for Azure NetApp Files](azure-netapp-files-configure-nfsv41-domain.md)
113114
* [Mount or unmount a volume for Windows or Linux virtual machines](azure-netapp-files-mount-unmount-volumes-for-virtual-machines.md)
114115
* [Configure export policy for an NFS volume](azure-netapp-files-configure-export-policy.md)
115116
* [Resource limits for Azure NetApp Files](azure-netapp-files-resource-limits.md)

articles/azure-netapp-files/azure-netapp-files-mount-unmount-volumes-for-virtual-machines.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ ms.workload: storage
1313
ms.tgt_pltfrm: na
1414
ms.devlang: na
1515
ms.topic: conceptual
16-
ms.date: 03/07/2019
16+
ms.date: 11/08/2019
1717
ms.author: b-juche
1818
---
1919
# Mount or unmount a volume for Windows or Linux virtual machines
@@ -27,5 +27,8 @@ You can mount or unmount a volume for Windows or Linux virtual machines as neces
2727

2828
![Mount instructions SMB](../media/azure-netapp-files/azure-netapp-files-mount-instructions-smb.png)
2929

30-
If you are using NFSv4.1, use the following command to mount your file system:
31-
`sudo mount -t nfs -o rw,hard,rsize=65536,wsize=65536,vers=4.1,tcp,sec=sys $MOUNTTARGETIPADDRESS:/$VOLUMENAME $MOUNTPOINT`
30+
If you are using NFSv4.1, use the following command to mount your file system:
31+
32+
`sudo mount -t nfs -o rw,hard,rsize=65536,wsize=65536,vers=4.1,tcp,sec=sys $MOUNTTARGETIPADDRESS:/$VOLUMENAME $MOUNTPOINT`
33+
34+
See [Configure NFSv4.1 default domain for Azure NetApp Files](azure-netapp-files-configure-nfsv41-domain.md).

articles/azure-netapp-files/azure-netapp-files-solution-architectures.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ ms.workload: storage
1313
ms.tgt_pltfrm: na
1414
ms.devlang: na
1515
ms.topic: conceptual
16-
ms.date: 08/26/2019
16+
ms.date: 11/08/2019
1717
ms.author: b-juche
1818
---
1919
# Solution architectures using Azure NetApp Files
@@ -34,6 +34,7 @@ This article provides references to best practices that can help you understand
3434
* [High availability for SAP NetWeaver on Azure VMs on SUSE Linux Enterprise Server with Azure NetApp Files for SAP applications](https://docs.microsoft.com/azure/virtual-machines/workloads/sap/high-availability-guide-suse-netapp-files)
3535
* [Azure Virtual Machines high availability for SAP NetWeaver on Red Hat Enterprise Linux with Azure NetApp Files for SAP applications](https://docs.microsoft.com/azure/virtual-machines/workloads/sap/high-availability-guide-rhel-netapp-files)
3636
* [SAP HANA scale-out with standby node on Azure VMs with Azure NetApp Files on SUSE Linux Enterprise Server](https://docs.microsoft.com/azure/virtual-machines/workloads/sap/sap-hana-scale-out-standby-netapp-files-suse)
37+
* [SAP HANA Azure virtual machine storage configurations](https://docs.microsoft.com/azure/virtual-machines/workloads/sap/hana-vm-operations-storage)
3738

3839
## Talon solutions
3940

104 KB
Loading
182 KB
Loading
175 KB
Loading
175 KB
Loading
84.2 KB
Loading

0 commit comments

Comments
 (0)