Skip to content

Commit 0f60e19

Browse files
committed
adding instrux for snapshot mount
1 parent 90a2e27 commit 0f60e19

File tree

2 files changed

+25
-2
lines changed

2 files changed

+25
-2
lines changed
32 KB
Loading

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

Lines changed: 25 additions & 2 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/04/2023
88
ms.author: kendownie
99
ms.subservice: files
1010
---
@@ -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,29 @@ 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 GMT format such as @GMT-2022.12.12-09.52.43. 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 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 GMT format expected by the `mount` command.
318+
5. Run the `mount` command using the GMT time to specify the `snapshot` value. Be sure to replace `<storage-account-name>` and `<file-share-name>` 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/snapshot-test-share1/snapshot1, then the mount succeeded.
325+
326+
If the mount fails, see Troubleshooting.
327+
305328
## Next steps
306329
See these links for more information about Azure Files:
307330

0 commit comments

Comments
 (0)