proxmox-mirrors/mirror_frr
1
0
Fork 0
mirror of https://git.proxmox.com/git/mirror_frr synced 2025-08-07 17:18:56 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

doc: update Fedora 24 build doc style

Browse Source 
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
1 changed files with 106 additions and 117 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

97
doc/developer/building-frr-for-fedora24.rst
View File

@ -1,46 +1,31 @@
Fedora 24 Fedora 24
========================================= =========
This document describes installation from source. If you want to build an RPM, This document describes installation from source. If you want to build an RPM,
see :ref:`packaging-redhat`. see :ref:`packaging-redhat`.
Install required packages Installing Dependencies
------------------------- -----------------------
Add packages: .. code-block:: console
::
sudo dnf install git autoconf automake libtool make gawk \ sudo dnf install git autoconf automake libtool make gawk \
readline-devel texinfo net-snmp-devel groff pkgconfig \ readline-devel texinfo net-snmp-devel groff pkgconfig json-c-devel \
json-c-devel pam-devel pytest bison flex c-ares-devel \ pam-devel pytest bison flex c-ares-devel python3-devel python3-sphinx
python3-devel python3-sphinx
.. include:: building-libyang.rst .. 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 Compilation
using any packages** ^^^^^^^^^^^
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.
:: .. 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
Download Source, configure and compile it
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
(You may prefer different options on configure statement. These are just
an example.)
::
git clone https://github.com/frrouting/frr.git frr git clone https://github.com/frrouting/frr.git frr
cd frr cd frr
@ -63,13 +48,23 @@ an example.)
--with-pkg-git-version \ --with-pkg-git-version \
--with-pkg-extra-version=-MyOwnFRRVersion --with-pkg-extra-version=-MyOwnFRRVersion
make make
make check
sudo make install 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 Create empty FRR configuration files
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
:: .. code-block:: console
sudo mkdir /var/log/frr sudo mkdir /var/log/frr
sudo mkdir /etc/frr sudo mkdir /etc/frr
@ -93,25 +88,25 @@ Create empty FRR configuration files
Install daemon config file Install daemon config file
^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^
:: .. code-block:: console
sudo install -p -m 644 redhat/daemons /etc/frr/ sudo install -p -m 644 redhat/daemons /etc/frr/
sudo chown frr:frr /etc/frr/daemons 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. 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) Enable IP & IPv6 forwarding (and MPLS)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create a new file ``/etc/sysctl.d/90-routing-sysctl.conf`` with the Create a new file ``/etc/sysctl.d/90-routing-sysctl.conf`` with the following
following content: (Please make sure to list all interfaces with content (please make sure to list all interfaces with required MPLS similar to
required MPLS similar to ``net.mpls.conf.eth0.input=1``) ``net.mpls.conf.eth0.input=1``):
:: .. code-block:: console
# Sysctl for routing # 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: Load the modified sysctl's on the system:
:: .. code-block:: console
sudo sysctl -p /etc/sysctl.d/90-routing-sysctl.conf sudo sysctl -p /etc/sysctl.d/90-routing-sysctl.conf
Create a new file ``/etc/modules-load.d/mpls.conf`` with the following Create a new file ``/etc/modules-load.d/mpls.conf`` with the following
content: content:
:: .. code-block:: console
# Load MPLS Kernel Modules # Load MPLS Kernel Modules
mpls-router mpls-router
@ -142,28 +137,22 @@ content:
And load the kernel modules on the running system: And load the kernel modules on the running system:
:: .. code-block:: console
sudo modprobe mpls-router mpls-iptunnel 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 644 redhat/frr.service /usr/lib/systemd/system/frr.service
sudo install -p -m 755 redhat/frr.init /usr/lib/frr/frr sudo install -p -m 755 redhat/frr.init /usr/lib/frr/frr
Enable required frr at startup
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
::
sudo systemctl enable frr sudo systemctl enable frr
Reboot or start FRR manually Start FRR
^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^
:: .. code-block:: frr
sudo systemctl start frr sudo systemctl start frr