Teaming

Onload User Guide (UG1586)

Document ID
UG1586
Release Date
2023-07-31
Revision
1.2 English

In addition to traditional Linux bonding, Onload also supports link aggregation using the Linux teaming driver that is introduced in RHEL 7, SLES 12, and other recent distributions. There are various methods to configure teaming. The example below demonstrates the use of the NetworkManager CLI which creates the ifcfg files in the /etc/sysconfig/network-scripts directory. Using nmcli, teams persist across server reboots.

  1. Create the team:
    # nmcli connection add type team ifname teamA
    Connection 'team-teamA' (b7c39a10-84ac-4840-85f2-66adb5e71183) successfully added.
  2. List the created team:
    # nmcli con show
    NAME        UUID                                  TYPE            DEVICE
    eno2        4efeb125-d489-4a06-9d8a-407bf03fcc77  802-3-ethernet  --
    eno1        f270807d-9904-452e-bbd2-0d6b48840c80  802-3-ethernet  eno1
    enp1s0f1    16192f4d-7a97-4154-924b-02ca905c8cd7  802-3-ethernet  --
    team-teamA  b7c39a10-84ac-4840-85f2-66adb5e71183  team            teamA
    virbr0      ceb1a683-7db9-4721-8ca9-38a577ff5d77  bridge          virbr0
    enp1s0f0    cbc92b25-9855-451c-8c6b-186b6d5db9f6  802-3-ethernet  --
  3. View default settings for the newly created team:
    # cat /etc/sysconfig/network-scripts/ifcfg-team-teamA
    DEVICE=teamA
    DEVICETYPE=Team
    BOOTPROTO=dhcp
    DEFROUTE=yes
    PEERDNS=yes
    PEERROUTES=yes
    IPV4_FAILURE_FATAL=no
    IPV6INIT=yes
    IPV6_AUTOCONF=yes
    IPV6_DEFROUTE=yes
    IPV6_PEERDNS=yes
    IPV6_PEERROUTES=yes
    IPV6_FAILURE_FATAL=no
    NAME=team-teamA
    UUID=b7c39a10-84ac-4840-85f2-66adb5e71183
    ONBOOT=yes
  4. Add primary interface to the team:
    # nmcli con add type team-slave con-name teamA-port1 ifname enp1s0f0 master teamA
    Connection 'teamA-port1' (015f09d7-3f2a-4578-aaea-7ff89a2769f7) successfully added.
  5. Add a second interface to the team:
    # nmcli con add type team-slave con-name teamA-port2 ifname enp1s0f1 master teamA
    Connection 'teamA-port2' (92dfe561-860a-4906-842d-b7ebdf263dbe) successfully added.
  6. Bring up the team ports:
    # nmcli connection up teamA-port1
    Connection successfully activated (D-Bus active path: /org/freedesktop/NetworkManager/ActiveConnection/6)

    Repeat command for other team ports.

  7. Assign team IP addresses via ifcfg files or command line as required.
Note: Teams created with the teamd daemon are non-persistent. Teams created with nmcli are persistent across server reboots.

To disable Onload acceleration of teaming, please contact support-nic@amd.com.