1 How to Install Open vSwitch on Fedora Linux
2 ===========================================
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.
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.
11 Building Open vSwitch for Fedora
12 --------------------------------
14 You may build from an Open vSwitch distribution tarball or from an
15 Open vSwitch Git tree.
17 The default RPM build directory (_topdir) has five directories in
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.
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.
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
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
49 `cp openvswitch-x.y.z.tar.gz $HOME/rpmbuild/SOURCES`
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.:
55 tar xzf openvswitch-x.y.z.tar.gz
59 4. To build Open vSwitch userspace, run:
61 `rpmbuild -bb rhel/openvswitch-fedora.spec`
63 This produces one RPM: "openvswitch".
65 To enable DPDK support in the resulting openvswitch package,
66 add `--with dpdk` to the build command.
68 The above command automatically runs the Open vSwitch unit tests.
69 To disable the unit tests, run:
71 `rpmbuild -bb --without check rhel/openvswitch-fedora.spec`
73 5. On Fedora 23, to build the Open vSwitch kernel module, run:
75 `rpmbuild -bb rhel/openvswitch-kmod-fedora.spec`
77 You might have to specify a kernel version and/or variants, e.g.:
81 -D "kversion 4.3.3-300.fc23.x86_64” \
82 -D "kflavors default debug kdump" \
83 rhel/openvswitch-kmod-fedora.spec
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".
93 Please report problems to bugs@openvswitch.org.
95 [INSTALL.md]:INSTALL.md