INSTALL.Fedora

   1        How to Install Open vSwitch on Fedora Linux
   2        ===========================================
   3
   4 This document describes how to build and install Open vSwitch on a Fedora
   5 Linux host.  If you want to install Open vSwitch on a generic Linux host,
   6 see INSTALL.Linux instead.
   7
   8 We have tested these instructions with Fedora 16 and Fedora 17.
   9
  10 Building Open vSwitch for Fedora
  11 --------------------------------
  12
  13 You may build from an Open vSwitch distribution tarball or from an
  14 Open vSwitch Git tree.
  15
  16 Before you begin, note the RPM source directory on your version of
  17 Fedora.  On Fedora 17, it is $HOME/rpmbuild/SOURCES.
  18
  19 1. If you are building from an Open vSwitch Git tree, then you will
  20    need to first create a distribution tarball by running "./boot.sh;
  21    ./configure; make dist" in the Git tree.
  22
  23 2. Copy the distribution tarball into the RPM source directory.
  24
  25 3. Unpack the distribution tarball into a temporary directory and "cd"
  26    into the root of the distribution tarball.
  27
  28 4. To build Open vSwitch userspace, run:
  29
  30        rpmbuild -bb rhel/openvswitch-fedora.spec
  31
  32    This produces one RPM: "openvswitch".
  33
  34    The above command automatically runs the Open vSwitch unit tests.
  35    To disable the unit tests, run:
  36
  37        rpmbuild -bb --without check rhel/openvswitch-fedora.spec
  38
  39 5. On Fedora 17, to build the Open vSwitch kernel module, run:
  40
  41         rpmbuild -bb rhel/openvswitch-kmod-fedora.spec
  42
  43     You might have to specify a kernel version and/or variants, e.g.:
  44
  45         rpmbuild -bb \
  46                 -D "kversion 2.6.32-131.6.1.el6.x86_64" \
  47                 -D "kflavors default debug kdump" \
  48                 rhel/openvswitch-kmod-rhel6.spec
  49
  50     This produces an "kmod-openvswitch" RPM for each kernel variant,
  51     in this example: "kmod-openvswitch", "kmod-openvswitch-debug", and
  52     "kmod-openvswitch-kdump".
  53
  54 Reporting Bugs
  55 --------------
  56
  57 Please report problems to bugs@openvswitch.org.