INSTALL.Fedora.md

   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.md] instead.
   7
   8 We have tested these instructions with Fedora 23. These instructions are also
   9 used for RHEL 7.x and its derivatives, such as CentOS 7.x.
  10
  11 Building Open vSwitch for Fedora
  12 --------------------------------
  13
  14 You may build from an Open vSwitch distribution tarball or from an
  15 Open vSwitch Git tree.
  16
  17 The default RPM build directory (_topdir) has five directories in
  18 the top-level:
  19 1. BUILD/ Where the software is unpacked and built.
  20 2. RPMS/ Where the newly created binary package files are written.
  21 3. SOURCES/ Contains the original sources, patches, and icon files.
  22 4. SPECS/ Contains the spec files for each package to be built.
  23 5. SRPMS/ Where the newly created source package files are written.
  24
  25 Before you begin, note the RPM sources directory on your version of
  26 Fedora.  The command "rpmbuild --showrc" will show the configuration
  27 for each of those directories. Alternatively, the command "rpm --eval
  28  '%{_topdir}'" shows the current configuration for the top level
  29 directory and the command "rpm --eval '%{_sourcedir}'" does the same
  30 for the sources directory.  On Fedora 23, the default RPM _topdir is
  31 $HOME/rpmbuild and the default RPM sources directory is
  32 $HOME/rpmbuild/SOURCES.
  33
  34 1. If you are building from a distribution tarball, skip to step 2.
  35    Otherwise, you must be building from an Open vSwitch Git tree.
  36    Create a distribution tarball from the root of the Git tree by
  37    running:
  38
  39        ```
  40        ./boot.sh
  41        ./configure
  42        make dist
  43            ```
  44
  45 2. Now you have a distribution tarball, named something like
  46    openvswitch-x.y.z.tar.gz.  Copy this file into the RPM sources
  47    directory, e.g.:
  48
  49        `cp openvswitch-x.y.z.tar.gz $HOME/rpmbuild/SOURCES`
  50
  51 3. Make another copy of the distribution tarball in a temporary
  52    directory.  Then unpack the tarball and "cd" into its root, e.g.:
  53
  54        ```
  55        tar xzf openvswitch-x.y.z.tar.gz
  56        cd openvswitch-x.y.z
  57            ```
  58
  59 4. To build Open vSwitch userspace, run:
  60
  61        `rpmbuild -bb rhel/openvswitch-fedora.spec`
  62
  63    This produces one RPM: "openvswitch".
  64
  65    To enable DPDK support in the resulting openvswitch package,
  66    add `--with dpdk` to the build command.
  67
  68    The above command automatically runs the Open vSwitch unit tests.
  69    To disable the unit tests, run:
  70
  71        `rpmbuild -bb --without check rhel/openvswitch-fedora.spec`
  72
  73 5. On Fedora 23, to build the Open vSwitch kernel module, run:
  74
  75         `rpmbuild -bb rhel/openvswitch-kmod-fedora.spec`
  76
  77     You might have to specify a kernel version and/or variants, e.g.:
  78
  79         ```
  80         rpmbuild -bb \
  81                 -D "kversion 4.3.3-300.fc23.x86_64” \
  82                 -D "kflavors default debug kdump" \
  83                 rhel/openvswitch-kmod-fedora.spec
  84         ```
  85
  86     This produces an "kmod-openvswitch" RPM for each kernel variant,
  87     in this example: "kmod-openvswitch", "kmod-openvswitch-debug", and
  88     "kmod-openvswitch-kdump".
  89
  90 Reporting Bugs
  91 --------------
  92
  93 Please report problems to bugs@openvswitch.org.
  94
  95 [INSTALL.md]:INSTALL.md