Skip to content

Commit d50e2ab

Browse files
authored
Update howto-cluster-runtime-upgrade-template.md
Resolve comments
1 parent afe0b04 commit d50e2ab

File tree

1 file changed

+12
-21
lines changed

1 file changed

+12
-21
lines changed

articles/operator-nexus/howto-cluster-runtime-upgrade-template.md

Lines changed: 12 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -53,28 +53,11 @@ Runtime changes are categorized as follows:
5353
- <DEPLOYMENT_PAUSE_MINS>: Time to wait before moving to the next Rack once the current Rack meets the deployment threshold
5454
- <NFC_NAME>: Associated Network Fabric Controller (NFC)
5555
- <CM_NAME>: Associated Cluster Manager (CM)
56-
- <ETCD_LAST_ROTATION_DATE>: Control plane etcd credential last rotation date
57-
- <ETCD_ROTATION_DAYS>: Control plane etcd credential next rotation period
5856
- <BMM_ISSUE_LIST>: List of BMM with provisioning issues after Cluster upgrade is complete
5957

6058
## Pre-Checks
6159

62-
1. On each control-plane Bare Metal Machine (BMM), verify the next rotation date on `etcd credential` doesn't occur during the upgrade:
63-
- Check in Azure portal from the following path: `Clusters` -> <CLUSTER_NAME> -> `Resources` -> `Bare Metal Machines`
64-
- Select each BMM with `control-plane` under the `Role`: <CLUSTER_CONTROL_BMM> -> `JSON View`
65-
- Validate the `lastRotationTime` and `rotationPeriodDays` under the `etcd credential` section:
66-
```
67-
{
68-
"lastRotationTime": "<ETCD_LAST_ROTATION_DATE>",
69-
"rotationPeriodDays": <ETCD_ROTATION_DAYS>,
70-
"secretType": "etcd credential"
71-
}
72-
```
73-
74-
>[!Important]
75-
> If the upgrade will occur within three days of the next `etcd credential` rotation (<ETCD_LAST_ROTATION_DATE> + <ETCD_ROTATION_DAYS>), contact Miscrosoft Support to complete a manual rotation before starting the upgrade.
76-
77-
2. Validate the provisioning and detailed status for the CM and Cluster.
60+
1. Validate the provisioning and detailed status for the CM and Cluster.
7861

7962
Set up the subscription, CM, and Cluster parameters:
8063
```
@@ -102,7 +85,7 @@ Runtime changes are categorized as follows:
10285
>[!Note]
10386
> If CM `Provisioning state` isn't `Succeeded` and Cluster `Detailed status` isn't `Running` stop the upgrade until issues are resolved.
10487
105-
3. Check the Bare Metal Machine status `Detailed status` is `Running`:
88+
2. Check the Bare Metal Machine status `Detailed status` is `Running`:
10689
```
10790
az networkcloud baremetalmachine list -g $CLUSTER_MRG --subscription $SUBSCRIPTION_ID --query "sort_by([].{name:name,kubernetesNodeName:kubernetesNodeName,location:location,readyState:readyState,provisioningState:provisioningState,detailedStatus:detailedStatus,detailedStatusMessage:detailedStatusMessage,cordonStatus:cordonStatus,powerState:powerState,kubernetesVersion:kubernetesVersion,machineClusterVersion:machineClusterVersion,machineRoles:machineRoles| join(', ', @),createdAt:systemData.createdAt}, &name)" -o table
10891
```
@@ -114,14 +97,14 @@ Runtime changes are categorized as follows:
11497
- CordonStatus: Uncordoned
11598
- PowerState: On
11699

117-
4. Collect a profile of the tenant workloads:
100+
3. Collect a profile of the tenant workloads:
118101
```
119102
az networkcloud clustermanager show -g $CM_RG --resource-name $CM_NAME --subscription $SUBSCRIPTION_ID -o table
120103
az networkcloud virtualmachine list --sub $SUBSCRIPTION_ID --query "reverse(sort_by([?clusterId=='$CLUSTER_RID'].{name:name, createdAt:systemData.createdAt, resourceGroup:resourceGroup, powerState:powerState, provisioningState:provisioningState, detailedStatus:detailedStatus,bareMetalMachineId:bareMetalMachineIdi,CPUCount:cpuCores, EmulatorStatus:isolateEmulatorThread}, &createdAt))" -o table
121104
az networkcloud kubernetescluster list --sub $SUBSCRIPTION_ID --query "[?clusterId=='$CLUSTER_RID'].{name:name, resourceGroup:resourceGroup, provisioningState:provisioningState, detailedStatus:detailedStatus, detailedStatusMessage:detailedStatusMessage, createdAt:systemData.createdAt, kubernetesVersion:kubernetesVersion}" -o table
122105
```
123106

124-
5. Review Operator Nexus Release notes for required checks and configuration updates not included in this document.
107+
4. Review Operator Nexus Release notes for required checks and configuration updates not included in this document.
125108

126109
## Send notification to Operations of upgrade schedule for the Cluster.
127110

@@ -296,6 +279,14 @@ Run the following commands to check the status of the CM, Cluster, and BMM:
296279
- CordonStatus: Uncordoned
297280
- PowerState: On
298281

282+
>[!Note]
283+
> One control-plane BMM is labeled as a spare with the following BMM status profile:
284+
> - ReadyState: False
285+
> - ProvisioningState: Succeeded
286+
> - DetailedStatus: Available
287+
> - CordonStatus: Uncordoned
288+
> - PowerState: Off
289+
299290
4. Collect a profile of the tenant workloads:
300291
```
301292
az networkcloud clustermanager show -g $CM_RG --resource-name $CM_NAME --subscription $SUBSCRIPTION_ID -o table

0 commit comments

Comments
 (0)