Cisco APIC Layer 3 Networking Configuration Guide, Release 6.2(x)

PDF

Cisco APIC Layer 3 Networking Configuration Guide, Release 6.2(x)

Move an APIC from one pod to another pod

Updated: April 17, 2026

Want to summarize with AI?

Log in

Configure the movement of an APIC from one pod to another pod in a multi-pod setup by decommissioning, physically moving, and recommissioning the controller.

This task enables you to relocate an APIC controller between pods in a multi-pod environment while maintaining cluster integrity and operational functionality.

Use this procedure to move an APIC from one pod to another pod in an multi-pod setup.

Procedure

  1. Decommission the APIC in the cluster.

    1. On the menu bar, choose SYSTEM > Controllers.
    2. In the Navigation pane, expand Controllers > apic_controller_name > Cluster as Seen by Node.
    3. In the Navigation pane, click an apic_controller_name that is within the cluster and not the controller that is being decommissioned.
    4. In the Work pane, verify that the Health State in the Active Controllers summary table indicates the cluster is Fully Fit before continuing.
    5. In the Work pane, click Actions > Decommission.
    6. Click Yes.
      The decommissioned controller displays Unregistered in the Operational State column. The controller is then taken out of service and no longer visible in the Work pane.

  2. Move the decommissioned APIC to the desired pod.

  3. Enter the following commands to reboot the APIC.

    
apic1# acidiag touch setup
apic1# acidiag reboot

  4. In the APIC setup script, specify the pod ID where the APIC node has been moved.

    1. Log in to Cisco Integrated Management Controller (CIMC).
    2. In the pod ID prompt, enter the pod ID.
    Note

    Do not modify the TEP Pool address information.

  5. Recommission the APIC.

    1. From the menu bar, choose SYSTEM > Controllers.
    2. In the Navigation pane, expand Controllers > apic_controller_name > Cluster as Seen by Node.
    3. From the Work pane, verify in the Active Controllers summary table that the cluster Health State is Fully Fit before continuing.
    4. From the Work pane, click the decommissioned controller that displaying Unregistered in the Operational State column.
    5. From the Work pane, click Actions > Commission.
    6. In the Confirmation dialog box, click Yes.
    7. Verify that the commissioned Cisco APIC controller is in the operational state and the health state is Fully Fit.

The APIC controller is successfully moved to the new pod and operational within the Multi-Pod cluster with a health state of Fully Fit.