Skip to content

Commit 32ef803

Browse files
Merge pull request #238003 from normesta/protocols
AZNFS updates to NFS content + some SFTP table adjustments
2 parents 0a17ce6 + 944b9e1 commit 32ef803

File tree

2 files changed

+47
-14
lines changed

2 files changed

+47
-14
lines changed

articles/storage/blobs/network-file-system-protocol-support-how-to.md

Lines changed: 40 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ author: normesta
77
ms.subservice: blobs
88
ms.service: storage
99
ms.topic: conceptual
10-
ms.date: 02/14/2023
10+
ms.date: 05/12/2023
1111
ms.author: normesta
1212
ms.reviewer: yzheng
1313
---
@@ -72,9 +72,34 @@ The following image shows the squash options as they appear in the Azure portal.
7272
> [!div class="mx-imgBorder"]
7373
> ![Screenshot that shows squash options in the Azure portal.](./media/network-file-system-protocol-how-to/squash-options-azure-portal.png)
7474
75-
## Step 5: Mount the container
75+
## Step 5: Install the AZNFS Mount Helper package
7676

77-
Create a directory on your Linux system, and then mount the container in the storage account.
77+
The AZNFS Mount Helper package helps Linux NFS clients to reliably access Azure Blob NFS shares even when the IP address of the endpoint changes. This package runs a background job called `aznfswatchdog` which monitors changes to the endpoint IP address for the mounted shares. If a change is detected, this background job updates the Destination Network Address Translation (DNAT) rules. To learn more, see [AZNFS Mount Helper](https://github.com/Azure/AZNFS-mount/).
78+
79+
1. Determine whether the AZNFS Mount Helper package is installed on your client.
80+
81+
```
82+
systemctl is-active --quiet aznfswatchdog && echo -e "\nAZNFS mounthelper is installed! \n"
83+
```
84+
85+
If the package is installed, then the message `AZNFS mounthelper is installed!` appears.
86+
87+
2. If the package is not yet installed, then use the following command to install it.
88+
89+
```
90+
wget -O - -q https://github.com/Azure/AZNFS-mount/releases/latest/download/aznfs_install.sh | bash
91+
```
92+
93+
> [!NOTE]
94+
> AZNFS is supported on following Linux distributions:
95+
> - Ubuntu (18.04 LTS, 20.04 LTS, 22.04 LTS)
96+
> - Centos7, Centos8
97+
> - RedHat7, RedHat8, RedHat9
98+
> - Rocky8, Rocky9
99+
100+
## Step 6: Mount the container
101+
102+
Create a directory on your Linux system and then mount the container in the storage account.
78103

79104
1. On your Linux system, create a directory:
80105

@@ -89,10 +114,10 @@ Create a directory on your Linux system, and then mount the container in the sto
89114
1. Create an entry in the /etc/fstab file by adding the following line:
90115

91116
```
92-
<storage-account-name>.blob.core.windows.net:/<storage-account-name>/<container-name> /nfsdata nfs defaults,sec=sys,vers=3,nolock,proto=tcp,nofail 0 0
117+
<storage-account-name>.blob.core.windows.net:/<storage-account-name>/<container-name> /nfsdata aznfs defaults,sec=sys,vers=3,nolock,proto=tcp,nofail 0 0
93118
```
94119
95-
1. Run the following command to immediately process the /etc/fstab entries and attempt to mount the preceding path:
120+
2. Run the following command to immediately process the /etc/fstab entries and attempt to mount the preceding path:
96121
97122
```
98123
mount /nfsdata
@@ -101,8 +126,11 @@ Create a directory on your Linux system, and then mount the container in the sto
101126
- For a temporary mount that doesn't persist across reboots, run the following command:
102127
103128
```
104-
mount -o sec=sys,vers=3,nolock,proto=tcp <storage-account-name>.blob.core.windows.net:/<storage-account-name>/<container-name> /nfsdata
105-
```
129+
mount -t aznfs -o sec=sys,vers=3,nolock,proto=tcp <storage-account-name>.blob.core.windows.net:/<storage-account-name>/<container-name> /nfsdatain
130+
```
131+
132+
> [!TIP]
133+
> By using the `-t aznfs` mount option, you ensure that the NFS client always remains correctly connected to the storage endpoint even if the endpoint IP changes after the mount. NFS shares that are mounted by using the `-t nfs` mount option might become disconnected from the storage endpoint if the IP address of that endpoint changes.
106134
107135
## Resolve common errors
108136
@@ -118,6 +146,11 @@ Create a directory on your Linux system, and then mount the container in the sto
118146
|`mount: /nfsdata: bad option;`| Install the NFS helper program by using `sudo apt install nfs-common`.|
119147
|`Connection Timed Out`| Make sure that client allows outgoing communication through ports 111 and 2048. The NFS 3.0 protocol uses these ports. Makes sure to mount the storage account by using the Blob service endpoint and not the Data Lake Storage endpoint. |
120148
149+
## Limitations and troubleshooting for AZNFS Mount Helper
150+
151+
See [AZNFS Mount Helper](https://github.com/Azure/AZNFS-mount/).
152+
153+
121154
## See also
122155
123156
- [Network File System (NFS) 3.0 protocol support for Azure Blob Storage](network-file-system-protocol-support.md)

articles/storage/blobs/secure-file-transfer-protocol-support.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -109,13 +109,13 @@ put logfile.txt
109109

110110
You can use many different SFTP clients to securely connect and then transfer files. Connecting clients must use algorithms specified in table below.
111111

112-
| Host key <sup>1</sup> | Key exchange | Ciphers/encryption | Integrity/MAC | Public key |
113-
|----------|--------------|--------------------|---------------|------------|
114-
| rsa-sha2-256 <sup>2</sup> | ecdh-sha2-nistp384 | [email protected] | hmac-sha2-256 | ssh-rsa <sup>2</sup> |
115-
| rsa-sha2-512 <sup>2</sup> | ecdh-sha2-nistp256 | [email protected] | hmac-sha2-512 | ecdsa-sha2-nistp256 |
116-
| ecdsa-sha2-nistp256 | diffie-hellman-group14-sha256 | aes128-ctr| hmac-sha2-256-etm@openssh.com | ecdsa-sha2-nistp384 |
117-
| ecdsa-sha2-nistp384 | diffie-hellman-group16-sha512 | aes192-ctr | [email protected] |
118-
|| diffie-hellman-group-exchange-sha256 | aes256-ctr ||
112+
| Type | Algorithm |
113+
|--|--|
114+
| Host key <sup>1</sup> | rsa-sha2-256 <sup>2</sup><br>rsa-sha2-512 <sup>2</sup><br>ecdsa-sha2-nistp256<br>ecdsa-sha2-nistp384 |
115+
| Key exchange |ecdh-sha2-nistp384<br>ecdh-sha2-nistp256<br>diffie-hellman-group14-sha256<br>diffie-hellman-group16-sha512<br>diffie-hellman-group-exchange-sha256|
116+
| Ciphers/encryption |aes128-[email protected]<br>aes256-gcm@openssh.com<br>aes128-ctr<br>aes192-ctr<br>aes256-ctr|
117+
| Integrity/MAC |hmac-sha2-256<br>hmac-sha2-512<br>[email protected]<br>[email protected]|
118+
| Public key |ssh-rsa <sup>2</sup><br>ecdsa-sha2-nistp256<br>ecdsa-sha2-nistp384|
119119

120120
<sup>1</sup> Host keys are published [here](secure-file-transfer-protocol-host-keys.md).
121121
<sup>2</sup> RSA keys must be minimum 2048 bits in length.

0 commit comments

Comments
 (0)