Provided by: libteam-utils_1.29-0ubuntu2_amd64 bug

NAME

       bond2team — Converts bonding configuration to team

SYNOPSIS

       bond2team [options]

DESCRIPTION

       bond2team  is a tool to convert bonding options to team trying as much as possible to keep
       the original functionality.

       The resulting files are saved in a temporary directory using ifcfg style  by  default.  In
       the  case  of  converting  an  ifcfg  file,  it  translates  the  bonding options to team,
       preserving all other options. In that case, it converts the respective slave  ifcfg  files
       to  team  port,  preserving  all their other options too. In case of converting from given
       bonding options in the command line, the tool can use the specified ports as team ports.

OPTIONS

       --master <interface>
              Specify the interface name or ifcfg file to  convert.  If  the  interface  name  is
              specified, the tool will look at /etc/sysconfig/network-scripts/ for the respective
              ifcfg file.

       --rename <interface>
              This is a convenient option to replace the original interface name by the specified
              name.  For  instance,  if  --master specifies bond0, it is possible to use --rename
              team0 to change the final interface name to team0.

       --ifcfg
              Set the output format to ifcfg config style. [default]

       --json Set the output format to JSON style. See teamd.conf(5) for further details.

       --bonding_opts '<bonding options>'
              Specify the bonding options to be converted instead of reading them from the  ifcfg
              file.

       --port <interface>
              Set the specified interface as a team port.

       --configdir <directory>
              Change  the  ifcfg  configuration  path  from /etc/sysconfig/network-scripts to the
              specified <directory>.

       --outputdir <directory>
              Set the output directory to <directory>.

       --stdout
              Print the result to the screen instead of writing to files.

       --debug
              Increase the debugging level.

       --quiet
              Disallow any messages to be printed to console.

       --version
              Print tool version to console and exit.

       --help Print help text to console and exit.

       --examples
              Print common usage examples to console and exit.

EXAMPLES

       To convert the current 'bond0' ifcfg configuration to team ifcfg:

       # bond2team --master bond0

       To convert the current 'bond0' ifcfg configuration to team ifcfg  renaming  the  interface
       name  to 'team0'.  Caution : firewall rules, alias interfaces, etc., that might be tied to
       the original interface name can break after the renaming because the tool will only change
       the ifcfg file, nothing else.

       # bond2team --master bond0 --rename team0

       To convert given bonding parameters with ports without any ifcfg:

       # bond2team --bonding_opts 'mode=1 miimon=500 primary=eth1 primary_reselect=0' --port eth1 --port eth2 --port eth3 --port eth4

       For more examples, see the option --examples.

CAVEATS

       The  tool  will  not  convert  any  other configuration which might be tied to the current
       setup. For instance, firewall rules, alias interfaces, bridges, and so on.

AUTHOR

       Flavio Leitner is the original author of the tool.  Jiri Pirko is the original author  and
       current maintainer of libteam.

SEE ALSO

       teamd(8), teamdctl(8), teamd.conf(5), teamnl(8)