Skip to content

Commit 3e34c8d

Browse files
authored
Update troubleshoot-container-storage.md
Addressing recommendations
1 parent 9726577 commit 3e34c8d

File tree

1 file changed

+13
-13
lines changed

1 file changed

+13
-13
lines changed

articles/storage/container-storage/troubleshoot-container-storage.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ ms.topic: how-to
1616

1717
### Azure Container Storage fails to install due to missing configuration
1818

19-
After running `az aks create`, you might see the message *Azure Container Storage failed to install. AKS cluster is created. Please run `az aks update` along with `--enable-azure-container-storage` to enable Azure Container Storage*.
19+
After running `az aks create`, you might see the message *Azure Container Storage failed to install. AKS cluster is created. Run `az aks update` along with `--enable-azure-container-storage` to enable Azure Container Storage*.
2020

2121
This message means that Azure Container Storage wasn't installed, but your AKS (Azure Kubernetes Service) cluster was created properly.
2222

@@ -55,7 +55,7 @@ To add the `acstor` namespace to the exclusion list, follow these steps:
5555

5656
### Can't install and enable Azure Container Storage in node pools with taints
5757

58-
You might configure [node taints](/azure/aks/use-node-taints) on the node pools to restrict pods from being scheduled on these node pools. Installing and enabling Azure Container Storage on these noode pools will be blocked because the required pods can't be created in these node pools. The behavior applies to both the system node pool when installing and the user node pools when enabling.
58+
You might configure [node taints](/azure/aks/use-node-taints) on the node pools to restrict pods from being scheduled on these node pools. Installing and enabling Azure Container Storage on these node pools may be blocked because the required pods can't be created in these node pools. The behavior applies to both the system node pool when installing and the user node pools when enabling.
5959

6060
You can check the node taints with the following example:
6161

@@ -89,7 +89,7 @@ $ az aks nodepool list -g $resourceGroup --cluster-name $clusterName --query "[]
8989

9090
```
9191

92-
Retry the installing or enabling after you remove node taints successfully. After it completes successfully, you can configure node taints back to resume the pod scheduling restaints.
92+
Retry the installing or enabling after you remove node taints successfully. After it completes successfully, you can configure node taints back to resume the pod scheduling restraints.
9393

9494
### Can't set storage pool type to NVMe
9595

@@ -114,7 +114,7 @@ Run the following steps to enable Azure Container Storage to manage these local
114114
NAMESPACE NAME CAPACITY AVAILABLE USED RESERVED READY AGE
115115
acstor ephemeraldisk-nvme 0 0 0 0 False 82s
116116
```
117-
Above example shows 0 capacity claimed by `ephemeraldisk-nvme` storage pool.
117+
This example shows 0 capacity claimed by `ephemeraldisk-nvme` storage pool.
118118

119119
1. Run the following command to confirm unclaimed state of these local block devices and check existing file system on the disks:
120120
```bash
@@ -129,13 +129,13 @@ Run the following steps to enable Azure Container Storage to manage these local
129129
Fs Type: ext4
130130
131131
```
132-
Above example shows that the block devices are `Unclaimed` status and there is an existing file system on the disk.
132+
This example shows that the block devices are `Unclaimed` status and there is an existing file system on the disk.
133133

134134
1. Confirm that you want to use Azure Container Storage to manage the local data disks exclusively before proceeding.
135135

136136
1. Stop and remove the daemonsets or components that manage local data disks.
137137

138-
1. Login to each node that has local data disks.
138+
1. Log in to each node that has local data disks.
139139

140140
1. Remove existing file systems from all local data disks.
141141

@@ -148,7 +148,7 @@ Run the following steps to enable Azure Container Storage to manage these local
148148
daemon set "azurecontainerstorage-ndm" successfully rolled out
149149
```
150150

151-
1. Wait a few seconds and check if the capacity from local data disks is claimed by ephemeral storage pool.
151+
1. Wait a few seconds and check if the ephemeral storage pool claims the capacity from local data disks.
152152

153153
```bash
154154
$ kubectl wait -n acstor sp --all --for condition=ready
@@ -161,11 +161,11 @@ Run the following steps to enable Azure Container Storage to manage these local
161161
NAMESPACE NAME CAPACITY AVAILABLE USED RESERVED READY AGE
162162
acstor ephemeraldisk-nvme 3840766820352 3812058578944 28708241408 26832871424 True 4d16h
163163
```
164-
Above example shows `ephemeraldisk-nvme` storage pool successfully claims the capacity from local NVMe disks on the nodes.
164+
This example shows `ephemeraldisk-nvme` storage pool successfully claims the capacity from local NVMe disks on the nodes.
165165

166166
### Error when trying to expand an Azure Disks storage pool
167167

168-
If your existing storage pool is less than 4 TiB (4,096 GiB), you can only expand it up to 4,095 GiB. If you try to expand beyond that, the internal PVC will show an error message about disk size or caching type limitations. Stop your VM or detach the disk and retry the operation."
168+
If your existing storage pool is less than 4 TiB (4,096 GiB), you can only expand it up to 4,095 GiB. If you try to expand beyond the limit, the internal PVC shows an error message about disk size or caching type limitations. Stop your VM or detach the disk and retry the operation."
169169

170170
To avoid errors, don't attempt to expand your current storage pool beyond 4,095 GiB if it is initially smaller than 4 TiB (4,096 GiB). Storage pools larger than 4 TiB can be expanded up to the maximum storage capacity available.
171171

@@ -183,19 +183,19 @@ To remediate, create a node pool with a VM SKU that has NVMe drives and try agai
183183

184184
### Storage pool type already enabled
185185

186-
If you try to enable a storage pool type that's already enabled, you get the following message: *Invalid `--enable-azure-container-storage` value. Azure Container Storage is already enabled for storage pool type `<storage-pool-type>` in the cluster*. You can check if you have any existing storage pools created by running `kubectl get sp -n acstor`.
186+
If you try to enable a storage pool type that exists, you get the following message: *Invalid `--enable-azure-container-storage` value. Azure Container Storage is already enabled for storage pool type `<storage-pool-type>` in the cluster*. You can check if you have any existing storage pools created by running `kubectl get sp -n acstor`.
187187

188188
### Disabling a storage pool type
189189

190190
When disabling a storage pool type via `az aks update --disable-azure-container-storage <storage-pool-type>` or uninstalling Azure Container Storage via `az aks update --disable-azure-container-storage all`, if there's an existing storage pool of that type, you get the following message:
191191

192-
*Disabling Azure Container Storage for storage pool type `<storage-pool-type>` forcefully deletes all the storage pools of the same type and affect the applications using these storage pools. Forceful deletion of storage pools can also lead to leaking of storage resources which are being consumed. Do you want to validate whether any of the storage pools of type `<storage-pool-type>` are being used before disabling Azure Container Storage? (Y/n)*
192+
*Disabling Azure Container Storage for storage pool type `<storage-pool-type>` forcefully deletes all the storage pools of the same type and it affects the applications using these storage pools. Forceful deletion of storage pools can also lead to leaking of storage resources which are being consumed. Do you want to validate whether any of the storage pools of type `<storage-pool-type>` are being used before disabling Azure Container Storage? (Y/n)*
193193

194194
If you select Y, an automatic validation runs to ensure that there are no persistent volumes created from the storage pool. Selecting n bypasses this validation and disables the storage pool type, deleting any existing storage pools and potentially affecting your application.
195195

196196
## Troubleshoot volume issues
197197

198-
### Pod pending creation due to ephemeral volume size above available capacity
198+
### Pod pending creation due to ephemeral volume size beyond available capacity
199199

200200
An ephemeral volume is allocated on a single node. When you configure the size of ephemeral volumes for your pods, the size should be less than the available capacity of a single node's ephemeral disk. Otherwise, the pod creation is in pending status.
201201

@@ -244,7 +244,7 @@ ephemeraldisk-temp-diskpool-xbtlj 75660001280 75031990272 628011008 5609
244244

245245
In this example, the available capacity of temp disk for a single node is `75031990272` bytes or 69 GiB.
246246

247-
Adjust the volume storage size below available capacity and redeploy your pod. See [Deploy a pod with a generic ephemeral volume](use-container-storage-with-temp-ssd.md#3-deploy-a-pod-with-a-generic-ephemeral-volume).
247+
Adjust the volume storage size less than available capacity and redeploy your pod. See [Deploy a pod with a generic ephemeral volume](use-container-storage-with-temp-ssd.md#3-deploy-a-pod-with-a-generic-ephemeral-volume).
248248

249249
### Volume fails to attach due to metadata store offline
250250

0 commit comments

Comments
 (0)