]>
Commit | Line | Data |
---|---|---|
542cc9bb TG |
1 | How to Install Open vSwitch on Fedora Linux |
2 | =========================================== | |
d8fe0a6a | 3 | |
35666f1c LR |
4 | This document provides instructions for building and installing Open vSwitch |
5 | RPM packages on a Fedora Linux host. Instructions for the installation of | |
6 | Open vSwitch on a Fedora Linux host without using RPM packages can be found | |
7 | in [INSTALL.md]. | |
8 | ||
9 | These instructions have been tested with Fedora 23, and are also applicable | |
10 | for RHEL 7.x and its derivatives, including CentOS 7.x and Scientific Linux | |
11 | 7.x. | |
12 | ||
13 | Build Requirements | |
14 | ------------------ | |
15 | The tools and packages that are required for building Open vSwitch are | |
16 | documented in [INSTALL.md]. Specific packages (by package name) include: | |
17 | ||
18 | - rpm-build | |
19 | - autoconf automake libtool | |
20 | - systemd-units openssl openssl-devel | |
21 | - python python-twisted-core python-zope-interface PyQt4 python-six | |
22 | - desktop-file-utils | |
23 | - groff graphviz | |
24 | - procps-ng | |
25 | ||
26 | And (optionally): | |
27 | ||
28 | - libcap-ng libcap-ng-devel | |
29 | - dpdk-devel | |
30 | ||
31 | Building Open vSwitch RPMs for Fedora | |
32 | ------------------------------------- | |
33 | ||
34 | RPMs may be built from an Open vSwitch distribution tarball or from an | |
35 | Open vSwitch Git tree. The build procedure for each scenario is described | |
36 | below. | |
37 | ||
38 | ### Preparing to Build Open vSwitch RPMs with a GIT Tree | |
39 | From the top-level directory of the git tree, execute the following | |
40 | commands: | |
41 | ||
42 | ``` | |
43 | ./boot.sh | |
44 | ./configure | |
45 | ``` | |
46 | ||
47 | ### Preparing to Build Open vSwitch RPMs from a Tarball | |
48 | From a directory with appropriate permissions, execute the following commands | |
49 | (substituting the relevant Open vSwitch release version for "x.y.z"): | |
50 | ||
51 | ``` | |
52 | tar xzf openvswitch-x.y.z.tar.gz | |
53 | cd openvswitch-x.y.z | |
54 | ./configure | |
55 | ``` | |
56 | ||
57 | ### Building the User-Space RPMs | |
58 | To build Open vSwitch user-space RPMs, after having completed the appropriate | |
59 | preparation steps described above, execute the following from the directory | |
60 | in which `./configure` was executed: | |
61 | ||
62 | ``` | |
63 | make rpm-fedora | |
64 | ``` | |
65 | ||
66 | This will create the RPMs `openvswitch`, `python-openvswitch`, | |
67 | `openvswitch-test`, `openvswitch-devel`, `openvswitch-ovn`, | |
68 | and `openvswitch-debuginfo`. | |
69 | ||
70 | To enable DPDK support in the openvswitch package, | |
71 | the `--with dpdk` option can be added: | |
72 | ||
73 | ``` | |
74 | make rpm-fedora RPMBUILD_OPT="--with dpdk" | |
75 | ``` | |
76 | ||
77 | The above commands automatically run the Open vSwitch unit tests, | |
78 | which can take several minutes. To reduce the build time by | |
79 | disabling the execution of these tests, the `--without check` | |
80 | option can be added: | |
81 | ||
82 | ``` | |
83 | make rpm-fedora RPMBUILD_OPT="--without check" | |
84 | ``` | |
85 | ||
86 | ### Building the Kernel OVS Tree Datapath RPM | |
87 | To build the Open vSwitch kernel module for the currently running | |
88 | kernel version, execute: | |
89 | ||
90 | ``` | |
91 | make rpm-fedora-kmod | |
92 | ``` | |
93 | ||
94 | To build the Open vSwitch kernel module for another kernel version, | |
95 | the desired kernel version can be specified via the `kversion` macro. | |
96 | For example: | |
97 | ||
98 | ``` | |
99 | make rpm-fedora-kmod \ | |
100 | RPMBUILD_OPT='-D "kversion 4.3.4-300.fc23.x86_64"' | |
101 | ``` | |
102 | ||
103 | Installing Open vSwitch RPMs | |
104 | ---------------------------- | |
105 | RPM packages can be installed by using the command `rpm -i`. Package | |
106 | installation requires superuser privileges. | |
107 | ||
108 | The openvswitch-kmod RPM should be installed first if the Linux OVS tree datapath | |
109 | module is to be used. The openvswitch-kmod RPM should not be installed if | |
110 | only the in-tree Linux datapath or user-space datapath is needed. See [FAQ.md] | |
111 | for more information about the various Open vSwitch datapath options. | |
d8fe0a6a | 112 | |
35666f1c LR |
113 | In most cases only the `openvswitch` and (when using OVN) `openvswitch-ovn` RPMs |
114 | will need to be installed. The `python-openvswitch`, `openvswitch-test`, `openvswitch-devel`, | |
115 | and `openvswitch-debuginfo` RPMs are optional unless required for a specific purpose. | |
d8fe0a6a | 116 | |
35666f1c | 117 | See [rhel/README.RHEL] for additional usage and configuration information. |
d8fe0a6a RS |
118 | |
119 | Reporting Bugs | |
120 | -------------- | |
121 | ||
122 | Please report problems to bugs@openvswitch.org. | |
9feb1017 TG |
123 | |
124 | [INSTALL.md]:INSTALL.md | |
35666f1c LR |
125 | [FAQ.md]:FAQ.md |
126 | [README.RHEL]:rhel/README.RHEL |