BOND2TEAM(1)						  Bonding to Team conversion tool					      BOND2TEAM(1)

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,  pre-
       serving	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)

libteam 							    2013-07-18							      BOND2TEAM(1)