applied upstream commit 5b56f96aaad4a55a26576e0610fb49bde448dabe Signed-off-by: Flavio Leitner <fbl@redhat.com>f38
Flavio Leitner
11 years ago
parent
49d2e17ea5
commit
0455eaaccf
@ -0,0 +1,131 @@
|
||||
Red Hat network scripts integration
|
||||
-----------------------------------
|
||||
|
||||
The RPM packages for Open vSwitch provide some integration with Red
|
||||
Hat's network scripts. Using this integration is optional.
|
||||
|
||||
To use the integration for a Open vSwitch bridge or interface named
|
||||
<name>, create or edit /etc/sysconfig/network-scripts/ifcfg-<name>.
|
||||
This is a shell script that consists of a series of VARIABLE=VALUE
|
||||
assignments. The following OVS-specific variable names are supported:
|
||||
|
||||
- DEVICETYPE: Always set to "ovs".
|
||||
|
||||
- TYPE: If this is "OVSBridge", then this file represents an OVS
|
||||
bridge named <name>. Otherwise, it represents a port on an OVS
|
||||
bridge and TYPE must have one of the following values:
|
||||
|
||||
* "OVSPort", if <name> is a physical port (e.g. eth0) or
|
||||
virtual port (e.g. vif1.0).
|
||||
|
||||
* "OVSIntPort", if <name> is an internal port (e.g. a tagged
|
||||
VLAN).
|
||||
|
||||
* "OVSBond", if <name> is an OVS bond.
|
||||
|
||||
- OVS_BRIDGE: If TYPE is anything other than "OVSBridge", set to
|
||||
the name of the OVS bridge to which the port should be attached.
|
||||
|
||||
- OVS_OPTIONS: Optionally, extra options to set in the "Port"
|
||||
table when adding the port to the bridge, as a sequence of
|
||||
column[:key]=value options. For example, "tag=100" to make the
|
||||
port an access port for VLAN 100. See the documentation of
|
||||
"add-port" in ovs-vsctl(8) for syntax and the section on the
|
||||
Port table in ovs-vswitchd.conf.db(5) for available options.
|
||||
|
||||
- OVS_EXTRA: Optionally, additional ovs-vsctl commands, separated
|
||||
by "--" (double dash).
|
||||
|
||||
- BOND_IFACES: For "OVSBond" interfaces, a list of physical
|
||||
interfaces to bond together.
|
||||
|
||||
Note
|
||||
----
|
||||
|
||||
* "ifdown" on a bridge will not bring individual ports on the bridge
|
||||
down. "ifup" on a bridge will not add ports to the bridge. This
|
||||
behavior should be compatible with standard bridges (with
|
||||
TYPE=Bridge).
|
||||
|
||||
* If 'ifup' on an interface is called multiple times, one can see
|
||||
"RTNETLINK answers: File exists" printed on the console. This comes from
|
||||
ifup-eth trying to add zeroconf route multiple times and is harmless.
|
||||
|
||||
Examples
|
||||
--------
|
||||
|
||||
Standalone bridge:
|
||||
|
||||
==> ifcfg-ovsbridge0 <==
|
||||
DEVICE=ovsbridge0
|
||||
ONBOOT=yes
|
||||
DEVICETYPE=ovs
|
||||
TYPE=OVSBridge
|
||||
BOOTPROTO=static
|
||||
IPADDR=A.B.C.D
|
||||
NETMASK=X.Y.Z.0
|
||||
HOTPLUG=no
|
||||
|
||||
Enable DHCP on the bridge:
|
||||
* Needs OVSBOOTPROTO instead of BOOTPROTO.
|
||||
* All the interfaces that can reach the DHCP server
|
||||
as a space separated list in OVSDHCPINTERFACES.
|
||||
|
||||
DEVICE=ovsbridge0
|
||||
ONBOOT=yes
|
||||
DEVICETYPE=ovs
|
||||
TYPE=OVSBridge
|
||||
OVSBOOTPROTO="dhcp"
|
||||
OVSDHCPINTERFACES="eth0"
|
||||
HOTPLUG=no
|
||||
|
||||
Adding physical eth0 to ovsbridge0 described above:
|
||||
|
||||
==> ifcfg-eth0 <==
|
||||
DEVICE=eth0
|
||||
ONBOOT=yes
|
||||
DEVICETYPE=ovs
|
||||
TYPE=OVSPort
|
||||
OVS_BRIDGE=ovsbridge0
|
||||
BOOTPROTO=none
|
||||
HOTPLUG=no
|
||||
|
||||
|
||||
Tagged VLAN interface on top of ovsbridge0:
|
||||
|
||||
==> ifcfg-vlan100 <==
|
||||
DEVICE=vlan100
|
||||
ONBOOT=yes
|
||||
DEVICETYPE=ovs
|
||||
TYPE=OVSIntPort
|
||||
BOOTPROTO=static
|
||||
IPADDR=A.B.C.D
|
||||
NETMASK=X.Y.Z.0
|
||||
OVS_BRIDGE=ovsbridge0
|
||||
OVS_OPTIONS="tag=100"
|
||||
OVS_EXTRA="set Interface $DEVICE external-ids:iface-id=$(hostname -s)-$DEVICE-vif"
|
||||
HOTPLUG=no
|
||||
|
||||
|
||||
Bonding:
|
||||
|
||||
==> ifcfg-bond0 <==
|
||||
DEVICE=bond0
|
||||
ONBOOT=yes
|
||||
DEVICETYPE=ovs
|
||||
TYPE=OVSBond
|
||||
OVS_BRIDGE=ovsbridge0
|
||||
BOOTPROTO=none
|
||||
BOND_IFACES="gige-1b-0 gige-1b-1 gige-21-0 gige-21-1"
|
||||
OVS_OPTIONS="bond_mode=balance-tcp lacp=active"
|
||||
HOTPLUG=no
|
||||
|
||||
==> ifcfg-gige-* <==
|
||||
DEVICE=gige-*
|
||||
ONBOOT=yes
|
||||
HOTPLUG=no
|
||||
|
||||
Reporting Bugs
|
||||
--------------
|
||||
|
||||
Please report problems to bugs@openvswitch.org.
|
||||
Loading…
Reference in new issue