The 'bondadm' Guide

bondadm is a tool used to create and activate aggregated link.

It will load the bonding driver when it is first run, in case the driver is not already loaded, it will create the appropriate bonding scripts in /etc/sysconfig/ov-net/ which will be called at boot by the sysvinit scripts.

bondadm can be run from the linux shell, or from ovios-shell. In ovios-shell it will open it's own subshell, where the admin must only enter the options. 


ovios-shell> bondadm

Type only the command arguments, like: -l | -h | -n etc.
To exit the bondadm CLI enter q or quit.

bondadm > -h

    The command bondsetup creates a bonded interface using one
    or more physical interfaces.

    Syntax: bondadm -[l|n|m|i|r|h|v]

    OPTIONS:
            -l : lists all bonded interfaces and their physical interfaces

            -n : name of the interface to be created.

            -m : aggergation mode of the new bond.
            Possible options are: 0 1 2 3 4 5 6
                            0 = balance-rr (default)
                            1 = active-backup
                            2 = balance-xor
                            3 = broadcast
                            4 = 802.3ad
                            5 = balance-tlb
                            6 = balance-alb

            -i : physical interfaces to bond. If more than one, enter
                     -i multiple times. Ex: -i eth0 -i eth2

            -r : removes a bonded interface. Requires bond name.

            -h : print usage

            -v : print version

Type only the command arguments, like: -l | -h | -n etc.
To exit the bondadm CLI enter q or quit.

bondadm >

1. Create a bonded interface:


It requires all of these options: -n -i -m

-n defines the name of the new interface. It must be a name not already existing in the system, as a physical or bonded interface.

-i defines the physical interfaces to be bonded. Usually there are more than one which will be used, use -i multiple times.

-m is the mode of the aggregation. Enter numbers between 0 and 6. See the description for each mode above. make sure you switch and NICs support the chosen mode.

-l lists all bonded interfaces, with status, mode and physical interfaces used as slaves. Must be the only option given.

-r removes a bond. Must be followed by the name of the bond.

-h prints the help menu.

-v prints version information.


Examples:

Create a new bonded interface called bond1 using 2 physical interfaces (eth1 and eth2), of balancing mode balance-xor, and list it after.

ovios-shell> bondadm

Type only the command arguments, like: -l | -h | -n etc.
To exit the bondadm CLI enter q or quit.

bondadm > -n bond1 -i eth1 -i eth2 -m 2
  *  Adding eth1 as slave...     [  OK  ]
  *  Adding eth2 as slave...     [  OK  ]
     Finished setting up bond1
     Run : netsetup : to set up the IPs.

Type only the command arguments, like: -l | -h | -n etc.
To exit the bondadm CLI enter q or quit.

bondadm > -l
1 ==>> bond1 : STATE: down : MODE: balance-xor 2
        Physical interfaces:
        1 ==> eth1
        2 ==> eth2


Type only the command arguments, like: -l | -h | -n etc.
To exit the bondadm CLI enter q or quit.

bondadm >

The order in which the options are given is not important.

2. Delete a bonded interface.

The option -s -r <interface name>


ovios-shell> bondadm

Type only the command arguments, like: -l | -h | -n etc.
To exit the bondadm CLI enter q or quit.

bondadm > -l
1 ==>> bond1 : STATE: down : MODE: balance-xor 2
        Physical interfaces:
        1 ==> eth1
        2 ==> eth2


Type only the command arguments, like: -l | -h | -n etc.
To exit the bondadm CLI enter q or quit.

bondadm > -r bond1
  *  Removing bond1..     [  OK  ]

Type only the command arguments, like: -l | -h | -n etc.
To exit the bondadm CLI enter q or quit.

bondadm > q
ovios-shell>