1 # VPP Link Aggregation Control Protocol (LACP) implementation {#lacp_doc}
3 This document is to describe the usage of VPP LACP implementation.
8 The Link Aggregation Control Protocol (LACP) is an 802.3ad standard which
9 provides a protocol for exchanging information between Partner Systems on a
10 link to allow their protocol instances to reach agreement on the Link Aggregation
11 Group to which the link belongs and enable transmission and reception for the
12 higher layer. Multiple links may be bundled to the same Aggregation Group to form
13 a high bandwidth transmission medium and create a fault-tolerant link.
18 1. Create the bond interface
19 create bond mode lacp [hw-addr <mac-address>] [load-balance { l2 | l23 | l34 }]
21 2. Enslave the physical interface to the bond
22 enslave interface <interface> to <bond-interface-name> [passive] [long-timeout]"
24 3. Delete the bond interface
25 delete bond {<interface> | sw_if_index <sw_idx>}
27 4. Detach the slave interface from the bond
28 detach interface <interface>
30 ### Configuration example
33 set interface state BondEthernet0 up
34 enslave interface TenGigabitEthernet7/0/0 to BondEthernet1
35 enslave interface TenGigabitEthernet7/0/1 to BondEthernet1
36 enslave interface TenGigabitEthernet5/0/0 to BondEthernet1
37 enslave interface TenGigabitEthernet5/0/1 to BondEthernet1
39 detach interface TenGigabitEthernet5/0/1
41 delete bond BondEthernet0
45 show lacp [<interface>] [details]
54 actor state partner state
55 interface name sw_if_index bond interface exp/def/dis/col/syn/agg/tim/act exp/def/dis/col/syn/agg/tim/act
56 GigabitEthernet2/0/1 1 BondEthernet0 0 0 1 1 1 1 1 1 0 0 1 1 1 1 1 1
57 LAG ID: [(ffff,e4-c7-22-f3-26-71,0000,00ff,0001), (ffff,fc-99-47-4a-0c-8b,0009,00ff,0001)]
58 RX-state: CURRENT, TX-state: TRANSMIT, MUX-state: COLLECTING_DISTRIBUTING, PTX-state: PERIODIC_TX
59 TenGigabitEthernet4/0/0 2 BondEthernet1 0 0 1 1 1 1 1 1 0 0 1 1 1 1 0 1
60 LAG ID: [(ffff,90-e2-ba-76-cf-2d,0001,00ff,0001), (8000,00-2a-6a-e5-50-c1,0140,8000,011d)]
61 RX-state: CURRENT, TX-state: TRANSMIT, MUX-state: COLLECTING_DISTRIBUTING, PTX-state: PERIODIC_TX
62 TenGigabitEthernet4/0/1 3 BondEthernet1 0 0 1 1 1 1 1 1 0 0 1 1 1 1 0 1
63 LAG ID: [(ffff,90-e2-ba-76-cf-2d,0001,00ff,0002), (8000,00-2a-6a-e5-50-c1,0140,8000,011e)]
64 RX-state: CURRENT, TX-state: TRANSMIT, MUX-state: COLLECTING_DISTRIBUTING, PTX-state: PERIODIC_TX
65 TenGigabitEthernet8/0/1 7 BondEthernet1 0 0 1 1 1 1 1 1 0 0 1 1 1 1 0 1
66 LAG ID: [(ffff,90-e2-ba-76-cf-2d,0001,00ff,0003), (8000,00-2a-6a-e5-50-01,007a,8000,0114)]
67 RX-state: CURRENT, TX-state: TRANSMIT, MUX-state: COLLECTING_DISTRIBUTING, PTX-state: PERIODIC_TX
68 TenGigabitEthernet8/0/0 6 BondEthernet1 0 0 1 1 1 1 1 1 0 0 1 1 1 1 0 1
69 LAG ID: [(ffff,90-e2-ba-76-cf-2d,0001,00ff,0004), (8000,00-2a-6a-e5-50-01,007a,8000,0115)]
70 RX-state: CURRENT, TX-state: TRANSMIT, MUX-state: COLLECTING_DISTRIBUTING, PTX-state: PERIODIC_TX
71 TenGigabitEthernet6/0/1 5 BondEthernet2 0 0 1 1 1 1 1 1 0 0 1 1 1 1 1 1
72 LAG ID: [(ffff,90-e2-ba-36-31-21,0002,00ff,0001), (ffff,90-e2-ba-29-f5-31,000f,00ff,0002)]
73 RX-state: CURRENT, TX-state: TRANSMIT, MUX-state: COLLECTING_DISTRIBUTING, PTX-state: PERIODIC_TX
74 TenGigabitEthernet6/0/0 4 BondEthernet2 0 0 1 1 1 1 1 1 0 0 1 1 1 1 1 1
75 LAG ID: [(ffff,90-e2-ba-36-31-21,0002,00ff,0002), (ffff,90-e2-ba-29-f5-31,000f,00ff,0001)]
76 RX-state: CURRENT, TX-state: TRANSMIT, MUX-state: COLLECTING_DISTRIBUTING, PTX-state: PERIODIC_TX
84 interface name sw_if_index mode load balance active slaves slaves
85 BondEthernet0 10 lacp l2 1 1
86 BondEthernet1 11 lacp l34 4 4
87 BondEthernet2 12 lacp l23 2 2
92 debug lacp [<interface>] <on | off>