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

PDF

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

Migrate from an OSPF IPN underlay to a BGP IPN underlay

Updated: April 17, 2026

Want to summarize with AI?

Log in

Configure migration from an OSPF IPN underlay to a BGP IPN underlay by adding a BGP interface to the Logical Interface Profile and removing the OSPF interface.

This task enables you to migrate the IPN underlay protocol from OSPF to BGP in Cisco APIC Release 5.2(3) and later releases.

Beginning with Cisco APIC Release 5.2(3), the IPN underlay protocol can be either OSPF or BGP. To migrate a pod from using an OSPF underlay to a BGP underlay, add a BGP interface to the Logical Interface Profile under the existing IPN-connected L3Out. When that interface is successfully connected to a running BGP peer, you can delete the OSPF Interface Profile.

Note

When both OSPF and BGP are used in the underlay for multi-pod, multi-site, or remote leaf, do not redistribute router-ids into BGP from OSPF on IPN routers. Doing so may cause a routing loop and bring down OSPF and BGP sessions between the spine switch and IPN routers.

Note
Migrating the underlay protocol is a disruptive action and should be done only during a maintenance window.

Procedure

  1. From the APIC menu bar, navigate to Tenants > infra > Networking > L3Outs > your IPN L3Out, where your IPN L3Out is the L3Out that connects to the IPN.

  2. In the Navigation pane, expand your IPN L3Out and navigate to Logical Node Profiles > your IPN node profile > Logical Interface Profiles > your IPN interface, where your IPN interface is the Logical Interface Profile for the current IPN connection.

    The Logical Interface Profile table appears in the work pane.

  3. In the work pane, click the Policy tab and the Routed Sub-Interfaces tab below the Policy tab.

  4. In the Routed Sub-Interfaces table, double-click the interface of the current IPN connection.

    The Routed Sub-Interface dialog box opens.

  5. In the Routed Sub-Interface dialog box, perform these actions:

    1. Click the + icon in the BGP Peer Connectivity Profiles bar to add a BGP peer connection.

      The Create Peer Connectivity Profiles dialog box opens.

    2. In the Peer IPv4 Address field, enter the IP address of the BGP peer.
    3. Configure any other desired settings for the BGP peer connection.
      Note
      If you are configuring for migration but not actually migrating at this time, you can set the Admin State to Disabled for now and return to this step when you are ready to migrate. Migration should be done during a maintenance window.
    4. Click Submit to return to the Routed Sub-Interface dialog box.

  6. In the Routed Sub-Interface dialog box, click Submit.

  7. In the Navigation pane, navigate to Logical Node Profiles > your IPN node profile > Configured Nodes > your IPN node. Verify that the BGP neighbor is UP:

    1. Expand your IPN node and locate the BGP entry, such as BGP for VRF-overlay-1.
    2. Expand the BGP entry and click Neighbors.
    3. In the Neighbors table, find the peer IP address that you configured in Peer IPv4 Address, and verify that the State is "established."

  8. In the Navigation pane, under Logical Interface Profiles, right-click the current OSPF Interface Profile and select Delete.

    Note
    Before deleting the OSPF Interface Profile, make sure that the BGP neighbor is UP.

  9. In the Navigation pane, navigate to Tenants > infra > Networking > L3Outs > your IPN L3Out.

  10. In the work pane, click the Policy tab and the Main tab below the Policy tab.

  11. In the work pane, in the Enable BGP/EIGRP/OSPF section, uncheck OSPF, leaving BGP checked.

  12. Click Submit.

The IPN underlay protocol has been successfully migrated from OSPF to BGP. The BGP neighbor connection is established and the OSPF interface profile has been removed.