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: AKS-Arc/tsg-aksarc-upgrade-issues.md
+7-6Lines changed: 7 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,11 +11,11 @@ ms.reviewer: abha
11
11
12
12
# Troubleshoot the issue when the AKS Arc cluster is stuck in 'Upgrading' state
13
13
14
-
This article describes how to fix the issue when your AKS Arc cluster is stuck in 'Upgrading' state, when you try to upgrade the Kubernetes version on your cluster. This issue typically occurs after updating ASZ Local to version 2503 or 2504.
14
+
This article describes how to fix the issue when your Azure Kubernetes Service enablied by Arc (AKS Arc) cluster is stuck in 'Upgrading' state, when you try to upgrade the Kubernetes version on your cluster. This issue typically occurs after updating Azure Local to version 2503 or 2504.
15
15
16
16
## Symptoms
17
17
18
-
When you try to upgrade an AKS Arc cluster, you notice that the **Current state** property of the cluster continues to show as 'Upgrading', as shown below:
18
+
When you try to upgrade an AKS Arc cluster, you notice that the **Current state** property of the cluster continues to show as 'Upgrading'.
19
19
20
20
```output
21
21
az aksarc upgrade --name "cluster-name" --resource-group "rg-name"
@@ -48,7 +48,7 @@ Upgrading the AKSArc cluster. This operation might take a while...
48
48
## Possible causes and follow-ups
49
49
50
50
- The root cause is a recent change introduced in Azure Local version 2503. Under certain conditions, transient or intermittent failures during the Kubernetes upgrade process are not correctly detected or recovered from, leading the cluster state to remain indefinitely in the 'Upgrading' state.
51
-
- You will hit this issue if the version of the AKS Arc extension on your custom location - the `hybridaksextension` extension's version is 2.1.211 or 2.1.223. You can run the following command to check the extension version on your cluster:
51
+
- You hit this issue if the version of the AKS Arc extension on your custom location - the `hybridaksextension` extension's version is 2.1.211 or 2.1.223. You can run the following command to check the extension version on your cluster:
52
52
53
53
```azurecli
54
54
az login --use-device-code --tenant <Azure tenant ID>
@@ -59,7 +59,7 @@ az k8s-extension show -g $res.HybridaksExtension.resourceGroup -c $res.ResourceB
59
59
60
60
61
61
## Mitigation
62
-
This issue can be resolved by invoking the AKS Arc update call. This will retrigger the upgrade flow as well. You can invoke the `aksarc update` command with some placeholder parameters. So in this case, you could invoke the update call to enable NFS or SMB drivers if those features are not already enabled. First, check whether any of the features enabled
62
+
This issue can be resolved by invoking the AKS Arc update call. The `update` command will retrigger the upgrade flow as well. You can invoke the `aksarc update` command with some placeholder parameters. So in this case, you could invoke the update call to enable NFS or SMB drivers if those features are not already enabled. First, check whether any of the features enabled
63
63
64
64
```azurecli
65
65
az login --use-device-code --tenant <Azure tenant ID>
@@ -73,6 +73,7 @@ Check the storage profile setion:
73
73
"enabled": false
74
74
},
75
75
"smbCsiDriver": {
76
+
76
77
"enabled": true
77
78
}
78
79
}
@@ -91,10 +92,10 @@ Running the `aksarc update` command should resolve the issue and the `Current st
91
92
az aksarc update --disable-smb-driver -g <resource_group_name> -n <cluster_name>
92
93
az aksarc update --disable-nfs-driver -g <resource_group_name> -n <cluster_name>
93
94
```
94
-
If you find that both of the drivers are enabled on your cluster, you can disable the driver you are not using. If you are using both drivers, please contact the support team for further instructions.
95
+
If both drivers are already enabled on your cluster, you can disable the one that is not in use. If you require both drivers to remain enabled, contact Microsoft Support for further assistance.
95
96
96
97
## Verification
97
-
You can check that the K8s version upgrade has completed, and state has moved to Succeeded, by running the following command and checking for the **Current State** parameter in the JSON.
98
+
Run the following command and check that the **Current State** parameter in the JSON output is set to 'Succeeded' to confirm the K8s version upgrade is complete.
98
99
99
100
```azurecli
100
101
az aksarc show -g <resource_group> -n <cluster_name>
0 commit comments