@@ -290,7 +290,7 @@ The "underlay" mode
Depending on your VM, you can make the above step persistent across reboots.
For example, if your VM is Debian/Ubuntu-based, read
`openvswitch-switch.README.Debian` found in `debian` folder. If your VM is
- RHEL-based, refer to the `RHEL install guide <../../INSTALL.RHEL.md>`__.
+ RHEL-based, refer to the `RHEL install guide <../../INSTALL.RHEL.rst>`__.
3. Start the Open vSwitch network driver
deleted file mode 100644
@@ -1,171 +0,0 @@
-How to Install Open vSwitch on Red Hat Enterprise Linux
-=======================================================
-
-This document describes how to build and install Open vSwitch on a Red
-Hat Enterprise Linux (RHEL) host. If you want to install Open vSwitch
-on a generic Linux host, see [INSTALL.rst] instead.
-
-We have tested these instructions with RHEL 5.6 and RHEL 6.0.
-
-For RHEL 7.x (or derivatives, such as CentOS 7.x), you should follow
-the instructions in [INSTALL.Fedora.rst]. The Fedora spec files are
-used for RHEL 7.x.
-
-Building Open vSwitch for RHEL
-------------------------------
-
-You may build from an Open vSwitch distribution tarball or from an
-Open vSwitch Git tree.
-
-The default RPM build directory (_topdir) has five directories in
-the top-level:
-1. BUILD/ Where the software is unpacked and built.
-2. RPMS/ Where the newly created binary package files are written.
-3. SOURCES/ Contains the original sources, patches, and icon files.
-4. SPECS/ Contains the spec files for each package to be built.
-5. SRPMS/ Where the newly created source package files are written.
-
-Before you begin, note the RPM sources directory on your version of
-RHEL. The command "rpmbuild --showrc" will show the configuration
-for each of those directories. Alternatively, the command "rpm --eval
- '%{_topdir}'" shows the current configuration for the top level
-directory and the command "rpm --eval '%{_sourcedir}'" does the same
-for the sources directory. On RHEL 5, the default RPM _topdir is
-/usr/src/redhat and the default RPM sources directory is
-/usr/src/redhat/SOURCES. On RHEL 6, the default _topdir is
-$HOME/rpmbuild and the default RPM sources directory is
-$HOME/rpmbuild/SOURCES.
-
-1. Install build prerequisites:
-
- ```
- yum install gcc make python-devel openssl-devel kernel-devel graphviz \
- kernel-debug-devel autoconf automake rpm-build redhat-rpm-config \
- libtool
- ```
-
-2. If you are building from a distribution tarball, skip to step 3.
- Otherwise, you must be building from an Open vSwitch Git tree.
- Determine what version of Autoconf is installed (e.g. run "autoconf
- --version"). If it is not at least version 2.63, then you have two
- choices:
-
- a. Install Autoconf 2.63 or later, one way or another.
-
- b. Create a distribution tarball on some other machine, by
- running "./boot.sh; ./configure; make dist" in the Git tree.
- You must run this on a machine that has the tools listed in
- [INSTALL.rst] as prerequisites for building from a Git tree.
- Afterward, proceed with the rest of the instructions using
- the distribution tarball.
-
-3. Some versions of the RHEL 6 kernel-devel package contain a broken
- "build" symlink. If you are using such a version, you must fix
- the problem before continuing.
-
- To find out whether you are affected, run:
-
- ```
- cd /lib/modules/<version>
- ls -l build/
- ```
-
- where `<version>` is the version number of the RHEL 6 kernel. (The
- trailing slash in the final command is important. Be sure to include
- it.) If the "ls" command produces a directory listing, your
- kernel-devel package is OK. If it produces a "No such file or
- directory" error, your kernel-devel package is buggy.
-
- If your kernel-devel package is buggy, then you can fix it with:
-
- ```
- cd /lib/modules/<version>
- rm build
- ln -s /usr/src/kernels/<target> build
- ```
-
- where `<target>` is the name of an existing directory under
- /usr/src/kernels, whose name should be similar to `<version>` but may
- contain some extra parts. Once you have done this, verify the fix with
- the same procedure you used above to check for the problem.
-
-4. If you are building from a distribution tarball, skip to step 5.
- Otherwise, create a distribution tarball from the root of the Git
- tree by running:
-
- ```
- ./boot.sh
- ./configure
- make dist
- ```
-
-5. Now you have a distribution tarball, named something like
- openvswitch-x.y.z.tar.gz. Copy this file into the RPM sources
- directory, e.g.:
-
- `cp openvswitch-x.y.z.tar.gz $HOME/rpmbuild/SOURCES`
-
-6. Make another copy of the distribution tarball in a temporary
- directory. Then unpack the tarball and "cd" into its root, e.g.:
-
- ```
- tar xzf openvswitch-x.y.z.tar.gz
- cd openvswitch-x.y.z
- ```
-
-7. To build Open vSwitch userspace, run:
-
- `rpmbuild -bb rhel/openvswitch.spec`
-
- This produces two RPMs: "openvswitch" and "openvswitch-debuginfo".
-
- The above command automatically runs the Open vSwitch unit tests.
- To disable the unit tests, run:
-
- `rpmbuild -bb --without check rhel/openvswitch.spec`
-
- If the build fails with "configure: error: source dir
- /lib/modules/2.6.32-279.el6.x86_64/build doesn't exist" or similar,
- then the kernel-devel package is missing or buggy. Go back to step
- 1 or 2 and fix the problem.
-
-8. On RHEL 6, to build the Open vSwitch kernel module, copy
- rhel/openvswitch-kmod.files into the RPM sources directory and run:
-
- `rpmbuild -bb rhel/openvswitch-kmod-rhel6.spec`
-
- You might have to specify a kernel version and/or variants, e.g.:
-
- ```
- rpmbuild -bb \
- -D "kversion 2.6.32-131.6.1.el6.x86_64" \
- -D "kflavors default debug kdump" \
- rhel/openvswitch-kmod-rhel6.spec
- ```
-
- This produces an "kmod-openvswitch" RPM for each kernel variant, in
- this example: "kmod-openvswitch", "kmod-openvswitch-debug", and
- "kmod-openvswitch-kdump".
-
-A RHEL host has default firewall rules that prevent any Open vSwitch tunnel
-traffic from passing through. If a user configures Open vSwitch tunnels like
-Geneve, GRE, VXLAN, LISP etc., they will either have to manually add iptables
-firewall rules to allow the tunnel traffic or add it through a startup script
-(Please refer to the "enable-protocol" command in the ovs-ctl(8) manpage).
-
-Red Hat Network Scripts Integration
------------------------------------
-
-Simple integration with Red Hat network scripts has been implemented.
-Please read [rhel/README.RHEL.rst] in the source tree or
-/usr/share/doc/openvswitch/README.RHEL.rst in the installed openvswitch
-package for details.
-
-Reporting Bugs
---------------
-
-Please report problems to bugs@openvswitch.org.
-
-[INSTALL.rst]:INSTALL.rst
-[INSTALL.Fedora.rst]:INSTALL.Fedora.rst
-[rhel/README.RHEL.rst]:rhel/README.RHEL.rst
new file mode 100644
@@ -0,0 +1,208 @@
+..
+ Licensed under the Apache License, Version 2.0 (the "License"); you may
+ not use this file except in compliance with the License. You may obtain
+ a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+ WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+ License for the specific language governing permissions and limitations
+ under the License.
+
+ Convention for heading levels in Open vSwitch documentation:
+
+ ======= Heading 0 (reserved for the title in a document)
+ ------- Heading 1
+ ~~~~~~~ Heading 2
+ +++++++ Heading 3
+ ''''''' Heading 4
+
+ Avoid deeper levels because they do not render well.
+
+========================================
+Open vSwitch on Red Hat Enterprise Linux
+========================================
+
+This document describes how to build and install Open vSwitch on a Red Hat
+Enterprise Linux (RHEL) host. If you want to install Open vSwitch on a generic
+Linux host, see the `general installation guide <INSTALL.rst>`__ instead.
+
+We have tested these instructions with RHEL 5.6 and RHEL 6.0.
+
+For RHEL 7.x (or derivatives, such as CentOS 7.x), you should follow the
+instructions in the `Fedora installation guide <INSTALL.Fedora.rst>`__. The
+Fedora spec files are used for RHEL 7.x.
+
+Prerequisites
+-------------
+
+You may build from an Open vSwitch distribution tarball or from an Open vSwitch
+Git tree.
+
+The default RPM build directory, ``_topdir``, has five directories in the
+top-level.
+
+BUILD/
+ where the software is unpacked and built
+RPMS/
+ where the newly created binary package files are written
+SOURCES/
+ contains the original sources, patches, and icon files
+SPECS/
+ contains the spec files for each package to be built
+SRPMS/
+ where the newly created source package files are written
+
+Before you begin, note the RPM sources directory on your version of RHEL. The
+command ``rpmbuild --showrc`` will show the configuration for each of those
+directories. Alternatively, the command ``rpm --eval '%{_topdir}'`` shows the
+current configuration for the top level directory and the command ``rpm --eval
+'%{_sourcedir}'`` does the same for the sources directory. On RHEL 5, the
+default RPM ``_topdir`` is ``/usr/src/redhat`` and the default RPM sources
+directory is ``/usr/src/redhat/SOURCES``. On RHEL 6, the default ``_topdir`` is
+``$HOME/rpmbuild`` and the default RPM sources directory is
+``$HOME/rpmbuild/SOURCES``.
+
+Build Requirements
+------------------
+
+To compile the RPMs, you will need to install the packages described in the
+`general installation guide <INSTALL.rst>`__ along with some additional
+packages. These can be installed with the below command::
+
+ $ yum install gcc make python-devel openssl-devel kernel-devel graphviz \
+ kernel-debug-devel autoconf automake rpm-build redhat-rpm-config \
+ libtool
+
+Bootstrapping and Configuring
+-----------------------------
+
+If you are building from a distribution tarball, skip to *Building*. If not,
+you must be building from an Open vSwitch Git tree. Determine what version of
+Autoconf is installed (e.g. run ``autoconf --version``). If it is not at least
+version 2.63, then you must upgrade or use another machine to build the
+packages.
+
+Assuming all requirements have been met, build the tarball by running::
+
+ $ ./boot.sh
+ $ ./configure
+ $ make dist
+
+You must run this on a machine that has the tools listed in the `general
+installation guide <INSTALL.rst>`__ as prerequisites for building from a Git
+tree. Afterward, proceed with the rest of the instructions using the
+distribution tarball.
+
+Now you have a distribution tarball, named something like
+``openvswitch-x.y.z.tar.gz``. Copy this file into the RPM sources directory,
+e.g.::
+
+ $ cp openvswitch-x.y.z.tar.gz $HOME/rpmbuild/SOURCES
+
+Broken ``build`` symlink
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+Some versions of the RHEL 6 kernel-devel package contain a broken ``build``
+symlink. If you are using such a version, you must fix the problem before
+continuing.
+
+To find out whether you are affected, run::
+
+ $ cd /lib/modules/<version>
+ $ ls -l build/
+
+where ``<version>`` is the version number of the RHEL 6 kernel.
+
+.. note::
+ The trailing slash in the final command is important. Be sure to include
+ it.
+
+If the ``ls`` command produces a directory listing, your kernel-devel package
+is OK. If it produces a ``No such file or directory`` error, your kernel-devel
+package is buggy.
+
+If your kernel-devel package is buggy, then you can fix it with::
+
+ $ cd /lib/modules/<version>
+ $ rm build
+ $ ln -s /usr/src/kernels/<target> build
+
+where ``<target>`` is the name of an existing directory under
+``/usr/src/kernels``, whose name should be similar to ``<version>`` but may
+contain some extra parts. Once you have done this, verify the fix with the
+same procedure you used above to check for the problem.
+
+Building
+--------
+
+You should have a distribution tarball named something like
+openvswitch-x.y.z.tar.gz. Copy this file into the RPM sources directory::
+
+ $ cp openvswitch-x.y.z.tar.gz $HOME/rpmbuild/SOURCES
+
+Make another copy of the distribution tarball in a temporary directory. Then
+unpack the tarball and ``cd`` into its root::
+
+ $ tar xzf openvswitch-x.y.z.tar.gz
+ $ cd openvswitch-x.y.z
+
+Userspace
+~~~~~~~~~
+
+To build Open vSwitch userspace, run::
+
+ $ rpmbuild -bb rhel/openvswitch.spec
+
+This produces two RPMs: "openvswitch" and "openvswitch-debuginfo".
+
+The above command automatically runs the Open vSwitch unit tests. To disable
+the unit tests, run::
+
+ $ rpmbuild -bb --without check rhel/openvswitch.spec
+
+.. note::
+ If the build fails with ``configure: error: source dir
+ /lib/modules/2.6.32-279.el6.x86_64/build doesn't exist`` or similar, then
+ the kernel-devel package is missing or buggy.
+
+Kernel Module
+~~~~~~~~~~~~~
+
+On RHEL 6, to build the Open vSwitch kernel module, copy
+rhel/openvswitch-kmod.files into the RPM sources directory and run::
+
+ $ rpmbuild -bb rhel/openvswitch-kmod-rhel6.spec
+
+You might have to specify a kernel version and/or variants, e.g.:
+
+ $ rpmbuild -bb \
+ -D "kversion 2.6.32-131.6.1.el6.x86_64" \
+ -D "kflavors default debug kdump" \
+ rhel/openvswitch-kmod-rhel6.spec
+
+This produces an "kmod-openvswitch" RPM for each kernel variant, in this
+example: "kmod-openvswitch", "kmod-openvswitch-debug", and
+"kmod-openvswitch-kdump".
+
+Red Hat Network Scripts Integration
+-----------------------------------
+
+A RHEL host has default firewall rules that prevent any Open vSwitch tunnel
+traffic from passing through. If a user configures Open vSwitch tunnels like
+Geneve, GRE, VXLAN, LISP etc., they will either have to manually add iptables
+firewall rules to allow the tunnel traffic or add it through a startup script
+Refer to the "enable-protocol" command in the ovs-ctl(8) manpage for more
+information.
+
+In addition, simple integration with Red Hat network scripts has been
+implemented. Refer to `README.RHEL.rst <rhel/README.RHEL.rst>`__ in the source
+tree or /usr/share/doc/openvswitch/README.RHEL.rst in the installed openvswitch
+package for details.
+
+Reporting Bugs
+--------------
+
+Report problems to bugs@openvswitch.org.
@@ -31,7 +31,7 @@ platform, refer to one of these installation guides:
- `Debian <INSTALL.Debian.rst>`__
- `Fedora <INSTALL.Fedora.rst>`__
-- `RHEL <INSTALL.RHEL.md>`__
+- `RHEL <INSTALL.RHEL.rst>`__
- `XenServer <INSTALL.XenServer.rst>`__
- `NetBSD <INSTALL.NetBSD.rst>`__
- `Windows <INSTALL.Windows.rst>`__
@@ -80,7 +80,7 @@ docs = \
INSTALL.KVM.rst \
INSTALL.Libvirt.rst \
INSTALL.NetBSD.rst \
- INSTALL.RHEL.md \
+ INSTALL.RHEL.rst \
INSTALL.SELinux.md \
INSTALL.SSL.rst \
INSTALL.XenServer.rst \
@@ -79,7 +79,7 @@ specific platform, please see one of the below installation guides:
- `Debian <INSTALL.Debian.rst>`__
- `Fedora <INSTALL.Fedora.rst>`__
-- `RHEL <INSTALL.RHEL.md>`__
+- `RHEL <INSTALL.RHEL.rst>`__
- `XenServer <INSTALL.XenServer.rst>`__
- `Windows <INSTALL.Windows.rst>`__
Signed-off-by: Stephen Finucane <stephen@that.guru> --- INSTALL.Docker.rst | 2 +- INSTALL.RHEL.md | 171 ------------------------------------------- INSTALL.RHEL.rst | 208 +++++++++++++++++++++++++++++++++++++++++++++++++++++ INSTALL.rst | 2 +- Makefile.am | 2 +- README.rst | 2 +- 6 files changed, 212 insertions(+), 175 deletions(-) delete mode 100644 INSTALL.RHEL.md create mode 100644 INSTALL.RHEL.rst