Merge pull request #291597 from tonyyam23/patch-resolve-conflict

Pull request for Site Decommission checklist and Runtime version check

Author: denrea

articles/operator-nexus/TOC.yml

@@ -300,6 +300,14 @@
               href: howto-service-principal-rotation.md
     - name: Install CLI Extension
       href: howto-install-cli-extensions.md
+    - name: General
+      expanded: false
+      items:
+        - name: Check runtime version
+          href: howto-check-runtime-version.md
+        - name: Site decommission checklist
+          href: howto-decommission-nexus-instance-checklist.md
+      
 - name: Troubleshooting
   expanded: true
   items:

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

@@ -570,3 +570,19 @@ Expected output:
   "type": "microsoft.managednetworkfabric/routepolicies"
 }
 ```
+### Delete route policy
+
+This command deletes route policies:
+
+
+```Azurecli
+az networkfabric routepolicy delete --resource-group "ResourceGroupName" --resource-name "rcf-Fab3-l3domain-v6-connsubnet-ext-policy"
+```
+Expected output:
+
+```Output
+{
+  "status": "Succeeded",
+  "message": "The route policy 'rcf-Fab3-l3domain-v6-connsubnet-ext-policy' in resource group 'ResourceGroupName' has been successfully deleted."
+}
+```

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

@@ -0,0 +1,59 @@
+---
+title: "Azure Operator Nexus: How to check runtime version for Azure Operator Nexus"
+description: Learn to check the runtime version of the key components in Azure Operator Nexus.
+author: tonyyam23
+ms.author: tonyyam
+ms.service: azure-operator-nexus
+ms.custom: azure-operator-nexus, devx-track-azurecli
+ms.topic: how-to
+ms.date: 12/03/2024
+#ms.custom: template-include
+---
+
+# How to check current runtime version for Azure Operator Nexus
+This how-to guide explains the steps to determine the runtime version of the key components in Azure Operator Nexus.
+
+## Prerequisites
+
+* The [Install Azure CLI](/cli/azure/install-azure-cli) must be installed.
+* 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)
+* Access to the Azure portal for the target cluster to be upgraded.
+* You must be logged in to the same subscription as your target cluster via `az login`
+
+## Check current Cluster runtime version
+
+### Via Azure portal
+
+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"
+
+:::image type="content" source="media\cluster-runtime-version-screenshot.png" alt-text="Screenshot of cluster runtime version." lightbox="media\cluster-runtime-version-screenshot.png":::
+
+### Via Azure CLI
+
+Current Runtime cluster version is retrievable via the Azure CLI:
+
+```azurecli
+az networkcloud cluster show --name "clusterName" --resource-group "cls_resourceGroup" --query "{name:name, version:clusterVersion}" -o json
+{
+  "name": "sample_clsName",
+  "version": "3.14.1"
+}
+```
+
+## Check current Fabric runtime version
+
+### Via Azure portal
+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"
+
+:::image type="content" source="media\fabric-runtime-version-screenshot.png" alt-text="Screenshot of fabric runtime version." lightbox="media\fabric-runtime-version-screenshot.png":::
+
+### Via Azure CLI
+Current Runtime fabric version is retrievable via the Azure CLI:
+```azurecli
+az networkfabric fabric show --resource-name "fabricName" --resource-group "fab_resourceGroup" --query "{name:name, version:fabricVersion}" -o json
+{
+  "name": "Sample_fabName",
+  "version": "3.0.0"
+}
+```
+

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

@@ -22,9 +22,13 @@ This how-to guide explains the steps for installing the required Azure CLI and e
 - You must be logged in to the same subscription as your target cluster via `az login`
 - 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.
 
+## Checking current runtime version
+Verify current cluster runtime version before upgrade:
+[How to check current cluster runtime version.](./howto-check-runtime-version.md#check-current-cluster-runtime-version)
+
 ## Finding available runtime versions
 
-### Via Portal
+### Via Azure portal
 
 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.
 

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

@@ -0,0 +1,47 @@
+---
+title: "Azure Operator Nexus: How to decommission Azure Operator Nexus instance checklist"
+description: High-level checklist to cover all essential steps required for decommissioning Azure Operator Nexus instance.
+
+
+
+author: tonyyam23
+ms.author: tonyyam
+ms.service: azure-operator-nexus
+ms.custom: azure-operator-nexus, devx-track-azurecli
+ms.topic: how-to
+ms.date: 12/03/2024
+# ms.custom: template-include
+---
+
+# Check list to decommission Azure Operator Nexus instance
+## Decommission checklist details
+
+1. Perform tenant network resources and workload clean up, including but not limited to VMs and Nexus Kubernetes Clusters
+
+2. [Disable/Delete L3 ISD (Isolation Domain) resources](./howto-delete-layer-3-isolation-domains.md)
+
+3. [Disable/Delete L2 ISD (Isolation Domain) resources](./howto-configure-isolation-domain.md#delete-l2-isolation-domain)
+
+4. [Delete Keysets resources](./howto-baremetal-bmc-ssh.md#deleting-a-bmc-keyset)
+
+5. [Delete Cluster resource](./howto-configure-cluster.md#delete-a-cluster)
+
+6. [Delete Cluster Manager resource](./howto-cluster-manager.md#delete-cluster-manager)
+
+7. [Deprovision Fabric](./howto-configure-network-fabric.md#deleting-fabric)
+
+8. [Clean up ACL (Access Control List) resources](./howto-delete-access-control-list-network-to-network-interconnect.md)
+
+9. [Clean up RoutePolicy resources (if present)](./how-to-route-policy.md#delete-route-policy)
+
+10. [Delete Fabric resource](./howto-configure-network-fabric.md#deleting-fabric)
+
+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)
+
+12. [Delete Network Fabric Controller (NFC) resource](./howto-configure-network-fabric-controller.md#delete-network-fabric-controller)
+    
+    > [!NOTE]
+    > Only delete Network Fabric Controller (NFC) if the fabric being deleted was the only fabric associated to the NFC.
+
+## Support and questions
+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

@@ -31,8 +31,12 @@ Confirm that the Network Fabric Controller is in a 'Provisioned' state.
 
 ### **Upgrade workflow**
 
-#### **Step 1: Initiate upgrade**
+#### **Step 1: Verify Fabric runtime version**
 
+Verify current fabric runtime version before upgrade:
+    [How to check current cluster runtime version.](./howto-check-runtime-version.md#check-current-fabric-runtime-version)
+
+#### **Step 2: Initiate upgrade**
 Start the upgrade with the following command:
 
 ```Azure CLI
@@ -57,7 +61,7 @@ Replace `myResourceGroup` and `myFabricName` with the actual names of your resou
 > [!NOTE]
 > This command places the NetworkFabric in 'Under Maintenance'.
 
-#### **Step 2: Device-specific upgrades**
+#### **Step 3: Device-specific upgrades**
 
 Follow the recommended sequence for device upgrades, addressing any failures manually if necessary.
 
@@ -102,7 +106,7 @@ az networkfabric device upgrade --version 2.0.0 -g myResourceGroup --resource-na
 
 Replace `myResourceGroup` and `myDeviceName` with the actual names of your resource group and device, respectively.
 
-#### **Step 3: Finalize upgrade**
+#### **Step 4: Finalize upgrade**
 
 After updating all devices, run the completion command to exit maintenance mode: