man/bond2team.1 - master - githubmirror/libteam

man/bond2team.1
92 строки3 KB
Stephen Wadeley
Minor improvements to style and language.
31 окт 2013, 16:48
31 окт 2013, 16:48444eb29
.TH BOND2TEAM 1 "2013-07-18" "libteam" "Bonding to Team conversion tool"
.SH NAME
bond2team \(em Converts bonding configuration to team
.SH SYNOPSIS
.B bond2team
.RB [options]
.SH DESCRIPTION
.PP
bond2team is a tool to convert bonding options to team trying as much as possible to keep the original functionality.
.PP
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.
.SH OPTIONS
.TP
.B "\-\-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.
.TP
.B "\-\-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.
.TP
.B \-\-ifcfg
Set the output format to ifcfg config style. [default]
.TP
.B \-\-json
Set the output format to JSON style. See
.BR teamd.conf (5)
for further details.
.TP
.B "\-\-bonding_opts '<bonding options>'"
Specify the bonding options to be converted instead of reading them from the ifcfg file.
.TP
.B "\-\-port <interface>"
Set the specified interface as a team port.
.TP
.B "\-\-configdir <directory>"
Change the ifcfg configuration path from \%/etc/sysconfig/network-scripts to the specified <directory>.
.TP
.B "\-\-outputdir <directory>"
Set the output directory to <directory>.
.TP
.B "\-\-stdout"
Print the result to the screen instead of writing to files.
.TP
.B "\-\-debug"
Increase the debugging level.
.TP
.B "\-\-quiet"
Disallow any messages to be printed to console.
.TP
.B "\-\-version"
Print tool version to console and exit.
.TP
.B "\-\-help"
Print help text to console and exit.
.TP
.B "\-\-examples"
Print common usage examples to console and exit.
.SH EXAMPLES
.PP
To convert the current 'bond0' ifcfg configuration to team ifcfg:
.TP
.nf
# bond2team \%--master \%bond0
.fi
.PP
To convert the current 'bond0' ifcfg configuration to team ifcfg renaming the interface name to 'team0'.
.B 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.
.PP
.nf
# bond2team \%--master \%bond0 \%--rename \%team0
.fi
.PP
To convert given bonding parameters with ports without any ifcfg:
.PP
.nf
# bond2team \-\-bonding_opts '\%mode=1 \%miimon=500 \%primary=eth1 \%primary_reselect=0' \%--port \%eth1 \%--port \%eth2 \%--port \%eth3 \%--port \%eth4
.fi
.PP
For more examples, see the option
.B \-\-examples.
.SH CAVEATS
.PP
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.
.SH AUTHOR
.PP
Flavio Leitner is the original author of the tool.
Jiri Pirko is the original author and current maintainer of libteam.
.SH SEE ALSO
.BR teamd (8),
.BR teamdctl (8),
.BR teamd.conf (5),
.BR teamnl (8)