Replace a Faulty Device

You can use the EFA command line to replace a faulty device with a new device and maintain the configuration of the old device.

Before you begin

  • Ensure that periodic configuration backup is enabled on all devices that may need RMA. This prerequisite ensures that you have the latest configuration file to be used for recovery.
  • Ensure that maintenance mode is enabled upon reboot on all devices.

About this task

This procedure describes how to replace a faulty device as part of the Return Material Authorization (RMA) process. For more information, see Return Material Authorization.


  1. Obtain the configuration backup of the old device.
    For more information, see Configure Backup and Replay.
    # efa inventory config-backup execute --ip <ip-addr>
    This step generates a configuration backup ID that you use in step 5.
  2. Replace the faulty device with the new device.
  3. Ensure that the ports of the new device are administratively up and online.
    The ports on the new device must have the same connections as the old device. For example, if the old device Ethernet port1 and port2 went to port3 and port4 of another device, the new replacement device must have these exact same Ethernet port connections.
  4. Configure the new device with the same management IP address and credentials as the old device.
  5. Start the RMA process.
    # efa inventory rma execute --ip <ip-addr> --config-backup-id <id>


    As a best practice, run the command with the --config-backup-id <id> option so that the configuration is properly restored. If you run the command without the backup ID, you must manually update the configuration on the new device.
  6. View the RMA history and detail.
    # efa inventory rma history -–ip <ip-addr>
    # efa inventory rma detail –uuid <uuid>
  7. View the drift reconcile history and detail.
    # efa inventory drift-reconcile history -–device-ip <ip-addr>
    # efa inventory drift-reconcile detail –-uuid <uuid>
  8. Install the HTTPS or OAuth2 certificate on the new device.
    # efa certificates device install --ips <device-ip-addr> --certType [https|token]
  9. Optional: Delete the RMA record.
    # efa inventory rma delete -–ip <ip-addr>
  10. Optional: Manually start the drift reconcile process if the RMA process fails during the drift reconcile stage.
    # efa inventory drift-reconcile execute --ip <ip-addr> –-reconcile