doc/Building_FRR_on_Ubuntu1404.md

   1 Building FRR on Ubuntu 14.04LTS from Git Source
   2 ===============================================
   3
   4 - MPLS is not supported on `Ubuntu 14.04` with default kernel. MPLS requires
   5   Linux Kernel 4.5 or higher (LDP can be built, but may have limited use
   6   without MPLS)
   7   For an updated Ubuntu Kernel, see http://kernel.ubuntu.com/~kernel-ppa/mainline/
   8
   9 Install required packages
  10 -------------------------
  11
  12 Add packages:
  13
  14     apt-get install git autoconf automake libtool make gawk libreadline-dev \
  15        texinfo dejagnu pkg-config libpam0g-dev libjson-c-dev bison flex \
  16        python-pytest libc-ares-dev python3-dev
  17
  18 Get FRR, compile it and install it (from Git)
  19 ---------------------------------------------
  20
  21 **This assumes you want to build and install FRR from source and not using
  22 any packages**
  23
  24 ### Add frr groups and user
  25
  26     sudo groupadd -g 92 frr
  27     sudo groupadd -r -g 85 frrvty
  28     sudo adduser --system --ingroup frr --home /var/run/frr/ \
  29        --gecos "FRR suite" --shell /sbin/nologin frr
  30     sudo usermod -a -G frrvty frr
  31
  32 ### Download Source, configure and compile it
  33 (You may prefer different options on configure statement. These are just
  34 an example.)
  35
  36     git clone https://github.com/frrouting/frr.git frr
  37     cd frr
  38     ./bootstrap.sh
  39     ./configure \
  40         --prefix=/usr \
  41         --enable-exampledir=/usr/share/doc/frr/examples/ \
  42         --localstatedir=/var/run/frr \
  43         --sbindir=/usr/lib/frr \
  44         --sysconfdir=/etc/frr \
  45         --enable-pimd \
  46         --enable-watchfrr \
  47         --enable-ospfclient=yes \
  48         --enable-ospfapi=yes \
  49         --enable-multipath=64 \
  50         --enable-user=frr \
  51         --enable-group=frr \
  52         --enable-vty-group=frrvty \
  53         --enable-configfile-mask=0640 \
  54         --enable-logfile-mask=0640 \
  55         --enable-rtadv \
  56         --enable-fpm \
  57         --enable-ldpd \
  58         --with-pkg-git-version \
  59         --with-pkg-extra-version=-MyOwnFRRVersion
  60     make
  61     make check
  62     sudo make install
  63
  64 ### Create empty FRR configuration files
  65
  66     sudo install -m 755 -o frr -g frr -d /var/log/frr
  67     sudo install -m 775 -o frr -g frrvty -d /etc/frr
  68     sudo install -m 640 -o frr -g frr /dev/null /etc/frr/zebra.conf
  69     sudo install -m 640 -o frr -g frr /dev/null /etc/frr/bgpd.conf
  70     sudo install -m 640 -o frr -g frr /dev/null /etc/frr/ospfd.conf
  71     sudo install -m 640 -o frr -g frr /dev/null /etc/frr/ospf6d.conf
  72     sudo install -m 640 -o frr -g frr /dev/null /etc/frr/isisd.conf
  73     sudo install -m 640 -o frr -g frr /dev/null /etc/frr/ripd.conf
  74     sudo install -m 640 -o frr -g frr /dev/null /etc/frr/ripngd.conf
  75     sudo install -m 640 -o frr -g frr /dev/null /etc/frr/pimd.conf
  76     sudo install -m 640 -o frr -g frr /dev/null /etc/frr/ldpd.conf
  77     sudo install -m 640 -o frr -g frr /dev/null /etc/frr/nhrpd.conf
  78     sudo install -m 640 -o frr -g frrvty /dev/null /etc/frr/vtysh.conf
  79
  80 ### Enable IP & IPv6 forwarding
  81
  82 Edit `/etc/sysctl.conf` and uncomment the following values (ignore the
  83 other settings)
  84
  85     # Uncomment the next line to enable packet forwarding for IPv4
  86     net.ipv4.ip_forward=1
  87
  88     # Uncomment the next line to enable packet forwarding for IPv6
  89     #  Enabling this option disables Stateless Address Autoconfiguration
  90     #  based on Router Advertisements for this host
  91     net.ipv6.conf.all.forwarding=1
  92
  93 **Reboot** or use `sysctl -p` to apply the same config to the running system
  94 ### Install the init.d service
  95
  96     sudo install -m 755 tools/frr /etc/init.d/frr
  97     sudo install -m 644 tools/etc/frr/daemons /etc/frr/daemons
  98     sudo install -m 644 tools/etc/frr/daemons.conf /etc/frr/daemons.conf
  99     sudo install -m 644 -o frr -g frr tools/etc/frr/vtysh.conf /etc/frr/vtysh.conf
 100
 101
 102 ### Enable daemons
 103
 104 Edit `/etc/frr/daemons` and change the value from "no" to "yes" for those daemons you want to start by systemd.
 105 For example.
 106
 107     zebra=yes
 108     bgpd=yes
 109     ospfd=yes
 110     ospf6d=yes
 111     ripd=yes
 112     ripngd=yes
 113     isisd=yes
 114
 115 ### Start the init.d service
 116 - /etc/init.d/frr start
 117 - use `/etc/init.d/frr status` to check its status.
 118
 119