You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/storage/container-storage/troubleshoot-container-storage.md
+13-13Lines changed: 13 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -16,7 +16,7 @@ ms.topic: how-to
16
16
17
17
### Azure Container Storage fails to install due to missing configuration
18
18
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*.
20
20
21
21
This message means that Azure Container Storage wasn't installed, but your AKS (Azure Kubernetes Service) cluster was created properly.
22
22
@@ -55,7 +55,7 @@ To add the `acstor` namespace to the exclusion list, follow these steps:
55
55
56
56
### Can't install and enable Azure Container Storage in node pools with taints
57
57
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.
59
59
60
60
You can check the node taints with the following example:
61
61
@@ -89,7 +89,7 @@ $ az aks nodepool list -g $resourceGroup --cluster-name $clusterName --query "[]
89
89
90
90
```
91
91
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.
93
93
94
94
### Can't set storage pool type to NVMe
95
95
@@ -114,7 +114,7 @@ Run the following steps to enable Azure Container Storage to manage these local
114
114
NAMESPACE NAME CAPACITY AVAILABLE USED RESERVED READY AGE
115
115
acstor ephemeraldisk-nvme 0 0 0 0 False 82s
116
116
```
117
-
Above example shows 0 capacity claimed by `ephemeraldisk-nvme` storage pool.
117
+
This example shows 0 capacity claimed by `ephemeraldisk-nvme` storage pool.
118
118
119
119
1. Run the following command to confirm unclaimed state of these local block devices and check existing file system on the disks:
120
120
```bash
@@ -129,13 +129,13 @@ Run the following steps to enable Azure Container Storage to manage these local
129
129
Fs Type: ext4
130
130
…
131
131
```
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.
133
133
134
134
1. Confirm that you want to use Azure Container Storage to manage the local data disks exclusively before proceeding.
135
135
136
136
1. Stop and remove the daemonsets or components that manage local data disks.
137
137
138
-
1.Login to each node that has local data disks.
138
+
1.Log in to each node that has local data disks.
139
139
140
140
1. Remove existing file systems from all local data disks.
141
141
@@ -148,7 +148,7 @@ Run the following steps to enable Azure Container Storage to manage these local
148
148
daemon set"azurecontainerstorage-ndm" successfully rolled out
149
149
```
150
150
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.
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.
165
165
166
166
### Error when trying to expand an Azure Disks storage pool
167
167
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."
169
169
170
170
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.
171
171
@@ -183,19 +183,19 @@ To remediate, create a node pool with a VM SKU that has NVMe drives and try agai
183
183
184
184
### Storage pool type already enabled
185
185
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`.
187
187
188
188
### Disabling a storage pool type
189
189
190
190
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:
191
191
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)*
193
193
194
194
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.
195
195
196
196
## Troubleshoot volume issues
197
197
198
-
### Pod pending creation due to ephemeral volume size above available capacity
198
+
### Pod pending creation due to ephemeral volume size beyond available capacity
199
199
200
200
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.
In this example, the available capacity of temp disk for a single node is `75031990272` bytes or 69 GiB.
246
246
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).
248
248
249
249
### Volume fails to attach due to metadata store offline
0 commit comments