|
| 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) |
0 commit comments