Overview
After reviewing this article readers should expect to know how to configure link aggregation on the UniFi Switch devices. This article also includes considerations that should be taken into thought when configuring a link aggregation group.
 |
NOTES & REQUIREMENTS: Applicable to all UniFi Switch models excluding the USW-Flex.
|
Table of Contents
- Introduction
- Network Diagram
- Steps: How to Configure Link Aggregation Groups
- Verification
- Related Articles
Introduction
Configuring the UniFi switches with a link aggregation group (LAG) allows a UniFi Administrator to be able to expand the maximum throughput on a network path.
Link Aggregation Control Protocol (LACP)
LACP is a dynamically negotiated protocol that ensures that the LAG configuration is compatible and viable on each endpoint. LACP also provides the ability for the load balancing to failover in the event that one of the bundled links were to fail.
Network Diagram
Steps: How to Configure Link Aggregation Groups
- Navigate to the switches that will participate in the link aggregation group.
- Select Profile Overrides.
- Under the Aggregate Ports section select which ports to include in the LAG.
 |
ATTENTION:
|
Key Considerations
Limitations
- Up to six ports may be configured in the LAG. These ports must be sequential in number.
- Up to six individual LAGs can be configured.
- Static LAG configurations are not supported. LACP (802.3ad) only.
- No Multi-chassis Link Aggregation Group (MLAG).
Spanning Tree Protocol (STP)
When defining a LAG it is important to understand that the STP port cost is divided by however many active links are participating in the LAG.
Example:
| Number of Ports | LAG STP Port Cost |
| 4x 1Gbps ports (20,000 original port cost) | 5,000 |
| 2x 10Gbps ports (2,000 original port cost) | 1,000 |
A LAG may alter the best path based on the port cost to the root bridge. Be certain that an administratively-defined root bridge is selected.
Order of Operations
When enabling link aggregation between UniFi switches it is important to retain access to the controller for provisioning to take place. When enabling the LAG on the devices be certain that configuration changes are first done on the downstream switch, and then on the upstream switch.
 |
NOTE: The terms "upstream" and "downstream" are used relationally in accordance with the path to the controller host.
|
LACP Algorithm
- Hashing based on Source/Destination MAC, VLAN, EtherType, and incoming port associated with the packet
Throughput
Throughput testing with one host to another single host will not show improvements. The hashing algorithm that is used for LACP does not split data streams on single host-to-host connections. To see improvements in throughput multiple hosts would have to be passing traffic at the same time.
Verification
 |
CLI: Access the command line interface (CLI). You can do this using the debug terminal in the GUI or by using a program such as PuTTY.
|
- View counters on LAG:
show interface lag #
- View LACP partners on all ports:
show lacp partner all
Related Articles
UniFi - USW: Configuring Spanning Tree Protocol