To replace a Cisco ACI leaf switch, follow these step-by-step instructions to ensure a smooth transition without disrupting your fabric:
🛠️ Preparation
- Document the existing switch details:
- POD ID
- Node ID
- Node Name
- Serial Number
- Ensure the replacement switch is in ACI
mode:
- Connect via console and run show
version.
- If in NX-OS mode, convert to ACI mode using Cisco's documented procedure
- Before adding the new leaf switch to the fabric, ensure it's manually upgraded to the target image or one with a direct upgrade path. Avoid using intermediate images that require multiple upgrade steps, as they can trigger issues and impact your production environment. A final upgrade via policy helps ensure BIOS and FPGA components are properly updated.
- Clean up the replacement switch:
- Run setup-clean-config.sh and then reload to remove any existing configuration
🔄 Decommission the Faulty Leaf Switch
- Go to APIC GUI:
Fabric > Inventory > Fabric Membership - Right-click the faulty switch → Select Decommission.
- Once decommissioned, Remove from Controller and confirm the action
- Physically disconnect and unmount the old switch.
🔌 Install and Connect the New Leaf Switch
- Mount the new switch and connect uplinks to spine switches. DONOT CONNECT DOWNLINK AT THIS STAGE
- Power on the switch.
- In APIC GUI, go to:
Fabric > Inventory > Fabric Membership > Nodes Pending Registration - Verify serial number, then Register the
switch:
- Use the same POD ID, Node ID, and
Node Name as the old switch
- Once registered, go to:
Fabric > Inventory > Fabric Membership > Registered Nodes
→ Right-click → Select Commission. - Wait for the switch to reach Active state.
🔍 Post-Replacement Validation
- Connect downlink cables (after
switch is active).
- Go to:
Fabric > Inventory > Topology
→ Verify the switch is visible and operational. - SSH into APIC and run:
→ Confirm switch status is active
- If you get SSH warnings (e.g., DNS
spoofing), update the known_hosts file:
🧩 Troubleshooting Tips
- Switch not discovered: Check LLDP neighbors and cable
connections.
- Switch shows "Not Supported": Upgrade APIC firmware to match switch
model.
- No TEP IP assigned: May be a DHCP issue—contact Cisco TAC.
- SSL issues: Check for established sessions on port 12215
No comments:
Post a Comment