bond2team(1)

1BOND2TEAM(1)            Bonding to Team conversion tool           BOND2TEAM(1)
2
3
4

NAME

6       bond2team — Converts bonding configuration to team
7

SYNOPSIS

9       bond2team [options]
10

DESCRIPTION

12       bond2team  is  a tool to convert bonding options to team trying as much
13       as possible to keep the original functionality.
14
15       The resulting files are saved in  a  temporary  directory  using  ifcfg
16       style  by  default.  In the case of converting an ifcfg file, it trans‐
17       lates the bonding options to team, preserving  all  other  options.  In
18       that  case,  it converts the respective slave ifcfg files to team port,
19       preserving all their other options too.  In  case  of  converting  from
20       given  bonding options in the command line, the tool can use the speci‐
21       fied ports as team ports.
22

OPTIONS

24       --master <interface>
25              Specify the interface name or ifcfg  file  to  convert.  If  the
26              interface   name   is   specified,   the   tool   will  look  at
27              /etc/sysconfig/network-scripts/ for the respective ifcfg file.
28
29       --rename <interface>
30              This is a convenient option to replace  the  original  interface
31              name  by the specified name. For instance, if --master specifies
32              bond0, it is possible to use --rename team0 to change the  final
33              interface name to team0.
34
35       --ifcfg
36              Set the output format to ifcfg config style. [default]
37
38       --json Set  the output format to JSON style. See teamd.conf(5) for fur‐
39              ther details.
40
41       --bonding_opts '<bonding options>'
42              Specify the bonding options to be converted instead  of  reading
43              them from the ifcfg file.
44
45       --port <interface>
46              Set the specified interface as a team port.
47
48       --configdir <directory>
49              Change      the      ifcfg      configuration      path     from
50              /etc/sysconfig/network-scripts to the specified <directory>.
51
52       --outputdir <directory>
53              Set the output directory to <directory>.
54
55       --stdout
56              Print the result to the screen instead of writing to files.
57
58       --debug
59              Increase the debugging level.
60
61       --quiet
62              Disallow any messages to be printed to console.
63
64       --version
65              Print tool version to console and exit.
66
67       --help Print help text to console and exit.
68
69       --examples
70              Print common usage examples to console and exit.
71

EXAMPLES

73       To convert the current 'bond0' ifcfg configuration to team ifcfg:
74
75       # bond2team --master bond0
76
77       To convert the current 'bond0' ifcfg configuration to team ifcfg renam‐
78       ing  the  interface  name  to 'team0'.  Caution : firewall rules, alias
79       interfaces, etc., that might be tied to the original interface name can
80       break  after  the  renaming because the tool will only change the ifcfg
81       file, nothing else.
82
83       # bond2team --master bond0 --rename team0
84
85       To convert given bonding parameters with ports without any ifcfg:
86
87       # bond2team --bonding_opts 'mode=1 miimon=500 primary=eth1 primary_reselect=0' --port eth1 --port eth2 --port eth3 --port eth4
88
89       For more examples, see the option --examples.
90

CAVEATS

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

AUTHOR

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