Skip to content

Commit 2fbd4cc

Browse files
committed
Add PauseRack docs
1 parent 515822d commit 2fbd4cc

File tree

3 files changed

+66
-0
lines changed

3 files changed

+66
-0
lines changed
Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
---
2+
title: "Azure Operator Nexus: Runtime upgrade with rack pause strategy"
3+
description: Learn to execute a cluster runtime upgrade for Operator Nexus with a pause rack strategy
4+
author: vivekjMSFT
5+
ms.author: vija
6+
ms.service: azure-operator-nexus
7+
ms.topic: how-to
8+
ms.date: 08/16/2024
9+
# ms.custom: template-include
10+
---
11+
12+
# Upgrading cluster runtime with a pause rack strategy
13+
14+
This how-to guide explains the steps to execute a cluster runtime upgrade with pasue rack strategy. Executing cluster runtime upgrade with "PauseRack" strategy will update a single rack in a cluster and then pause to wait for confirmation before moving to the next rack. All existing thresholds will still be honoried with pause rack strategy.
15+
16+
## Prerequisites
17+
18+
Please follow the steps mentioned in prerequistie section of [Upgrading cluster runtime from Azure CLI](./howto-cluster-runtime-upgrade.md)
19+
20+
> **Note:**
21+
> Upgrades with the Rack Pause strategy will only work after the management bundle (CMBU) has been upgraded to 3.8 or greater.
22+
23+
## Procedure
24+
25+
1. Enable Rack Pause upgrade strategy on a Nexus cluster
26+
27+
> **Note:**
28+
> choose threshold value as desired.
29+
30+
Example:
31+
32+
```azurecli
33+
az networkcloud cluster update --name "clusterName" --resource-group "resourceGroupName" --update-strategy \
34+
strategy-type="PauseRack" \
35+
wait-time-minutes=0 \
36+
<threshold values as desired>
37+
```
38+
39+
2. Confirm that the cluster resource JSON in the JSON View reflects the rack pause upgrade strategy.
40+
41+
```shell
42+
az networkcloud cluster show --cluster-name "clusterName" --resource-group "resourceGroupName"
43+
```
44+
45+
:::image type="content" source="media/runtime-upgrade-cluster-pause-rack-strategy.png" alt-text="Runtime upgrade strategy property details":::
46+
47+
3. Trigger runtime bundle upgrade as usual from Azure portal / CLI. for reference [Upgrading cluster runtime from Azure CLI](./howto-cluster-runtime-upgrade.md)
48+
49+
4. Once Rack 1 has completed, the runtime upgrade will pause, awaiting user action to resume the runtime upgrade for Rack 2.
50+
51+
:::image type="content" source="media/runtime-upgrade-cluster-paused.png" alt-text="Paused Runtime Upgrade":::
52+
53+
5. To resume the runtime upgrade, execute the following `az networkcloud` cli command to trigger the continue upgrade version action.
54+
55+
```shell
56+
az networkcloud cluster continue-update-version \
57+
--subscription=$SUBSCRIPTION \
58+
--resource-group=$RESOURCE_GROUP \
59+
--cluster-name=$CLUSTER_NAME
60+
```
61+
62+
6. Continue repeating step 5 for each rack until all racks have been upgraded to the latest runtime bundle.
63+
64+
## Related content
65+
66+
- [Upgrading cluster runtime from Azure CLI](./howto-cluster-runtime-upgrade.md)
57.9 KB
Loading
52.7 KB
Loading

0 commit comments

Comments
 (0)