]>
Commit | Line | Data |
---|---|---|
d8fe0a6a RS |
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 | ||
1547f8e3 FL |
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. | |
d8fe0a6a | 32 | |
935cdc95 BP |
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: | |
d8fe0a6a | 37 | |
935cdc95 BP |
38 | ./boot.sh |
39 | ./configure | |
40 | make dist | |
d8fe0a6a | 41 | |
935cdc95 BP |
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 | |
d8fe0a6a RS |
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 | ||
329cf232 GS |
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 | ||
de34f9f4 | 65 | 5. On Fedora 17, to build the Open vSwitch kernel module, run: |
d8fe0a6a RS |
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. |