Skip to content

Commit 45bdbc0

Browse files
authored
Merge pull request #8076 from khdownie/kendownie012125-2
Add AOD tool to NFS doc
2 parents 2a130d6 + 1bc1431 commit 45bdbc0

1 file changed

Lines changed: 71 additions & 1 deletion

File tree

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

Lines changed: 71 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Troubleshoot NFS file shares - Azure Files
33
description: Troubleshoot issues with NFS Azure file shares.
44
ms.service: azure-file-storage
55
ms.custom: sap:Security, linux-related-content
6-
ms.date: 10/11/2024
6+
ms.date: 01/21/2025
77
ms.reviewer: kendownie
88
---
99

@@ -24,6 +24,76 @@ This article lists common issues related to NFS Azure file shares and provides p
2424
| Standard file shares (GPv2), GRS/GZRS | :::image type="icon" source="media/files-troubleshoot-linux-nfs/no-icon.png" border="false"::: | :::image type="icon" source="media/files-troubleshoot-linux-nfs/no-icon.png" border="false"::: |
2525
| Premium file shares (FileStorage), LRS/ZRS | :::image type="icon" source="media/files-troubleshoot-linux-nfs/no-icon.png" border="false"::: | :::image type="icon" source="media/files-troubleshoot-linux-nfs/yes-icon.png" border="false":::|
2626

27+
## Use the Always-On Diagnostics tool
28+
29+
You can use the Always-On Diagnostics (AOD) tool to collect logs on NFSv4 and SMB 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. The tool can be useful for collecting debug information on field issues that can be hard to reproduce.
30+
31+
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.
32+
33+
### [RHEL](#tab/RHEL)
34+
35+
Follow these instructions to install the Always-On Diagnostics tool on Red Hat Enterprise Linux 8.
36+
37+
1. Download the repo config package.
38+
39+
```
40+
curl -ssl -O https://packages.microsoft.com/config/rhel/8/packages-microsoft-prod.rpm
41+
```
42+
43+
2. Install the repo config package.
44+
45+
```
46+
sudo rpm -i packages-microsoft-prod.rpm
47+
```
48+
49+
3. Delete the repo config package after installing and updating the package index files.
50+
51+
```
52+
rm packages-microsoft-prod.rpm
53+
sudo dnf update
54+
```
55+
56+
4. Install the package.
57+
58+
```
59+
sudo dnf install aod
60+
```
61+
62+
### [SLES](#tab/SLES)
63+
64+
Follow these instructions to install the Always-On Diagnostics tool on SUSE Linux Enterprise Server 15.
65+
66+
1. Add the Microsoft repo. You might need to add the Microsoft repository key to your list of trusted keys.
67+
68+
```
69+
sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
70+
sudo zypper addrepo --check --refresh --name 'Microsoft' https://packages.microsoft.com/sles/15/prod microsoft
71+
```
72+
73+
2. Refresh the repositories.
74+
75+
```
76+
sudo zypper refresh
77+
```
78+
79+
3. Check if the repo has been added and the aod package is available for installation.
80+
81+
```
82+
zypper search aod
83+
```
84+
85+
4. Install the package.
86+
87+
```
88+
sudo zypper install aod
89+
```
90+
91+
### [Ubuntu](#tab/Ubuntu)
92+
93+
The Always-On Diagnostics tool is not yet available for Ubuntu.
94+
95+
---
96+
2797
## chgrp "filename" failed: Invalid argument (22)
2898

2999
### Cause 1: idmapping isn't disabled

0 commit comments

Comments
 (0)