Sync EFA with Neutron

The OpenStack integration enables you to sync all entries from Neutron to EFA.

About this task

When EFA goes out of sync with Neutron configuration, run efa-sync to sync all entries from Neutron to EFA. For example, if there is a network and associated ports that are present on Neutron but are not present on EFA, running efa-sync creates the entities on EFA. Similarly, if there are stale entries on EFA, they are cleaned up.

You can display summary or detailed information about entities that are out of sync between Neutron and EFA configurations.

Procedure

  1. Sync EFA with Neutron.
    $ efa-sync execute
    Starting Sync
     Syncing Networks..
        Add Network to EFA Id: 1fb97c4a-1a61-4fe4-8ddf-d832f4d37e1e (Succeeded)
     Syncing Subnets..
        Add Subnet to EFA Id: 318ccc16-97ee-4e82-910f-4eee858f25d7 (Succeeded)
     Syncing Ports..
        Add Port to EFA Id: 1fb97c4a-1a61-4fe4-8ddf-d832f4d37e1e-10.20.54.68-port-channel-lag_ext1 (Succeeded)
     Syncing Routers..
        Add Router to EFA Id: e31dec93-10b2-4f75-bdae-da8a0a882475 (Succeeded)
     Syncing Router Ports..
        Add Router Port to EFA SubnetId 318ccc16-97ee-4e82-910f-4eee858f25d7 RouterId e31dec93-10b2-4f75-bdae-da8a0a882475 (Succeeded)
     Summary:
        Neutron Networks added to EFA : 1
        Neutron Networks deleted from EFA : 0
        Neutron Ports added to EFA : 1
        Neutron Ports deleted from EFA : 0
        Neutron Subnets to be added to EFA : 1
        Neutron Subnets to be deleted from EFA : 0
        Neutron Routers to be added to EFA : 1
        Neutron Routers to be deleted from EFA : 0
        Neutron Router Ports to be added to EFA : 1
        Neutron Router Ports to be deleted from EFA : 0
        Neutron Router Routes to be added to EFA : 0
        Neutron Router Routes to be deleted from EFA : 0
        Total # of resources resynced : 5
        Total # of resources failed resync : 0
     Clearing failed journal entries...
        Number of rows cleared from journal: 0
    Completed Sync 
  2. Display summary information about entities that are out of sync between Neutron and EFA configurations.
    $ efa-sync check-summary 
    05-November-2020 11:04:15 : Starting Check 
    Summary:         
           Neutron Networks to be added to EFA :  1         
           Neutron Networks to be deleted from EFA : 0         
           Neutron Ports to be added to EFA : 2         
           Neutron Ports to be deleted from EFA : 0         
           Total # of resources to be resynced : 3 
    05-November-2020 11:04:16 : Completed Check

    Journal entries that are in a failed state are cleared from the journal list if efa-sync is successful. If the efa-sync run fails (complete failure or partial failure), the failed journal entries are not cleared.

  3. Display summary or detailed information about those entities that are out of sync between Neutron and EFA configurations.
    $ efa-sync check-summary
    05-November-2020 11:04:15 : Starting Check
    Summary:
            Neutron Networks to be added to EFA :  1
            Neutron Networks to be deleted from EFA : 0
            Neutron Ports to be added to EFA : 2
            Neutron Ports to be deleted from EFA : 0
            Total # of resources to be resynced : 3
    05-November-2020 11:04:16 : Completed Check
    
    
    $ efa-sync check-detail
    05-November-2020 11:04:22 : Starting Check
            Neutron Networks to be added to EFA :
                     Id: 9e63bc57-568f-488e-9214-21db3fd3cd12
            Neutron Ports to be added from EFA :
                     Id: 9e63bc57-568f-488e-9214-21db3fd3cd12-10.25.225.11-port-channel-lag_1
                     Id: 9e63bc57-568f-488e-9214-21db3fd3cd12-10.25.225.46-port-channel-lag_1
    05-November-2020 11:04:22 : Completed Check
    
    Note

    Note

    This tool logs the output of the console to the efa-sync-console.log file.