Skip to content

Commit 6128782

Browse files
authored
Merge pull request #222966 from khdownie/kendownie010423-2
adding instrux for snapshot mount
2 parents 1151d3e + a4a6e59 commit 6128782

File tree

2 files changed

+24
-3
lines changed

2 files changed

+24
-3
lines changed
32 KB
Loading

articles/storage/files/storage-how-to-use-files-linux.md

Lines changed: 24 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn how to mount an Azure file share over SMB on Linux and review
44
author: khdownie
55
ms.service: storage
66
ms.topic: how-to
7-
ms.date: 11/03/2022
7+
ms.date: 01/06/2023
88
ms.author: kendownie
99
ms.subservice: files
1010
---
@@ -29,7 +29,7 @@ uname -r
2929
```
3030

3131
> [!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.
3333
3434
## Applies to
3535
| File share type | SMB | NFS |
@@ -184,7 +184,7 @@ mntRoot="/mount"
184184
sudo mkdir -p $mntRoot
185185
```
186186

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.
188188

189189
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.
190190

@@ -302,6 +302,27 @@ The final step is to restart the `autofs` service.
302302
sudo systemctl restart autofs
303303
```
304304

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+
305326
## Next steps
306327
See these links for more information about Azure Files:
307328

0 commit comments

Comments
 (0)