diff --git a/docs/csi-debug.md b/docs/csi-debug.md index dd1a2c1cd..6c15bdcf2 100644 --- a/docs/csi-debug.md +++ b/docs/csi-debug.md @@ -144,5 +144,39 @@ kubectl delete po node-debugger-node-name-xxxx +### Troubleshooting aznfs mount +> Supported from v1.22.2 +> About aznfs mount helper: https://github.com/Azure/AZNFS-mount/ + +
+Check mount point information + + +```console +kubectl debug node/node-name --image=nginx +findmnt -t nfs +``` + +The `SOURCE` of the mount point should have prefix with an ip address rather than domain name. e.g, **10.161.100.100**:/nfs02a796c105814dbebc4e/pvc-ca149059-6872-4d6f-a806-48402648110c. + +
+ + +
+Get client-side logs on Linux node + + +```console +kubectl debug node/node-name --image=nginx + +cat /opt/microsoft/aznfs/data/aznfs.log +``` + +If ip was migrated successfully, you should find logs like: +1. `IP for nfsxxxxx.blob.core.windows.net changed [1.2.3.4 -> 5.6.7.8].` +2. `Updating mountmap entry [nfsxxxxx.blob.core.windows.net 10.161.100.100 1.2.3.4 -> nfsxxxxx.blob.core.windows.net 10.161.100.100 5.6.7.8]` + +
+ ### Tips - [Troubleshoot Azure Blob storage mount issues on AKS](http://aka.ms/blobmounterror)