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
-
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
-
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.
-
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
This tool logs the output of the console to the efa-sync-console.log
file.