Merge pull request #8080 from simonxjx/simon-3

AB#3579: Post Edit PR#8075

Author: Simonx Xu

support/azure/azure-storage/files/security/files-troubleshoot-linux-smb.md

@@ -3,7 +3,7 @@ title: Troubleshoot Azure Files issues in Linux (SMB)
 description: Troubleshooting Azure Files issues in Linux. See general issues related to SMB Azure file shares when you connect from Linux clients and possible resolutions.
 ms.service: azure-file-storage
 ms.custom: sap:Security, linux-related-content
-ms.date: 08/20/2024
+ms.date: 01/22/2025
 ms.reviewer: kendownie, v-weizhu
 ---
 
@@ -24,75 +24,75 @@ This article lists common issues that can occur when using SMB Azure file shares
 
 ## Run diagnostics
 
-Diagnostics tools can be helpful for ensuring that clients have the correct prerequisites and for collecting debug information on field issues that can be hard to reproduce.
+Diagnostics tools can help ensure that clients have the correct prerequisites and collect debug information on field issues that can be hard to reproduce.
 
 ### Use AzFileDiagnostics
 
 You can use [AzFileDiagnostics](https://github.com/Azure-Samples/azure-files-samples/tree/master/AzFileDiagnostics/Linux) to automate symptom detection and ensure that the Linux client has the correct prerequisites. It helps set up your environment to get optimal performance.
 
 ### Use the Always-On Diagnostics tool
 
-You can also use the Always-On Diagnostics (AOD) tool to collect logs on SMB and NFSv4 Linux clients. The daemon runs in the background as a system service and can be configured to detect anomalies in a variety of sources such as dmesg logs, debug data, and error and latency metrics. It can capture data from tcpdump, nfsstat, mountstsat, and other sources, along with the system's CPU and memory usage.
+You can also use the Always-On Diagnostics (AOD) tool to collect logs on SMB and NFSv4 Linux clients. The daemon runs in the background as a system service and can be configured to detect anomalies in various sources, such as dmesg logs, debug data, error metrics, and latency metrics. It can capture data from tcpdump, nfsstat, mountstsat, and other sources, along with the system's CPU and memory usage.
 
-AOD is currently compatible with systems running SUSE Linux Enterprise Server 15 (SLES15) and Red Hat Enterprise Linux 8 (RHEL8). Follow the appropriate installation steps.
+The Always-On Diagnostics tool is currently compatible with systems running SUSE Linux Enterprise Server 15 (SLES 15) and Red Hat Enterprise Linux 8 (RHEL 8). Follow the installation steps that correspond to your operating system:
 
 #### [SLES](#tab/SLES)
 
-Follow these instructions to install the Always-On Diagnostics tool on SUSE Linux Enterprise Server 15.
+In SLES 15, follow these instructions to install the Always-On Diagnostics tool:
 
 1. Add the Microsoft repo. You might need to add the Microsoft repository key to your list of trusted keys.
 
-```
-sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
-sudo zypper addrepo --check --refresh --name 'Microsoft' https://packages.microsoft.com/sles/15/prod microsoft
-```
+    ```bash
+    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
+    sudo zypper addrepo --check --refresh --name 'Microsoft' https://packages.microsoft.com/sles/15/prod microsoft
+    ```
 
 2. Refresh the repositories.
 
-```
-sudo zypper refresh
-```
+    ```bash
+    sudo zypper refresh
+    ```
 
-3. Check if the repo has been added and the aod package is available for installation.
+3. Check if the repo has been added and the `aod` package is available for installation.
 
-```
-zypper search aod
-```
+    ```bash
+    zypper search aod
+    ```
 
 4. Install the package.
 
-```
-sudo zypper install aod
-```
+    ```bash
+    sudo zypper install aod
+    ```
 
 #### [RHEL](#tab/RHEL)
 
-Follow these instructions to install the Always-On Diagnostics tool on Red Hat Enterprise Linux 8.
+In RHEL 8, follow these instructions to install the Always-On Diagnostics tool:
 
 1. Download the repo config package.
-   
-```
-curl -ssl -O https://packages.microsoft.com/config/rhel/8/packages-microsoft-prod.rpm
-```
+
+    ```bash
+    curl -ssl -O https://packages.microsoft.com/config/rhel/8/packages-microsoft-prod.rpm
+    ```
 
 2. Install the repo config package.
-   
-```
-sudo rpm -i packages-microsoft-prod.rpm
-```
+
+    ```bash
+    sudo rpm -i packages-microsoft-prod.rpm
+    ```
 
 3. Delete the repo config package after installing and updating the package index files.
 
-```
-rm packages-microsoft-prod.rpm
-sudo dnf update
-```
+    ```bash
+    rm packages-microsoft-prod.rpm
+    sudo dnf update
+    ```
 
 4. Install the package.
 
-```
-sudo dnf install aod
-```
+    ```bash
+    sudo dnf install aod
+    ```
 
 ---