7.3. Network Bonding Using the NetworkManager Command Line Tool, nmcli
See Section 3.3, “Configuring IP Networking with nmcli” for an introduction to nmcli.
To create a
bondconnection with the nmcli tool, issue the following command:
nmcli con add type bond ifname mybond0Connection 'bond-mybond0' (5f739690-47e8-444b-9620-1895316a28ba) successfully added.
Note that as no
con-namewas given for the bond, the connection name was derived from the interface name by prepending the type.
NetworkManager supports most of the bonding options provided by the kernel. For example:
nmcli con add type bond ifname mybond0 bond.options "mode=balance-rr,miimon=100"Connection 'bond-mybond0' (5f739690-47e8-444b-9620-1895316a28ba) successfully added.
To add a port interface:
- Create a new connection, see Section 3.3.5, “Creating and Modifying a Connection Profile with nmcli” for details.
- Set the controller property to the
bondinterface name, or to the name of the controller connection:
nmcli con add type ethernet ifname ens3 master mybond0Connection 'bond-slave-ens3' (220f99c6-ee0a-42a1-820e-454cbabc2618) successfully added.
To add a new
portinterface, repeat the previous command with the new interface. For example:
nmcli con add type ethernet ifname ens7 master mybond0Connection 'bond-slave-ens7' (ecc24c75-1c89-401f-90c8-9706531e0231) successfully added.
To activate the ports, issue a command as follows:
nmcli con up bond-slave-ens7Connection successfully activated (D-Bus active path: /org/freedesktop/NetworkManager/ActiveConnection/14)
nmcli con up bond-slave-ens3Connection successfully activated (D-Bus active path: /org/freedesktop/NetworkManager/ActiveConnection/15)
When you activate a port, the controller connection also starts. You can see Section 7.1, “Understanding the Default Behavior of Controller and Port Interfaces” for more information. In this case, it is not necessary to manually activate the controller connection.
It is possible to change the
active_slaveoption and the
primaryoption of the bond at runtime, without deactivating the connection. For example to change the
active_slaveoption, issue the following command:
~]$or to change the
nmcli dev mod bond0 +bond.options "active_slave=ens7"Connection successfully reapplied to device 'bond0'.
nmcli dev mod bond0 +bond.options "primary=ens3"Connection successfully reapplied to device 'bond0'.
active_slaveoption sets the currently active port whereas the
primaryoption of the bond specifies the active port to be automatically selected by kernel when a new port is added or a failure of the active port occurs.