]>
Commit | Line | Data |
---|---|---|
542cc9bb TG |
1 | How to Install Open vSwitch on Fedora Linux |
2 | =========================================== | |
d8fe0a6a RS |
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, | |
9feb1017 | 6 | see [INSTALL.md] instead. |
d8fe0a6a RS |
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 | |
542cc9bb | 38 | ``` |
935cdc95 BP |
39 | ./boot.sh |
40 | ./configure | |
41 | make dist | |
542cc9bb | 42 | ``` |
d8fe0a6a | 43 | |
935cdc95 BP |
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 | |
46 | directory, e.g.: | |
47 | ||
542cc9bb | 48 | `cp openvswitch-x.y.z.tar.gz $HOME/rpmbuild/SOURCES` |
935cdc95 BP |
49 | |
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.: | |
52 | ||
542cc9bb | 53 | ``` |
935cdc95 BP |
54 | tar xzf openvswitch-x.y.z.tar.gz |
55 | cd openvswitch-x.y.z | |
542cc9bb | 56 | ``` |
d8fe0a6a RS |
57 | |
58 | 4. To build Open vSwitch userspace, run: | |
59 | ||
542cc9bb | 60 | `rpmbuild -bb rhel/openvswitch-fedora.spec` |
d8fe0a6a RS |
61 | |
62 | This produces one RPM: "openvswitch". | |
63 | ||
329cf232 GS |
64 | The above command automatically runs the Open vSwitch unit tests. |
65 | To disable the unit tests, run: | |
66 | ||
542cc9bb | 67 | `rpmbuild -bb --without check rhel/openvswitch-fedora.spec` |
329cf232 | 68 | |
de34f9f4 | 69 | 5. On Fedora 17, to build the Open vSwitch kernel module, run: |
d8fe0a6a | 70 | |
542cc9bb | 71 | `rpmbuild -bb rhel/openvswitch-kmod-fedora.spec` |
d8fe0a6a RS |
72 | |
73 | You might have to specify a kernel version and/or variants, e.g.: | |
74 | ||
542cc9bb | 75 | ``` |
d8fe0a6a RS |
76 | rpmbuild -bb \ |
77 | -D "kversion 2.6.32-131.6.1.el6.x86_64" \ | |
78 | -D "kflavors default debug kdump" \ | |
79 | rhel/openvswitch-kmod-rhel6.spec | |
542cc9bb | 80 | ``` |
d8fe0a6a RS |
81 | |
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". | |
85 | ||
86 | Reporting Bugs | |
87 | -------------- | |
88 | ||
89 | Please report problems to bugs@openvswitch.org. | |
9feb1017 TG |
90 | |
91 | [INSTALL.md]:INSTALL.md |