rhel/README.RHEL

   1 Red Hat network scripts integration
   2 -----------------------------------
   3
   4 The RPM packages for Open vSwitch provide some integration with Red
   5 Hat's network scripts.  Using this integration is optional.
   6
   7 To use the integration for a Open vSwitch bridge or interface named
   8 <name>, create or edit /etc/sysconfig/network-scripts/ifcfg-<name>.
   9 This is a shell script that consists of a series of VARIABLE=VALUE
  10 assignments.  The following OVS-specific variable names are supported:
  11
  12     - DEVICETYPE: Always set to "ovs".
  13
  14     - TYPE: If this is "OVSBridge", then this file represents an OVS
  15       bridge named <name>.  Otherwise, it represents a port on an OVS
  16       bridge and TYPE must have one of the following values:
  17
  18         * "OVSPort", if <name> is a physical port (e.g. eth0) or
  19           virtual port (e.g. vif1.0).
  20
  21         * "OVSIntPort", if <name> is an internal port (e.g. a tagged
  22           VLAN).
  23
  24         * "OVSBond", if <name> is an OVS bond.
  25
  26     - OVS_BRIDGE: If TYPE is anything other than "OVSBridge", set to
  27       the name of the OVS bridge to which the port should be attached.
  28
  29     - OVS_OPTIONS: Optionally, extra options to set in the "Port"
  30       table when adding the port to the bridge, as a sequence of
  31       column[:key]=value options.  For example, "tag=100" to make the
  32       port an access port for VLAN 100.  See the documentation of
  33       "add-port" in ovs-vsctl(8) for syntax and the section on the
  34       Port table in ovs-vswitchd.conf.db(5) for available options.
  35
  36     - OVS_EXTRA: Optionally, additional ovs-vsctl commands, separated
  37       by "--" (double dash).
  38
  39     - BOND_IFACES: For "OVSBond" interfaces, a list of physical
  40       interfaces to bond together.
  41
  42 Note
  43 ----
  44
  45 "ifdown" on a bridge will not bring individual ports on the bridge
  46 down.  "ifup" on a bridge will not add ports to the bridge.  This
  47 behavior should be compatible with standard bridges (with
  48 TYPE=Bridge).
  49
  50 Examples
  51 --------
  52
  53 Standalone bridge:
  54
  55 ==> ifcfg-ovsbridge0 <==
  56 DEVICE=ovsbridge0
  57 ONBOOT=yes
  58 DEVICETYPE=ovs
  59 TYPE=OVSBridge
  60 BOOTPROTO=static
  61 IPADDR=A.B.C.D
  62 NETMASK=X.Y.Z.0
  63 HOTPLUG=no
  64
  65 Enable DHCP on the bridge:
  66 * Needs OVSBOOTPROTO instead of BOOTPROTO.
  67 * All the interfaces that can reach the DHCP server
  68 as a comma separated list in OVSDHCPINTERFACES.
  69
  70 DEVICE=ovsbridge0
  71 ONBOOT=yes
  72 DEVICETYPE=ovs
  73 TYPE=OVSBridge
  74 OVSBOOTPROTO="dhcp"
  75 OVSDHCPINTERFACES="eth0"
  76 HOTPLUG=no
  77
  78 Adding physical eth0 to ovsbridge0 described above:
  79
  80 ==> ifcfg-eth0 <==
  81 DEVICE=eth0
  82 ONBOOT=yes
  83 DEVICETYPE=ovs
  84 TYPE=OVSPort
  85 OVS_BRIDGE=ovsbridge0
  86 BOOTPROTO=none
  87 HOTPLUG=no
  88
  89
  90 Tagged VLAN interface on top of ovsbridge0:
  91
  92 ==> ifcfg-vlan100 <==
  93 DEVICE=vlan100
  94 ONBOOT=yes
  95 DEVICETYPE=ovs
  96 TYPE=OVSIntPort
  97 BOOTPROTO=static
  98 IPADDR=A.B.C.D
  99 NETMASK=X.Y.Z.0
 100 OVS_BRIDGE=ovsbridge0
 101 OVS_OPTIONS="tag=100"
 102 OVS_EXTRA="set Interface $DEVICE external-ids:iface-id=$(hostname -s)-$DEVICE-vif"
 103 HOTPLUG=no
 104
 105
 106 Bonding:
 107
 108 ==> ifcfg-bond0 <==
 109 DEVICE=bond0
 110 ONBOOT=yes
 111 DEVICETYPE=ovs
 112 TYPE=OVSBond
 113 OVS_BRIDGE=ovsbridge0
 114 BOOTPROTO=none
 115 BOND_IFACES="gige-1b-0 gige-1b-1 gige-21-0 gige-21-1"
 116 OVS_OPTIONS="bond_mode=balance-tcp lacp=active"
 117 HOTPLUG=no
 118
 119 ==> ifcfg-gige-* <==
 120 DEVICE=gige-*
 121 ONBOOT=yes
 122 HOTPLUG=no
 123
 124 Reporting Bugs
 125 --------------
 126
 127 Please report problems to bugs@openvswitch.org.