Skip to content

Commit b2281e6

Browse files
sushantjraosushantjrao
committed
updated the content
1 parent dfedbd0 commit b2281e6

File tree

3 files changed

+25
-20
lines changed

3 files changed

+25
-20
lines changed

‎articles/operator-nexus/.openpublishing.redirection.operator-nexus.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,11 @@
4040
"redirect_url": "howto-apply-access-control-list-to-network-to-network-interconnects",
4141
"redirect_document_id": false
4242
},
43+
{
44+
"source_path": "howto-replace-a-device-in-azure-operator-nexus-network-fabric.md",
45+
"redirect_url": "howto-replace-a-device-in-azure-operator-nexus-network-fabric",
46+
"redirect_document_id": false
47+
},
4348
{
4449
"source_path": "howto-use-azure-policy-for-aks-cluster-security.md",
4550
"redirect_url": "howto-use-azure-policy",

‎articles/operator-nexus/concepts-commit-workflow-v2.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -38,14 +38,15 @@ Commit Workflow v2 is built around a structured change management flow. The foll
3838

3939
Before using Commit Workflow v2, ensure the following environment requirements are met:
4040

41-
## Commit Workflow Version Matrix
41+
## Commit workflow comaptible versions
4242

4343
The Commit Workflow version supported depends on the combination of Fabric runtime, portal release version, and API version in use. Use the table below to identify which Commit Workflow is applicable for your environment:
4444

4545
| **Fabric Version** | **Release Version** | **API Version(s)** | **Commit Workflow Version** |
4646
|------------------------|---------------------|------------------------------------------------------------------------------------------------------|------------------------------|
4747
| 3.0, 4.0, 5.0 | 8.1 and earlier | `2024-06-15-preview`<br>`2024-02-15-preview`<br>`2023-06-15-stable` | Commit Workflow v1 |
4848
| 5.0.0 | 8.2, 8.3 | `2024-06-15-preview`<br>`2024-02-15-preview`<br>`2023-06-15-stable` | Commit Workflow v1 |
49+
| 5.0.0 | 9.0 | `2024-06-15-preview` | Commit Workflow v1 |
4950
| 5.0.1 | 8.2, 8.3 | `2024-06-15-preview` | Commit Workflow v2 |
5051
| 6.0 and later | 9.0 and later | `2024-06-15-preview` and later | Commit Workflow v2 |
5152

@@ -125,10 +126,9 @@ Device-impacting resources (like Network-to-Network Interconnect (NNI), Isolatio
125126

126127
### Supported resource actions via Commit workflow v2 (when parent resources are in administrative state – Enabled)
127128

128-
| **Supported resource actions which require commit workflow** | ****Supported resource actions which don't require commit workflow** |** |
129+
| **Supported resource actions which require commit workflow** | **Unsupported resource actions which doesn’t require commit workflow** |
129130
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
130-
| **All resource updates impacting device configuration:**<br>• Updates to Network Fabric resource<br>• Updates to Network-to-Network Interconnect (NNI)<br>• Updates to ISD (L2 and L3)<br>• Creation and updates to Internal and External Networks of enabled L3 ISD<br>• Addition/updates/removal of Route Policy in Internal, External, ISD, and NNI resources<br>• Addition/updates/removal of IP Prefixes, IP Community, and Extended IP Community when attached to Route Policy or Fabric<br>• Addition/updates/removal of ACLs to Internal, External, ISD, and NNI resources<br>• Addition/updates/removal of Network Fabric resource in Network Monitor resource<br>• Additional description updates to Network Device properties<br>• Creation of multiple NNI | **Creation/updating of resources not impacting device configuration:**<br>• Creation of Isolation Domain (ISD) (L3 and L2)<br>• Network Fabric Controller (NFC) creation/updates<br>• Creation and updates to Network TAP rules, Network TAP, Neighbor groups<br>• Creation and updates to Network TAP rules, Network TAP, Neighbor groups<br>• Creation of new Route Policy and connected resources (IP Prefix, IP Community, IP Extended Community)<br>• Update of Route Policy and connected resources when not attached to ISD/Internal/External/NNI<br>• Creation/update of new Access Control List (ACL) which isn't attached<br><br>**ARM resources updates only:**<br>• Tag updates for all supported resources<br><br>**Other administrative actions and post actions which manage lifecycle events:**<br>• Enabling/Disabling Isolation Domain (ISD), Return Material Authorization (RMA), Upgrade, and all administrative actions (enable/disable), serial number update<br>• Deletion of all Nexus Network Fabric (NNF) resources |
131-
131+
| **All resource updates impacting device configuration:**<br>• Updates to Network Fabric resource<br>• Updates to Network-to-Network Interconnect (NNI)<br>• Updates to ISD (L2 and L3)<br>• Creation and updates to Internal and External Networks of enabled L3 ISD<br>• Addition/updates/removal of Route Policy in Internal, External, ISD, and NNI resources<br>• Addition/updates/removal of IP Prefixes, IP Community, and Extended IP Community when attached to Route Policy or Fabric<br>• Addition/updates/removal of ACLs to Internal, External, ISD, and NNI resources<br>• Addition/updates/removal of Network Fabric resource in Network Monitor resource<br>• Additional description updates to Network Device properties<br>• Creation of multiple NNI | **Creation/updating of resources not impacting device configuration:**<br>• Creation of Isolation Domain (ISD) (L3 and L2)<br>• Network Fabric Controller (NFC) creation/updates<br>• Creation and updates to Network TAP rules, Network TAP, Neighbor groups<br>• Creation and updates to Network TAP rules, Network TAP, Neighbor groups<br>• Creation of new Route Policy and connected resources (IP Prefix, IP Community, IP Extended Community)<br>• Update of Route Policy and connected resources when not attached to ISD/Internal/External/NNI<br>• Creation/update of new Access Control List (ACL) which is not attached<br><br>**ARM resources updates only:**<br>• Tag updates for all supported resources<br><br>**Other administrative actions and post actions which manage lifecycle events:**<br>• Enabling/Disabling Isolation Domain (ISD), Return Material Authorization (RMA), Upgrade, and all administrative actions (enable/disable), serial number update<br>• Deletion of all Nexus Network Fabric (NNF) resources |
132132

133133
### Allowed actions after configuration lock
134134

@@ -138,7 +138,7 @@ Here's a clear, structured table showing **Supported actions post configuration
138138

139139
### **Supported and unsupported actions post configuration lock**
140140

141-
| **Actions** | **Supported resource actions when fabric is under configuration lock** | **Unsupported resource actions when fabric is under configuration lock** |
141+
| **Actions** | **Unsupported resource actions when fabric is under configuration lock** | **Unsupported resource actions when fabric is under configuration lock** |
142142
| ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
143143
| **Resource Actions (CUD)** | - **NFC** (Only *Update*)<br>- **Network TAP rules**, **Network TAP**, **Neighbor Group** *(Create, Update, Delete)* <br>- **ACL** *(Create/Update)* when **not attached** to parent resource<br>- **Network Monitor** created **without Fabric ID**<br>- **Creation/Update** of **IPPrefix**, **IPCommunity List**, **IPExtendedCommunity** when **not attached** to Route Policy<br>- **Read** of all NNF resources<br>- **Delete** of **disabled** resources and **not attached** to any parent resources | - No CUD operations allowed on:<br>  • **Network-to-Network Interconnect (NNI)**<br>  • **Isolation Domains (L2 & L3)**<br>  • **Internal/External Networks** (Additions/Updates)<br>  • **Route Policy**, **IPPrefix**, **IPCommunity List**, **IPExtendedCommunity**<br>  • **ACLs** when **attached to parent resources** (for example, NNI, External Network)<br>  • **Network Monitor** when **attached to Fabric**<br>  • **Deletion** of all **enabled** resources |
144144
| **Post Actions** | - **Lock Fabric** (administrative state)<br>- **View Device Configuration**<br>- **Commit Configuration**<br>- **ARMConfig Diff** <br>- **Commit batch status** | - All other post actions are **blocked** and must be done **prior to enabling configuration lock** |

‎articles/operator-nexus/howto-replace-network-devices.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ Device replacement may be required in the following situations:
3838
- Interface Speed Validation
3939

4040
- Confirm that the ma1 interface speed is set to 100 Mbps or higher.
41-
41+
4242
- If the speed is below 100 Mbps, update it accordingly to prevent delays or potential timeouts during the RMA process.
4343

4444
- Device Storage Check
@@ -49,16 +49,7 @@ Device replacement may be required in the following situations:
4949

5050
## Steps to replace a device
5151

52-
1. Shutdown and remove the device from service (If reachable).
53-
54-
If the original device is still reachable and connected to the Network Fabric:
55-
56-
Manually power it down and remove it from service.
57-
58-
> [!Important]
59-
> This step is manual and applicable only if the device is responsive.
60-
61-
2. Disable administrative state.
52+
1. Disable administrative state.
6253

6354
Use the following command to disable the administrative state of the device:
6455

@@ -81,7 +72,7 @@ This action:
8172

8273
- Fabric upgrades
8374

84-
3. Update the serial number.
75+
2. Update the serial number.
8576

8677
Once the replacement device is physically installed, update its serial number in the fabric resource:
8778

@@ -92,14 +83,14 @@ az networkfabric device update \
9283
--resource-group "resource-group-name"
9384
```
9485

95-
4. Ensure device is in ZTP Mode.
86+
3. Ensure device is in ZTP Mode.
9687

9788
Verify that the replacement device is in ZTP mode. If not, configure the device for ZTP before continuing.
9889

9990
> [!Note]
10091
> ZTP enables automatic configuration retrieval during the RMA process.
10192
102-
5. Set RMA State.
93+
4. Set RMA State.
10394

10495
Initiate the RMA process using the following command:
10596

@@ -116,6 +107,16 @@ This will:
116107

117108
- Retry the operation if there is transient failures until success is confirmed.
118109

110+
5. Refresh configuration
111+
112+
This step pushes the latest configuration to the device after it enters maintenance mode (applicable only for CE and TOR).
113+
114+
```Azure CLI
115+
az networkfabric device refresh-configuration --resource-name <resource-name> --resource-group <rg-name>
116+
```
117+
118+
This will push the latest config to the device.
119+
119120
6. Enable administrative state.
120121

121122
Once configuration is applied successfully, bring the device back into active service:
@@ -129,7 +130,6 @@ az networkfabric device update-admin-state \
129130

130131
This will:
131132

132-
- Performs a partial reconcile of the device state.
133133
- Sets device state to Enabled once it's fully healthy and synchronized with the fabric.
134134

135135
## Summary

0 commit comments

Comments
 (0)