You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/storage/files/storage-how-to-use-files-linux.md
+24-3Lines changed: 24 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ description: Learn how to mount an Azure file share over SMB on Linux and review
4
4
author: khdownie
5
5
ms.service: storage
6
6
ms.topic: how-to
7
-
ms.date: 11/03/2022
7
+
ms.date: 01/06/2023
8
8
ms.author: kendownie
9
9
ms.subservice: files
10
10
---
@@ -29,7 +29,7 @@ uname -r
29
29
```
30
30
31
31
> [!Note]
32
-
> SMB 2.1 support was added to Linux kernel version 3.7. If you are using a version of the Linux kernel after 3.7, it should support SMB 2.1.
32
+
> SMB 2.1 support was added to Linux kernel version 3.7. If you're using a version of the Linux kernel after 3.7, it should support SMB 2.1.
33
33
34
34
## Applies to
35
35
| File share type | SMB | NFS |
@@ -184,7 +184,7 @@ mntRoot="/mount"
184
184
sudo mkdir -p $mntRoot
185
185
```
186
186
187
-
To mount an Azure file share on Linux, use the storage account name as the username of the file share, and the storage account key as the password. Since the storage account credentials may change over time, you should store the credentials for the storage account separately from the mount configuration.
187
+
To mount an Azure file share on Linux, use the storage account name as the username of the file share, and the storage account key as the password. Because the storage account credentials may change over time, you should store the credentials for the storage account separately from the mount configuration.
188
188
189
189
The following example shows how to create a file to store the credentials. Remember to replace `<resource-group-name>` and `<storage-account-name>` with the appropriate information for your environment.
190
190
@@ -302,6 +302,27 @@ The final step is to restart the `autofs` service.
302
302
sudo systemctl restart autofs
303
303
```
304
304
305
+
## Mount a file share snapshot
306
+
307
+
If you want to mount a specific snapshot of an SMB Azure file share, you must supply the `snapshot` option as part of the `mount` command, where `snapshot` is the time that the particular snapshot was created in a format such as @GMT-2023.01.05-00.08.20. The `snapshot` option has been supported in the Linux kernel since version 4.19.
308
+
309
+
After you've created the file share snapshot, following these instructions to mount it.
310
+
311
+
1. In the Azure portal, navigate to the storage account that contains the file share that you want to mount a snapshot of.
312
+
2. Select **Data storage > File shares** and select the file share.
313
+
3. Select **Operations > Snapshots** and take note of the name of the snapshot you want to mount. The snapshot name will be a GMT timestamp, such as in the screenshot below.
314
+
315
+
:::image type="content" source="media/storage-how-to-use-files-linux/mount-snapshot.png" alt-text="Screenshot showing how to locate a file share snapshot name and timestamp in the Azure portal." border="true" :::
316
+
317
+
4. Convert the timestamp to the format expected by the `mount` command, which is **@GMT-year.month.day-hour.minutes.seconds**. In this example, you'd convert **2023-01-05T00:08:20.0000000Z** to **@GMT-2023.01.05-00.08.20**.
318
+
5. Run the `mount`command using the GMT time to specify the `snapshot` value. Be sure to replace `<storage-account-name>`, `<file-share-name>`, and the GMT timestamp with your values. The .cred file contains the credentials to be used to mount the share (see [Automatically mount file shares](#automatically-mount-file-shares)).
319
+
320
+
```bash
321
+
sudo mount -t cifs //<storage-account-name>.file.core.windows.net/<file-share-name> /mnt/<file-share-name>/snapshot1 -o credentials=/etc/smbcredentials/snapshottestlinux.cred,[email protected]
322
+
```
323
+
324
+
6. If you're able to browse the snapshot under the path `/mnt/<file-share-name>/snapshot1`, then the mount succeeded.
325
+
305
326
## Next steps
306
327
See these links for more information about Azure Files:
0 commit comments