projects / mirror_ovs.git / blame
| 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. |