Fedora, RHEL 7.x Packaging for Open vSwitch¶
This document provides instructions for building and installing Open vSwitch RPM packages on a Fedora Linux host. Instructions for the installation of Open vSwitch on a Fedora Linux host without using RPM packages can be found in the Open vSwitch on Linux, FreeBSD and NetBSD.
These instructions have been tested with Fedora 23, and are also applicable for RHEL 7.x and its derivatives, including CentOS 7.x and Scientific Linux 7.x.
Build Requirements¶
You will need to install all required packages to build the RPMs.
Newer distributions use dnf
but if it’s not available, then use
yum
instructions.
The command below will install RPM tools and generic build dependencies. And (optionally) include these packages: libcap-ng libcap-ng-devel dpdk-devel.
DNF:
$ dnf install @'Development Tools' rpm-build dnf-plugins-core
YUM:
$ yum install @'Development Tools' rpm-build yum-utils
Then it is necessary to install Open vSwitch specific build dependencies. The dependencies are listed in the SPEC file, but first it is necessary to replace the VERSION tag to be a valid SPEC.
The command below will create a temporary SPEC file:
$ sed -e 's/@VERSION@/0.0.1/' rhel/openvswitch-fedora.spec.in \
> /tmp/ovs.spec
And to install specific dependencies, use the corresponding tool below. For some of the dependencies on RHEL you may need to add two additional repositories to help yum-builddep, e.g.:
$ subscription-manager repos --enable=rhel-7-server-extras-rpms
$ subscription-manager repos --enable=rhel-7-server-optional-rpms
or for RHEL 8:
$ subscription-manager repos \
--enable=codeready-builder-for-rhel-8-x86_64-rpms
DNF:
$ dnf builddep /tmp/ovs.spec
YUM:
$ yum-builddep /tmp/ovs.spec
Once that is completed, remove the file /tmp/ovs.spec
.
Bootstrapping¶
Refer to Bootstrapping.
Configuring¶
Refer to Configuring.
Building¶
User Space RPMs¶
To build Open vSwitch user-space RPMs, execute the following from the directory in which ./configure was executed:
$ make rpm-fedora
This will create the RPMs openvswitch, python3-openvswitch, openvswitch-test, openvswitch-devel and openvswitch-debuginfo.
To enable DPDK support in the openvswitch package, the --with dpdk
option
can be added:
$ make rpm-fedora RPMBUILD_OPT="--with dpdk --without check"
To enable AF_XDP support in the openvswitch package, the --with afxdp
option can be added:
$ make rpm-fedora RPMBUILD_OPT="--with afxdp --without check"
You can also have the above commands automatically run the Open vSwitch unit tests. This can take several minutes.
$ make rpm-fedora RPMBUILD_OPT="--with check"
Installing¶
RPM packages can be installed by using the command rpm -i
. Package
installation requires superuser privileges.
In most cases only the openvswitch RPM will need to be installed. The python3-openvswitch, openvswitch-test, openvswitch-devel, and openvswitch-debuginfo RPMs are optional unless required for a specific purpose.
Refer to the RHEL README for additional usage and configuration information.
Reporting Bugs¶
Report problems to bugs@openvswitch.org.