Skip to content

Commit 8d2d954

Browse files
committed
Update howto-replace-network-devices.md
1 parent 28076bc commit 8d2d954

File tree

1 file changed

+24
-21
lines changed

1 file changed

+24
-21
lines changed

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

Lines changed: 24 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ To ensure a smooth and timely RMA process, verify the following prerequisites be
5151

5252
- This action is required to successfully download and stage the necessary image files.
5353

54-
## Device Types Supported
54+
## Device types supported
5555

5656
- Customer Edge (CE)
5757
- Top of Rack (TOR)
@@ -60,7 +60,7 @@ To ensure a smooth and timely RMA process, verify the following prerequisites be
6060

6161
## Steps to replace a device
6262

63-
1. Disable administrative state.
63+
### Step 1 : Disable administrative state.
6464

6565
Use the following command to disable the administrative state of the device:
6666

@@ -73,18 +73,23 @@ az networkfabric device update-admin-state \
7373

7474
This action sets the following states:
7575

76-
- Device Administrative State: Disabled
76+
- Device Administrative State: Disabled
7777

78-
- Fabric Administrative State: EnabledDegraded
78+
- Fabric Administrative State: EnabledDegraded
7979

8080
> Note:
81-
> This action is not permitted by the service, if any of the following operations are in progress at the fabric level:<br> - Device upgrade<br> - Configuration push<br> - Secret or certificate updates<br>Administrative lock<br> - Terminal Server (TS) reprovisioning.
81+
> This action is not permitted by the service, if any of the following operations are in progress at the fabric level:
82+
> - Device upgrade
83+
> - Configuration push
84+
> - Secret or certificate updates
85+
> - Administrative lock
86+
> - Terminal Server (TS) reprovisioning.
8287
83-
2. Update the serial number.
88+
### Step 2 : Update the serial number.
8489

8590
Execution Conditions:
86-
- Device Administrative State must be `Disabled`
87-
- Fabric Administrative State must be `EnabledDegraded`
91+
- Device Administrative State must be `Disabled`
92+
- Fabric Administrative State must be `EnabledDegraded`
8893

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

@@ -97,17 +102,17 @@ az networkfabric device update \
97102

98103
Error Recovery Guidance:
99104

100-
- If RMA fails due to an incorrect serial number, repatching is allowed without a support ticket.
105+
- If RMA fails due to an incorrect serial number, repatching is allowed without a support ticket.
101106

102-
- If validation fails after device bootstrap, the system returns the status: Device Unable to Boot Up - Failed.
107+
- If validation fails after device bootstrap, the system returns the status: Device Unable to Boot Up - Failed.
103108

104109
This action performs the following tasks:
105110

106-
- Update serial number stored in Azure ARM resource
111+
- Update serial number stored in Azure ARM resource
107112

108-
- Keeps the device in Disabled state
113+
- Keeps the device in Disabled state
109114

110-
3. Ensure device is in ZTP Mode.
115+
### Step 3 : Ensure device is in ZTP Mode.
111116

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

@@ -116,13 +121,13 @@ Verify that the replacement device is in ZTP mode. If not, configure the device
116121
117122
This action sets the following states:
118123

119-
- Device Administrative State: UnderMaintenance
124+
- Device Administrative State: UnderMaintenance
120125

121-
- Fabric Administrative State: EnabledDegraded
126+
- Fabric Administrative State: EnabledDegraded
122127

123128
The device boots into its base configuration using the maintenance profile. This condition applies only to TOR and CE device types.
124129

125-
4. Set RMA State.
130+
### Step 4 : Set RMA State.
126131

127132
Initiate the RMA process using the following command:
128133

@@ -139,7 +144,7 @@ This will:
139144

140145
- Retry the operation if there's transient failures until success is confirmed.
141146

142-
5. Refresh configuration
147+
### Step 5 : Refresh configuration
143148

144149
This step pushes the latest configuration to the device after it enters maintenance mode (applicable only for CE and TOR).
145150

@@ -149,7 +154,7 @@ az networkfabric device refresh-configuration --resource-name <resource-name> --
149154

150155
This action pushes the latest configuration to the device.
151156

152-
6. Enable administrative state.
157+
### Step 6 : Enable administrative state.
153158

154159
Once configuration is applied successfully, bring the device back into active service:
155160

@@ -160,9 +165,7 @@ az networkfabric device update-admin-state \
160165
--resource-group "resource-group-name"
161166
```
162167

163-
This will:
164-
165-
- Sets device state to Enabled once it's fully healthy and synchronized with the fabric.
168+
This action sets device state to Enabled once it's fully healthy and synchronized with the fabric.
166169

167170
## Summary
168171

0 commit comments

Comments
 (0)