doc: update Fedora 24 build doc style

Signed-off-by: Quentin Young <qlyoung@cumulusnetworks.com>
This commit is contained in:
Quentin Young 2019-03-22 16:19:22 +00:00
parent 749d7a8bcd
commit 63374e1d8b

View File

@ -1,46 +1,31 @@
Fedora 24
=========================================
=========
This document describes installation from source. If you want to build an RPM,
see :ref:`packaging-redhat`.
Install required packages
-------------------------
Installing Dependencies
-----------------------
Add packages:
::
.. code-block:: console
sudo dnf install git autoconf automake libtool make gawk \
readline-devel texinfo net-snmp-devel groff pkgconfig \
json-c-devel pam-devel pytest bison flex c-ares-devel \
python3-devel python3-sphinx
readline-devel texinfo net-snmp-devel groff pkgconfig json-c-devel \
pam-devel pytest bison flex c-ares-devel python3-devel python3-sphinx
.. include:: building-libyang.rst
Get FRR, compile it and install it (from Git)
---------------------------------------------
Building & Installing FRR
-------------------------
**This assumes you want to build and install FRR from source and not
using any packages**
Compilation
^^^^^^^^^^^
Add frr groups and user
^^^^^^^^^^^^^^^^^^^^^^^
Clone the FRR git repo and use the included ``configure`` script to configure
FRR's build time options to your liking. The full option listing can be
obtained by running ``./configure -h``. The options shown below are examples.
::
sudo groupadd -g 92 frr
sudo groupadd -r -g 85 frrvty
sudo useradd -u 92 -g 92 -M -r -G frrvty -s /sbin/nologin \
-c "FRR FRRouting suite" -d /var/run/frr frr
Download Source, configure and compile it
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
(You may prefer different options on configure statement. These are just
an example.)
::
.. code-block:: console
git clone https://github.com/frrouting/frr.git frr
cd frr
@ -63,13 +48,23 @@ an example.)
--with-pkg-git-version \
--with-pkg-extra-version=-MyOwnFRRVersion
make
make check
sudo make install
Add FRR groups and user
^^^^^^^^^^^^^^^^^^^^^^^
.. code-block:: console
sudo groupadd -g 92 frr
sudo groupadd -r -g 85 frrvty
sudo useradd -u 92 -g 92 -M -r -G frrvty -s /sbin/nologin \
-c "FRR FRRouting suite" -d /var/run/frr frr
Create empty FRR configuration files
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
::
.. code-block:: console
sudo mkdir /var/log/frr
sudo mkdir /etc/frr
@ -93,25 +88,25 @@ Create empty FRR configuration files
Install daemon config file
^^^^^^^^^^^^^^^^^^^^^^^^^^
::
.. code-block:: console
sudo install -p -m 644 redhat/daemons /etc/frr/
sudo chown frr:frr /etc/frr/daemons
Edit /etc/frr/daemons as needed to select the required daemons
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Edit /etc/frr/daemons
^^^^^^^^^^^^^^^^^^^^^
Look for the section with ``watchfrr_enable=...`` and ``zebra=...`` etc.
Enable the daemons as required by changing the value to ``yes``
Enable the daemons as required by changing the value to ``yes``.
Enable IP & IPv6 forwarding (and MPLS)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create a new file ``/etc/sysctl.d/90-routing-sysctl.conf`` with the
following content: (Please make sure to list all interfaces with
required MPLS similar to ``net.mpls.conf.eth0.input=1``)
Create a new file ``/etc/sysctl.d/90-routing-sysctl.conf`` with the following
content (please make sure to list all interfaces with required MPLS similar to
``net.mpls.conf.eth0.input=1``):
::
.. code-block:: console
# Sysctl for routing
#
@ -127,14 +122,14 @@ required MPLS similar to ``net.mpls.conf.eth0.input=1``)
Load the modified sysctl's on the system:
::
.. code-block:: console
sudo sysctl -p /etc/sysctl.d/90-routing-sysctl.conf
Create a new file ``/etc/modules-load.d/mpls.conf`` with the following
content:
::
.. code-block:: console
# Load MPLS Kernel Modules
mpls-router
@ -142,28 +137,22 @@ content:
And load the kernel modules on the running system:
::
.. code-block:: console
sudo modprobe mpls-router mpls-iptunnel
Install frr Service and redhat init files
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Install system service files
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
::
.. code-block:: console
sudo install -p -m 644 redhat/frr.service /usr/lib/systemd/system/frr.service
sudo install -p -m 755 redhat/frr.init /usr/lib/frr/frr
Enable required frr at startup
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
::
sudo systemctl enable frr
Reboot or start FRR manually
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Start FRR
^^^^^^^^^
::
.. code-block:: frr
sudo systemctl start frr