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 a distribution tarball, skip to step 2.
  34    Otherwise, you must be building from an Open vSwitch Git tree.
  35    Create a distribution tarball from the root of the Git tree by
  36    running:
  37
  38        ./boot.sh
  39        ./configure
  40        make dist
  41
  42 2. Now you have a distribution tarball, named something like
  43    openvswitch-x.y.z.tar.gz.  Copy this file into the RPM sources
  44    directory, e.g.:
  45
  46        cp openvswitch-x.y.z.tar.gz $HOME/rpmbuild/SOURCES
  47
  48 3. Make another copy of the distribution tarball in a temporary
  49    directory.  Then unpack the tarball and "cd" into its root, e.g.:
  50
  51        tar xzf openvswitch-x.y.z.tar.gz
  52        cd openvswitch-x.y.z
  53
  54 4. To build Open vSwitch userspace, run:
  55
  56        rpmbuild -bb rhel/openvswitch-fedora.spec
  57
  58    This produces one RPM: "openvswitch".
  59
  60    The above command automatically runs the Open vSwitch unit tests.
  61    To disable the unit tests, run:
  62
  63        rpmbuild -bb --without check rhel/openvswitch-fedora.spec
  64
  65 5. On Fedora 17, to build the Open vSwitch kernel module, run:
  66
  67         rpmbuild -bb rhel/openvswitch-kmod-fedora.spec
  68
  69     You might have to specify a kernel version and/or variants, e.g.:
  70
  71         rpmbuild -bb \
  72                 -D "kversion 2.6.32-131.6.1.el6.x86_64" \
  73                 -D "kflavors default debug kdump" \
  74                 rhel/openvswitch-kmod-rhel6.spec
  75
  76     This produces an "kmod-openvswitch" RPM for each kernel variant,
  77     in this example: "kmod-openvswitch", "kmod-openvswitch-debug", and
  78     "kmod-openvswitch-kdump".
  79
  80 Reporting Bugs
  81 --------------
  82
  83 Please report problems to bugs@openvswitch.org.