proxmox-mirrors/mirror_frr
1
0
Fork 0
mirror of https://git.proxmox.com/git/mirror_frr synced 2025-06-04 22:48:02 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Merge pull request #505 from adamfitz/stable/2.0

Browse Source 
added troubleshooting section to debian 8 build doc
This commit is contained in:
Donald Sharp 2017-05-11 08:20:08 -04:00 committed by GitHub
commit 291012893e
1 changed files with 36 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

41
doc/Building_FRR_on_Debian8.md
View File

@ -4,13 +4,13 @@ Building FRR on Debian 8 from Git Source
Debian 8 restrictions: Debian 8 restrictions:
---------------------- ----------------------
- MPLS is not supported on `Debian 8` with default kernel. MPLS requires - MPLS is not supported on `Debian 8` with default kernel. MPLS requires
Linux Kernel 4.5 or higher (LDP can be built, but may have limited use Linux Kernel 4.5 or higher (LDP can be built, but may have limited use
without MPLS) without MPLS)
Install required packages Install required packages
------------------------- -------------------------
Add packages: Add packages:
sudo apt-get install git autoconf automake libtool make gawk \ sudo apt-get install git autoconf automake libtool make gawk \
@ -24,7 +24,7 @@ Install newer pytest (>3.0) from pip
Get FRR, compile it and install it (from Git) Get FRR, compile it and install it (from Git)
--------------------------------------------- ---------------------------------------------
**This assumes you want to build and install FRR from source and not using **This assumes you want to build and install FRR from source and not using
any packages** any packages**
### Add frr groups and user ### Add frr groups and user
@ -87,7 +87,7 @@ an example.)
### Enable IP & IPv6 forwarding ### Enable IP & IPv6 forwarding
Edit `/etc/sysctl.conf` and uncomment the following values (ignore the Edit `/etc/sysctl.conf` and uncomment the following values (ignore the
other settings) other settings)
# Uncomment the next line to enable packet forwarding for IPv4 # Uncomment the next line to enable packet forwarding for IPv4
@ -99,3 +99,34 @@ other settings)
net.ipv6.conf.all.forwarding=1 net.ipv6.conf.all.forwarding=1
**Reboot** or use `sysctl -p` to apply the same config to the running system **Reboot** or use `sysctl -p` to apply the same config to the running system
### Troubleshooting
**Local state directory**
The local state directory must exist and have the correct permissions applied
for the frrouting daemons to start. In the above ./configure example the
local state directory is set to /var/run/frr (--localstatedir=/var/run/frr)
Debian considers /var/run/frr to be temporary and this is removed after a
reboot.
When using a different local state directory you need to create the new
directory and change the ownership to the frr user, for example:
mkdir /var/opt/frr
chown frr /var/opt/frr
**Shared library error**
If you try and start any of the frrouting daemons you may see the below error
due to the frrouting shared library directory not being found:
./zebra: error while loading shared libraries: libfrr.so.0: cannot open shared object file: No such file or directory
The fix is to add the following line to /etc/ld.so.conf which will continue to
reference the library directory after the system reboots. To load the library
directory path immediately run the ldconfig command after adding the line to
the file eg:
echo include /usr/local/lib >> /etc/ld.so.conf
ldconfig