Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into updateDiagramsHA

roygara · roygara · commit 1b9ca043ec43 · 2024-05-13T13:40:35.000-07:00
diff --git a/articles/storage/files/storage-how-to-use-files-linux.md b/articles/storage/files/storage-how-to-use-files-linux.md
@@ -5,15 +5,16 @@ author: khdownie
 ms.service: azure-file-storage
 ms.custom: linux-related-content, devx-track-azurecli
 ms.topic: how-to
-ms.date: 01/10/2023
+ms.date: 05/13/2024
 ms.author: kendownie
 ---
 
-# Mount SMB Azure file share on Linux
+# Mount SMB Azure file shares on Linux clients
 
 > [!CAUTION]
 > This article references CentOS, a Linux distribution that is nearing End Of Life (EOL) status. Please consider your use and plan accordingly. For more information, see the [CentOS End Of Life guidance](~/articles/virtual-machines/workloads/centos/centos-end-of-life.md).
-[Azure Files](storage-files-introduction.md) is Microsoft's easy to use cloud file system. Azure file shares can be mounted in Linux distributions using the [SMB kernel client](https://wiki.samba.org/index.php/LinuxCIFS).
+
+Azure file shares can be mounted in Linux distributions using the [SMB kernel client](https://wiki.samba.org/index.php/LinuxCIFS).
 
 The recommended way to mount an Azure file share on Linux is using SMB 3.1.1. By default, Azure Files requires encryption in transit, which is supported by SMB 3.0+. Azure Files also supports SMB 2.1, which doesn't support encryption in transit, but you can't mount Azure file shares with SMB 2.1 from another Azure region or on-premises for security reasons. Unless your application specifically requires SMB 2.1, use SMB 3.1.1.
 
@@ -31,21 +32,23 @@ If your Linux distribution isn't listed in the above table, you can check the Li
 uname -r
 ```
 
-> [!Note]
+> [!NOTE]
 > 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.
 
 ## Applies to
+
 | File share type | SMB | NFS |
 |-|:-:|:-:|
 | Standard file shares (GPv2), LRS/ZRS | ![Yes](../media/icons/yes-icon.png) | ![No](../media/icons/no-icon.png) |
 | Standard file shares (GPv2), GRS/GZRS | ![Yes](../media/icons/yes-icon.png) | ![No](../media/icons/no-icon.png) |
 | Premium file shares (FileStorage), LRS/ZRS | ![Yes](../media/icons/yes-icon.png) | ![No](../media/icons/no-icon.png) |
 
 ## Prerequisites
+
 <a id="smb-client-reqs"></a>
 
 * <a id="install-cifs-utils"></a>**Ensure the cifs-utils package is installed.**
-    The cifs-utils package can be installed using the package manager on the Linux distribution of your choice.
+    Install the cifs-utils package using the package manager on the Linux distribution of your choice.
 
 
 # [Ubuntu](#tab/Ubuntu)
@@ -84,7 +87,7 @@ On other distributions, use the appropriate package manager or [compile from sou
 
 * **The most recent version of the Azure Command Line Interface (CLI).** For more information on how to install the Azure CLI, see [Install the Azure CLI](/cli/azure/install-azure-cli) and select your operating system. If you prefer to use the Azure PowerShell module in PowerShell 6+, you may; however, the instructions in this article are for the Azure CLI.
 
-* **Ensure port 445 is open**: SMB communicates over TCP port 445 - make sure your firewall or ISP isn't blocking TCP port 445 from the client machine.  Replace `<your-resource-group>` and `<your-storage-account>` and then run the following script:
+* **Ensure port 445 is open**: SMB communicates over TCP port 445 - make sure your firewall or ISP isn't blocking TCP port 445 from the client machine. Replace `<your-resource-group>` and `<your-storage-account>` and then run the following script:
 
     ```bash
     RESOURCE_GROUP_NAME="<your-resource-group>"
@@ -110,6 +113,7 @@ On other distributions, use the appropriate package manager or [compile from sou
     If you're unable to open up port 445 on your corporate network or are blocked from doing so by an ISP, you may use a VPN connection or ExpressRoute to work around port 445. For more information, see [Networking considerations for direct Azure file share access](storage-files-networking-overview.md).
 
 ## Mount the Azure file share on-demand with mount
+
 When you mount a file share on a Linux OS, your remote file share is represented as a folder in your local file system. You can mount file shares to anywhere on your system. The following example mounts under the `/media` path. You can change this to your preferred path you want by modifying the `$MNT_ROOT` variable.
 
 Replace `<resource-group-name>`, `<storage-account-name>`, and `<file-share-name>` with the appropriate information for your environment:
@@ -128,7 +132,7 @@ sudo mkdir -p $MNT_PATH
 Next, mount the file share using the `mount` command. In the following example, the `$SMB_PATH` command is populated using the fully qualified domain name for the storage account's file endpoint and `$STORAGE_ACCOUNT_KEY` is populated with the storage account key.
 
 # [SMB 3.1.1](#tab/smb311)
-> [!Note]
+> [!NOTE]
 > Starting in Linux kernel version 5.0, SMB 3.1.1 is the default negotiated protocol. If you're using a version of the Linux kernel older than 5.0, specify `vers=3.1.1` in the mount options list.
 
 ```azurecli
@@ -188,14 +192,15 @@ You can use `uid`/`gid` or `dir_mode` and `file_mode` in the mount options for t
 You can also mount the same Azure file share to multiple mount points if desired. When you're done using the Azure file share, use `sudo umount $mntPath` to unmount the share.
 
 ## Automatically mount file shares
+
 When you mount a file share on a Linux OS, your remote file share is represented as a folder in your local file system. You can mount file shares to anywhere on your system. The following example mounts under the `/media` path. You can change this to your preferred path you want by modifying the `$MNT_ROOT` variable.
 
 ```bash
 MNT_ROOT="/media"
 sudo mkdir -p $MNT_ROOT
 ```
 
-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.
+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 might change over time, you should store the credentials for the storage account separately from the mount configuration.
 
 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.
 
@@ -232,6 +237,7 @@ sudo chmod 600 $SMB_CREDENTIAL_FILE
 To automatically mount a file share, you have a choice between using a static mount via the `/etc/fstab` utility or using a dynamic mount via the `autofs` utility.
 
 ### Static mount with /etc/fstab
+
 Using the earlier environment, create a folder for your storage account/file share under your mount folder. Replace `<file-share-name>` with the appropriate name of your Azure file share.
 
 ```bash
@@ -241,9 +247,9 @@ MNT_PATH="$MNT_ROOT/$STORAGE_ACCOUNT_NAME/$FILE_SHARE_NAME"
 sudo mkdir -p $MNT_PATH
 ```
 
-Finally, create a record in the `/etc/fstab` file for your Azure file share. In the command below, the default 0755 Linux file and folder permissions are used, which means read, write, and execute for the owner (based on the file/directory Linux owner), read and execute for users in owner group, and read and execute for others on the system. You may wish to set alternate `uid` and `gid` or `dir_mode` and `file_mode` permissions on mount as desired. For more information on how to set permissions, see [UNIX numeric notation](https://en.wikipedia.org/wiki/File_system_permissions#Numeric_notation) on Wikipedia.
+Finally, create a record in the `/etc/fstab` file for your Azure file share. In the command below, the default 0755 Linux file and folder permissions are used, which means read, write, and execute for the owner (based on the file/directory Linux owner), read and execute for users in owner group, and read and execute for others on the system. You might wish to set alternate `uid` and `gid` or `dir_mode` and `file_mode` permissions on mount as desired. For more information on how to set permissions, see [UNIX numeric notation](https://en.wikipedia.org/wiki/File_system_permissions#Numeric_notation).
 
-> [!Tip]
+> [!TIP]
 > If you want Docker containers running .NET Core applications to be able to write to the Azure file share, include **nobrl** in the SMB mount options to avoid sending byte range lock requests to the server.
 
 ```bash
@@ -262,10 +268,11 @@ fi
 sudo mount -a
 ```
 
-> [!Note]
+> [!NOTE]
 > Starting in Linux kernel version 5.0, SMB 3.1.1 is the default negotiated protocol. You can specify alternate protocol versions using the `vers` mount option (protocol versions are `3.1.1`, `3.0`, and `2.1`).
 
 ### Dynamically mount with autofs
+
 To dynamically mount a file share with the `autofs` utility, install it using the package manager on the Linux distribution of your choice.
 
 # [Ubuntu](#tab/Ubuntu)
@@ -345,6 +352,7 @@ After you've created the file share snapshot, follow these instructions to mount
 If the mount fails, see [Troubleshoot Azure Files connectivity and access issues (SMB)](/troubleshoot/azure/azure-storage/files-troubleshoot-smb-connectivity?toc=/azure/storage/files/toc.json).
 
 ## Next steps
+
 See these links for more information about Azure Files:
 
 - [Planning for an Azure Files deployment](storage-files-planning.md)
diff --git a/articles/storage/files/storage-how-to-use-files-portal.md b/articles/storage/files/storage-how-to-use-files-portal.md
@@ -1,18 +1,19 @@
 ---
 title: Quickstart for creating and using Azure file shares
-description: Learn how to create and use Azure file shares with the Azure portal, Azure CLI, or Azure PowerShell. Create a storage account, create an SMB Azure file share, and use your Azure file share.
+description: Learn how to create and use SMB Azure file shares with the Azure portal, Azure CLI, or Azure PowerShell. Create a storage account, then create and use an Azure file share.
 author: khdownie
 ms.service: azure-file-storage
 ms.topic: quickstart
-ms.date: 10/10/2023
+ms.date: 05/13/2024
 ms.author: kendownie
 ms.custom: engagement-fy23, mode-ui, devx-track-azurecli, devx-track-azurepowershell
 ms.devlang: azurecli
 #Customer intent: As an IT admin new to Azure Files, I want to try out Azure Files so I can determine whether I want to subscribe to the service.
 ---
 
-# Quickstart: Create and use an Azure file share
-[Azure Files](storage-files-introduction.md) is Microsoft's easy-to-use cloud file system. You can mount Azure file shares in Windows, Linux, and macOS operating systems. This article shows you how to create an SMB Azure file share using either the Azure portal, Azure CLI, or Azure PowerShell.
+# Quickstart: Create and use an SMB Azure file share
+
+[Azure Files](storage-files-introduction.md) is Microsoft's easy-to-use cloud file system. You can mount SMB Azure file shares in Windows, Linux, and macOS operating systems. This article shows you how to create an Azure file share using either the Azure portal, Azure CLI, or Azure PowerShell.
 
 ## Applies to
 
@@ -58,6 +59,7 @@ If you'd like to install and use PowerShell locally, you'll need the Azure Power
 
 
 ### PowerShell - Create a resource group
+
 A resource group is a logical container into which Azure resources are deployed and managed. If you don't already have an Azure resource group, create a new one with the [New-AzResourceGroup](/powershell/module/az.resources/new-azresourcegroup) cmdlet. You need a resource group to create a storage account.
 
 The following example creates a resource group named *myResourceGroup* in the West US 2 region:
@@ -92,6 +94,7 @@ $storageAcct = New-AzStorageAccount `
 # [Azure CLI](#tab/azure-cli)
 
 ### CLI - Create a resource group
+
 A resource group is a logical container in which Azure resources are deployed and managed. If you don't already have an Azure resource group, you can use the [az group create](/cli/azure/group) command to create one. You need a resource group to create a storage account.
 
 The following example creates a resource group named *myResourceGroup* in the *West US 2* location:
@@ -107,6 +110,7 @@ az group create \
 ```
 
 ### CLI - Create a storage account
+
 A storage account is a shared pool of storage in which you can deploy Azure file shares.
 
 The following example creates a storage account using the [az storage account create](/cli/azure/storage/account) command. Storage account names must be unique, so use `$RANDOM` to append a random number to the name to make it unique.
@@ -130,7 +134,6 @@ az storage account create \
 
 ## Create an Azure file share
 
-
 # [Portal](#tab/azure-portal)
 
 To create an Azure file share:
@@ -220,9 +223,9 @@ az storage directory create \
 ---
 
 
-#### Upload a file 
-# [Portal](#tab/azure-portal)
+#### Upload a file
 
+# [Portal](#tab/azure-portal)
 
 First, you need to create or select a file to upload. Do this by whatever means you see fit. When you've decided on the file you'd like to upload, follow these steps:
 
@@ -298,11 +301,11 @@ az storage file list \
 ---
 
 #### Download a file
+
 # [Portal](#tab/azure-portal)
 
 You can download a copy of the file you uploaded by right-clicking on the file and selecting **Download**. The exact experience will depend on the operating system and browser you're using.
 
-
 # [PowerShell](#tab/azure-powershell)
 
 You can use the [Get-AzStorageFileContent](/powershell/module/az.storage/Get-AzStorageFilecontent) cmdlet to download a copy of the file you uploaded to the scratch drive of your Cloud Shell.
@@ -346,6 +349,7 @@ az storage file download \
 ---
 
 ## Clean up resources
+
 # [Portal](#tab/azure-portal)
 
 [!INCLUDE [storage-files-clean-up-portal](../../../includes/storage-files-clean-up-portal.md)]
@@ -366,10 +370,9 @@ When you're done, you can use the [`az group delete`](/cli/azure/group) command
 az group delete --name $resourceGroupName
 ```
 
-
 ---
 
-## Next steps
+## Next step
 
 > [!div class="nextstepaction"]
 > [What is Azure Files?](storage-files-introduction.md)
