Skip to content

Commit cd43a5a

Browse files
denreadenrea
authored
Merge pull request #291597 from tonyyam23/patch-resolve-conflict
Pull request for Site Decommission checklist and Runtime version check
2 parents 534fb0a + 28c9830 commit cd43a5a

8 files changed

+142
-4
lines changed

‎articles/operator-nexus/TOC.yml

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -300,6 +300,14 @@
300300
href: howto-service-principal-rotation.md
301301
- name: Install CLI Extension
302302
href: howto-install-cli-extensions.md
303+
- name: General
304+
expanded: false
305+
items:
306+
- name: Check runtime version
307+
href: howto-check-runtime-version.md
308+
- name: Site decommission checklist
309+
href: howto-decommission-nexus-instance-checklist.md
310+
303311
- name: Troubleshooting
304312
expanded: true
305313
items:

‎articles/operator-nexus/how-to-route-policy.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -570,3 +570,19 @@ Expected output:
570570
"type": "microsoft.managednetworkfabric/routepolicies"
571571
}
572572
```
573+
### Delete route policy
574+
575+
This command deletes route policies:
576+
577+
578+
```Azurecli
579+
az networkfabric routepolicy delete --resource-group "ResourceGroupName" --resource-name "rcf-Fab3-l3domain-v6-connsubnet-ext-policy"
580+
```
581+
Expected output:
582+
583+
```Output
584+
{
585+
"status": "Succeeded",
586+
"message": "The route policy 'rcf-Fab3-l3domain-v6-connsubnet-ext-policy' in resource group 'ResourceGroupName' has been successfully deleted."
587+
}
588+
```

‎articles/operator-nexus/howto-check-runtime-version.md

Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
1+
---
2+
title: "Azure Operator Nexus: How to check runtime version for Azure Operator Nexus"
3+
description: Learn to check the runtime version of the key components in Azure Operator Nexus.
4+
author: tonyyam23
5+
ms.author: tonyyam
6+
ms.service: azure-operator-nexus
7+
ms.custom: azure-operator-nexus, devx-track-azurecli
8+
ms.topic: how-to
9+
ms.date: 12/03/2024
10+
#ms.custom: template-include
11+
---
12+
13+
# How to check current runtime version for Azure Operator Nexus
14+
This how-to guide explains the steps to determine the runtime version of the key components in Azure Operator Nexus.
15+
16+
## Prerequisites
17+
18+
* The [Install Azure CLI](/cli/azure/install-azure-cli) must be installed.
19+
* The `networkcloud` CLI extension is required. If the `networkcloud` extension isn't installed, it can be installed following the steps listed [here](./howto-install-cli-extensions.md)
20+
* Access to the Azure portal for the target cluster to be upgraded.
21+
* You must be logged in to the same subscription as your target cluster via `az login`
22+
23+
## Check current Cluster runtime version
24+
25+
### Via Azure portal
26+
27+
To check current cluster runtime version, navigate to the cluster in the Azure portal. In the cluster's overview pane, navigate to the ***Properties*** tab and look for "Cluster version"
28+
29+
:::image type="content" source="media\cluster-runtime-version-screenshot.png" alt-text="Screenshot of cluster runtime version." lightbox="media\cluster-runtime-version-screenshot.png":::
30+
31+
### Via Azure CLI
32+
33+
Current Runtime cluster version is retrievable via the Azure CLI:
34+
35+
```azurecli
36+
az networkcloud cluster show --name "clusterName" --resource-group "cls_resourceGroup" --query "{name:name, version:clusterVersion}" -o json
37+
{
38+
"name": "sample_clsName",
39+
"version": "3.14.1"
40+
}
41+
```
42+
43+
## Check current Fabric runtime version
44+
45+
### Via Azure portal
46+
To check current fabric runtime version, navigate to the fabric in the Azure portal. In the fabric's overview pane, navigate to the ***Properties*** tab and look for "Fabric version"
47+
48+
:::image type="content" source="media\fabric-runtime-version-screenshot.png" alt-text="Screenshot of fabric runtime version." lightbox="media\fabric-runtime-version-screenshot.png":::
49+
50+
### Via Azure CLI
51+
Current Runtime fabric version is retrievable via the Azure CLI:
52+
```azurecli
53+
az networkfabric fabric show --resource-name "fabricName" --resource-group "fab_resourceGroup" --query "{name:name, version:fabricVersion}" -o json
54+
{
55+
"name": "Sample_fabName",
56+
"version": "3.0.0"
57+
}
58+
```
59+

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

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,9 +22,13 @@ This how-to guide explains the steps for installing the required Azure CLI and e
2222
- You must be logged in to the same subscription as your target cluster via `az login`
2323
- Target cluster must be in a running state, with all control plane nodes healthy and 80+% of compute nodes in a running and healthy state.
2424

25+
## Checking current runtime version
26+
Verify current cluster runtime version before upgrade:
27+
[How to check current cluster runtime version.](./howto-check-runtime-version.md#check-current-cluster-runtime-version)
28+
2529
## Finding available runtime versions
2630

27-
### Via Portal
31+
### Via Azure portal
2832

2933
To find available upgradeable runtime versions, navigate to the target cluster in the Azure portal. In the cluster's overview pane, navigate to the ***Available upgrade versions*** tab.
3034

‎articles/operator-nexus/howto-decommission-nexus-instance-checklist.md

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
---
2+
title: "Azure Operator Nexus: How to decommission Azure Operator Nexus instance checklist"
3+
description: High-level checklist to cover all essential steps required for decommissioning Azure Operator Nexus instance.
4+
5+
6+
7+
author: tonyyam23
8+
ms.author: tonyyam
9+
ms.service: azure-operator-nexus
10+
ms.custom: azure-operator-nexus, devx-track-azurecli
11+
ms.topic: how-to
12+
ms.date: 12/03/2024
13+
# ms.custom: template-include
14+
---
15+
16+
# Check list to decommission Azure Operator Nexus instance
17+
## Decommission checklist details
18+
19+
1. Perform tenant network resources and workload clean up, including but not limited to VMs and Nexus Kubernetes Clusters
20+
21+
2. [Disable/Delete L3 ISD (Isolation Domain) resources](./howto-delete-layer-3-isolation-domains.md)
22+
23+
3. [Disable/Delete L2 ISD (Isolation Domain) resources](./howto-configure-isolation-domain.md#delete-l2-isolation-domain)
24+
25+
4. [Delete Keysets resources](./howto-baremetal-bmc-ssh.md#deleting-a-bmc-keyset)
26+
27+
5. [Delete Cluster resource](./howto-configure-cluster.md#delete-a-cluster)
28+
29+
6. [Delete Cluster Manager resource](./howto-cluster-manager.md#delete-cluster-manager)
30+
31+
7. [Deprovision Fabric](./howto-configure-network-fabric.md#deleting-fabric)
32+
33+
8. [Clean up ACL (Access Control List) resources](./howto-delete-access-control-list-network-to-network-interconnect.md)
34+
35+
9. [Clean up RoutePolicy resources (if present)](./how-to-route-policy.md#delete-route-policy)
36+
37+
10. [Delete Fabric resource](./howto-configure-network-fabric.md#deleting-fabric)
38+
39+
11. [Disable DHCP (Dynamic Host Configuration Protocol) and put devices into ZTP (Zero Touch Provisioning) mode](./howto-platform-prerequisites.md#default-setup-for-other-devices-installed)
40+
41+
12. [Delete Network Fabric Controller (NFC) resource](./howto-configure-network-fabric-controller.md#delete-network-fabric-controller)
42+
43+
> [!NOTE]
44+
> Only delete Network Fabric Controller (NFC) if the fabric being deleted was the only fabric associated to the NFC.
45+
46+
## Support and questions
47+
For further technical questions or assistance, [contact support](https://portal.azure.com/?#blade/Microsoft_Azure_Support/HelpAndSupportBlade). For more information about Support plans, see [Azure Support plans](https://azure.microsoft.com/support/plans/response/).

‎articles/operator-nexus/howto-upgrade-nexus-fabric.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -31,8 +31,12 @@ Confirm that the Network Fabric Controller is in a 'Provisioned' state.
3131

3232
### **Upgrade workflow**
3333

34-
#### **Step 1: Initiate upgrade**
34+
#### **Step 1: Verify Fabric runtime version**
3535

36+
Verify current fabric runtime version before upgrade:
37+
[How to check current cluster runtime version.](./howto-check-runtime-version.md#check-current-fabric-runtime-version)
38+
39+
#### **Step 2: Initiate upgrade**
3640
Start the upgrade with the following command:
3741

3842
```Azure CLI
@@ -57,7 +61,7 @@ Replace `myResourceGroup` and `myFabricName` with the actual names of your resou
5761
> [!NOTE]
5862
> This command places the NetworkFabric in 'Under Maintenance'.
5963
60-
#### **Step 2: Device-specific upgrades**
64+
#### **Step 3: Device-specific upgrades**
6165

6266
Follow the recommended sequence for device upgrades, addressing any failures manually if necessary.
6367

@@ -102,7 +106,7 @@ az networkfabric device upgrade --version 2.0.0 -g myResourceGroup --resource-na
102106

103107
Replace `myResourceGroup` and `myDeviceName` with the actual names of your resource group and device, respectively.
104108

105-
#### **Step 3: Finalize upgrade**
109+
#### **Step 4: Finalize upgrade**
106110

107111
After updating all devices, run the completion command to exit maintenance mode:
108112

‎articles/operator-nexus/media/cluster-runtime-version-screenshot.png

14.5 KB
Loading

‎articles/operator-nexus/media/fabric-runtime-version-screenshot.png

18.7 KB
Loading

0 commit comments

Comments
 (0)