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 The default RPM build directory (_topdir) has five directories in
  17 the top-level:
  18 1. BUILD/ Where the software is unpacked and built.
  19 2. RPMS/ Where the newly created binary package files are written.
  20 3. SOURCES/ Contains the original sources, patches, and icon files.
  21 4. SPECS/ Contains the spec files for each package to be built.
  22 5. SRPMS/ Where the newly created source package files are written.
  23
  24 Before you begin, note the RPM sources directory on your version of
  25 Fedora.  The command "rpmbuild --showrc" will show the configuration
  26 for each of those directories. Alternatively, the command "rpm --eval
  27  '%{_topdir}'" shows the current configuration for the top level
  28 directory and the command "rpm --eval '%{_sourcedir}'" does the same
  29 for the sources directory.  On Fedora 17, the default RPM _topdir is
  30 $HOME/rpmbuild and the default RPM sources directory is
  31 $HOME/rpmbuild/SOURCES.
  32
  33 1. If you are building from an Open vSwitch Git tree, then you will
  34    need to first create a distribution tarball by running "./boot.sh;
  35    ./configure; make dist" in the Git tree.
  36
  37 2. Copy the distribution tarball into the RPM sources directory.
  38
  39 3. Unpack the distribution tarball into a temporary directory and "cd"
  40    into the root of the distribution tarball.
  41
  42 4. To build Open vSwitch userspace, run:
  43
  44        rpmbuild -bb rhel/openvswitch-fedora.spec
  45
  46    This produces one RPM: "openvswitch".
  47
  48    The above command automatically runs the Open vSwitch unit tests.
  49    To disable the unit tests, run:
  50
  51        rpmbuild -bb --without check rhel/openvswitch-fedora.spec
  52
  53 5. On Fedora 17, to build the Open vSwitch kernel module, run:
  54
  55         rpmbuild -bb rhel/openvswitch-kmod-fedora.spec
  56
  57     You might have to specify a kernel version and/or variants, e.g.:
  58
  59         rpmbuild -bb \
  60                 -D "kversion 2.6.32-131.6.1.el6.x86_64" \
  61                 -D "kflavors default debug kdump" \
  62                 rhel/openvswitch-kmod-rhel6.spec
  63
  64     This produces an "kmod-openvswitch" RPM for each kernel variant,
  65     in this example: "kmod-openvswitch", "kmod-openvswitch-debug", and
  66     "kmod-openvswitch-kdump".
  67
  68 Reporting Bugs
  69 --------------
  70
  71 Please report problems to bugs@openvswitch.org.