Skip to content

Commit 66dcaab

Browse files
committed
Update howto-replace-network-devices.md
1 parent 738983b commit 66dcaab

File tree

1 file changed

+32
-20
lines changed

1 file changed

+32
-20
lines changed

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

Lines changed: 32 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -38,8 +38,11 @@ To ensure a smooth and timely RMA process, verify the following prerequisites be
3838

3939
- Replacement device supports Zero Touch Provisioning (ZTP)
4040

41+
- To prevent failure during the device disable action if the device is affected by continuous reboots due to hardware issues, it is advised to power off the device prior to initiating the RMA process.
42+
4143
- Before initiating the RMA deployment, perform the following checks:
4244

45+
4346
- Interface Speed Validation
4447

4548
- Confirm that the ma1 interface speed is set to 100 Mbps or higher.
@@ -60,7 +63,7 @@ To ensure a smooth and timely RMA process, verify the following prerequisites be
6063

6164
## Steps to replace a device
6265

63-
### Step 1: Disable administrative state.
66+
### Step 1: Disable administrative state
6467

6568
Use the following command to disable the administrative state of the device:
6669

@@ -85,9 +88,9 @@ This action sets the following states:
8588
> - Administrative lock
8689
> - Terminal Server (TS) reprovisioning.
8790
88-
### Step 2: Update the serial number.
91+
### Step 2: Update the serial number
8992

90-
Execution Conditions:
93+
Execution conditions:
9194
- Device Administrative State must be `Disabled`
9295
- Fabric Administrative State must be `EnabledDegraded`
9396

@@ -100,7 +103,7 @@ az networkfabric device update \
100103
--resource-group "resource-group-name"
101104
```
102105

103-
Error Recovery Guidance:
106+
Error recovery guidance:
104107

105108
- If RMA fails due to an incorrect serial number, repatching is allowed without a support ticket.
106109

@@ -110,24 +113,16 @@ This action performs the following tasks:
110113

111114
- Update serial number stored in Azure ARM resource
112115

113-
- Keeps the device in Disabled state
116+
- Keeps the device in `Disabled` state and Fabric Administrative State in `EnabledDegraded`
114117

115-
### Step 3: Ensure device is in ZTP Mode.
118+
### Step 3: Ensure device is in ZTP Mode
116119

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

119122
> [!Note]
120123
> ZTP enables automatic configuration retrieval during the RMA process.
121124
122-
This action sets the following states:
123-
124-
- Device Administrative State: UnderMaintenance
125-
126-
- Fabric Administrative State: EnabledDegraded
127-
128-
The device boots into its base configuration using the maintenance profile. This condition applies only to TOR and CE device types.
129-
130-
### Step 4: Set RMA State.
125+
### Step 4: Initaite RMA process
131126

132127
Initiate the RMA process using the following command:
133128

@@ -138,11 +133,15 @@ az networkfabric device update-admin-state \
138133
--resource-group "resource-group-name"
139134
```
140135

141-
This will:
136+
- Network Fabric Controller pushes all required configuration files to the new replaced device. It is advised to retry the operation if there's transient failures until success is confirmed.
137+
138+
- The device boots into its base configuration using the maintenance profile. This condition applies only to TOR and CE device types.
139+
140+
This action sets the following states:
142141

143-
- Trigger the Network Fabric Controller to push all required configuration files to the replacement device.
142+
- Device Administrative State: UnderMaintenance
144143

145-
- Retry the operation if there's transient failures until success is confirmed.
144+
- Fabric Administrative State: EnabledDegraded
146145

147146
### Step 5: Refresh configuration
148147

@@ -152,7 +151,13 @@ This step pushes the latest configuration to the device after it enters maintena
152151
az networkfabric device refresh-configuration --resource-name <resource-name> --resource-group <rg-name>
153152
```
154153

155-
This action pushes the latest configuration to the device.
154+
This action pushes the latest configuration to the device.
155+
156+
This action keeps the device in following states:
157+
158+
- Device Administrative State: UnderMaintenance
159+
160+
- Fabric Administrative State: EnabledDegraded
156161

157162
### Step 6: Enable administrative state.
158163

@@ -165,7 +170,14 @@ az networkfabric device update-admin-state \
165170
--resource-group "resource-group-name"
166171
```
167172

168-
This action sets device state to Enabled once it's fully healthy and synchronized with the fabric.
173+
This action sets the following state once it's fully healthy and synchronized with the fabric:
174+
175+
- Device Administrative State: `Enabled`
176+
177+
- Fabric Administrative State: `Enabled`
178+
179+
>[!Note]
180+
> In a given fabric if there are any other device is in Disabled state then the Fabric Administrative State will maintained as : `EnabledDegraded`
169181
170182
## Summary
171183

0 commit comments

Comments
 (0)