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 16 and Fedora 17.
10 Building Open vSwitch for Fedora
11 --------------------------------
13 You may build from an Open vSwitch distribution tarball or from an
14 Open vSwitch Git tree.
16 The default RPM build directory (_topdir) has five directories in
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.
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.
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
44 2. Now you have a distribution tarball, named something like
45 openvswitch-x.y.z.tar.gz. Copy this file into the RPM sources
48 `cp openvswitch-x.y.z.tar.gz $HOME/rpmbuild/SOURCES`
50 3. Make another copy of the distribution tarball in a temporary
51 directory. Then unpack the tarball and "cd" into its root, e.g.:
54 tar xzf openvswitch-x.y.z.tar.gz
58 4. To build Open vSwitch userspace, run:
60 `rpmbuild -bb rhel/openvswitch-fedora.spec`
62 This produces one RPM: "openvswitch".
64 The above command automatically runs the Open vSwitch unit tests.
65 To disable the unit tests, run:
67 `rpmbuild -bb --without check rhel/openvswitch-fedora.spec`
69 5. On Fedora 17, to build the Open vSwitch kernel module, run:
71 `rpmbuild -bb rhel/openvswitch-kmod-fedora.spec`
73 You might have to specify a kernel version and/or variants, e.g.:
77 -D "kversion 2.6.32-131.6.1.el6.x86_64" \
78 -D "kflavors default debug kdump" \
79 rhel/openvswitch-kmod-rhel6.spec
82 This produces an "kmod-openvswitch" RPM for each kernel variant,
83 in this example: "kmod-openvswitch", "kmod-openvswitch-debug", and
84 "kmod-openvswitch-kdump".
89 Please report problems to bugs@openvswitch.org.
91 [INSTALL.md]:INSTALL.md