doc/developer/building-frr-for-centos6.rst

   1 .. _building-centos6:
   2
   3 CentOS 6
   4 ========================================
   5
   6 This document describes installation from source. If you want to build an RPM,
   7 see :ref:`packaging-redhat`.
   8
   9 Instructions are tested with ``CentOS 6.8`` on ``x86_64`` platform
  10
  11 Warning:
  12 --------
  13 ``CentOS 6`` is very old and not fully supported by the FRR community
  14 anymore. Building FRR takes multiple manual steps to update the build
  15 system with newer packages than what's available from the archives.
  16 However, the built packages can still be installed afterwards on
  17 a standard ``CentOS 6`` without any special packages.
  18
  19 Support for CentOS 6 is now on a best-effort base by the community.
  20
  21 CentOS 6 restrictions:
  22 ----------------------
  23
  24 -  PIMd is not supported on ``CentOS 6``. Upgrade to ``CentOS 7`` if
  25    PIMd is needed
  26 -  MPLS is not supported on ``CentOS 6``. MPLS requires Linux Kernel 4.5
  27    or higher (LDP can be built, but may have limited use without MPLS)
  28 -  Zebra is unable to detect what bridge/vrf an interface is associated
  29    with (IFLA\_INFO\_SLAVE\_KIND does not exist in the kernel headers,
  30    you can use a newer kernel + headers to get this functionality)
  31 -  frr\_reload.py will not work, as this requires Python 2.7, and CentOS
  32    6 only has 2.6. You can install Python 2.7 via IUS, but it won't work
  33    properly unless you compile and install the ipaddr package for it.
  34 -  Building the package requires Sphinx >= 1.1. Only a non-standard
  35    package provides a newer sphinx and requires manual installation
  36    (see below)
  37
  38
  39 Install required packages
  40 -------------------------
  41
  42 Add packages:
  43
  44 .. code-block:: shell
  45
  46    sudo yum install git autoconf automake libtool make \
  47       readline-devel texinfo net-snmp-devel groff pkgconfig \
  48       json-c-devel pam-devel flex epel-release c-ares-devel libcap-devel
  49
  50 Install newer version of bison (CentOS 6 package source is too old) from CentOS
  51 7:
  52
  53 .. code-block:: shell
  54
  55    sudo yum install rpm-build
  56    curl -O http://vault.centos.org/7.0.1406/os/Source/SPackages/bison-2.7-4.el7.src.rpm
  57    rpmbuild --rebuild ./bison-2.7-4.el7.src.rpm
  58    sudo yum install ./rpmbuild/RPMS/x86_64/bison-2.7-4.el6.x86_64.rpm
  59    rm -rf rpmbuild
  60
  61 Install newer version of autoconf and automake (Package versions are too old):
  62
  63 .. code-block:: shell
  64
  65    curl -O http://ftp.gnu.org/gnu/autoconf/autoconf-2.69.tar.gz
  66    tar xvf autoconf-2.69.tar.gz
  67    cd autoconf-2.69
  68    ./configure --prefix=/usr
  69    make
  70    sudo make install
  71    cd ..
  72
  73    curl -O http://ftp.gnu.org/gnu/automake/automake-1.15.tar.gz
  74    tar xvf automake-1.15.tar.gz
  75    cd automake-1.15
  76    ./configure --prefix=/usr
  77    make
  78    sudo make install
  79    cd ..
  80
  81 Install ``Python 2.7`` in parallel to default 2.6. Make sure you've install
  82 EPEL (``epel-release`` as above). Then install current ``python27``:
  83 ``python27-devel`` and ``pytest``
  84
  85 .. code-block:: shell
  86
  87    sudo rpm -ivh http://dl.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm
  88    sudo rpm -ivh https://centos6.iuscommunity.org/ius-release.rpm
  89    sudo yum install python27 python27-pip python27-devel
  90    sudo pip2.7 install pytest
  91
  92 Please note that ``CentOS 6`` needs to keep python pointing to version 2.6 for
  93 ``yum`` to keep working, so don't create a symlink for python2.7 to python.
  94
  95 Install newer ``Sphinx-Build`` based on ``Python 2.7``.
  96
  97 Create a new repo ``/etc/yum.repos.d/puias6.repo`` with the following contents:
  98
  99 ::
 100
 101    ### Name: RPM Repository for RHEL 6 - PUIAS (used for Sphinx-Build)
 102    ### URL: http://springdale.math.ias.edu/data/puias/computational
 103    [puias-computational]
 104    name = RPM Repository for RHEL 6 - Sphinx-Build
 105    baseurl = http://springdale.math.ias.edu/data/puias/computational/$releasever/$basearch
 106    #mirrorlist =
 107    enabled = 1
 108    protect = 0
 109    gpgkey =
 110    gpgcheck = 0
 111
 112 Update rpm database & Install newer sphinx
 113
 114 .. code-block:: shell
 115
 116    sudo yum update
 117    sudo yum install python27-sphinx
 118
 119 .. include:: building-libyang.rst
 120
 121 Get FRR, compile it and install it (from Git)
 122 ---------------------------------------------
 123
 124 **This assumes you want to build and install FRR from source and not using any
 125 packages**
 126
 127 Add frr groups and user
 128 ^^^^^^^^^^^^^^^^^^^^^^^
 129
 130 .. code-block:: shell
 131
 132    sudo groupadd -g 92 frr
 133    sudo groupadd -r -g 85 frrvty
 134    sudo useradd -u 92 -g 92 -M -r -G frrvty -s /sbin/nologin \
 135       -c "FRR FRRouting suite" -d /var/run/frr frr
 136
 137 Download Source, configure and compile it
 138 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 139
 140 (You may prefer different options on configure statement. These are just
 141 an example.)
 142
 143 .. code-block:: shell
 144
 145     git clone https://github.com/frrouting/frr.git frr
 146     cd frr
 147     ./bootstrap.sh
 148     ./configure \
 149         --bindir=/usr/bin \
 150         --sbindir=/usr/lib/frr \
 151         --sysconfdir=/etc/frr \
 152         --libdir=/usr/lib/frr \
 153         --libexecdir=/usr/lib/frr \
 154         --localstatedir=/var/run/frr \
 155         --with-moduledir=/usr/lib/frr/modules \
 156         --disable-pimd \
 157         --enable-snmp=agentx \
 158         --enable-multipath=64 \
 159         --enable-user=frr \
 160         --enable-group=frr \
 161         --enable-vty-group=frrvty \
 162         --disable-exampledir \
 163         --disable-ldpd \
 164         --enable-fpm \
 165         --with-pkg-git-version \
 166         --with-pkg-extra-version=-MyOwnFRRVersion
 167     make
 168     make check
 169     sudo make install
 170
 171 Create empty FRR configuration files
 172 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 173
 174 .. code-block:: shell
 175
 176    sudo mkdir /var/log/frr
 177    sudo mkdir /etc/frr
 178
 179 For integrated config file:
 180
 181 .. code-block:: shell
 182
 183    sudo touch /etc/frr/frr.conf
 184
 185 For individual config files:
 186
 187 .. note:: Integrated config is preferred to individual config.
 188
 189 .. code-block:: shell
 190
 191    sudo touch /etc/frr/babeld.conf
 192    sudo touch /etc/frr/bfdd.conf
 193    sudo touch /etc/frr/bgpd.conf
 194    sudo touch /etc/frr/eigrpd.conf
 195    sudo touch /etc/frr/isisd.conf
 196    sudo touch /etc/frr/ldpd.conf
 197    sudo touch /etc/frr/nhrpd.conf
 198    sudo touch /etc/frr/ospf6d.conf
 199    sudo touch /etc/frr/ospfd.conf
 200    sudo touch /etc/frr/pbrd.conf
 201    sudo touch /etc/frr/pimd.conf
 202    sudo touch /etc/frr/ripd.conf
 203    sudo touch /etc/frr/ripngd.conf
 204    sudo touch /etc/frr/staticd.conf
 205    sudo touch /etc/frr/zebra.conf
 206    sudo chown -R frr:frr /etc/frr/
 207    sudo touch /etc/frr/vtysh.conf
 208    sudo chown frr:frrvty /etc/frr/vtysh.conf
 209    sudo chmod 640 /etc/frr/*.conf
 210
 211 Install daemon config file
 212 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 213
 214 .. code-block:: shell
 215
 216    sudo install -p -m 644 tools/etc/frr/daemons /etc/frr/
 217    sudo chown frr:frr /etc/frr/daemons
 218
 219 Edit /etc/frr/daemons as needed to select the required daemons
 220 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 221
 222 Look for the section with ``watchfrr_enable=...`` and ``zebra=...`` etc.
 223 Enable the daemons as required by changing the value to ``yes``
 224
 225 Enable IP & IPv6 forwarding
 226 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 227
 228 Edit :file:`/etc/sysctl.conf` and set the following values (ignore the other
 229 settings)::
 230
 231    # Controls IP packet forwarding
 232    net.ipv4.ip_forward = 1
 233    net.ipv6.conf.all.forwarding=1
 234
 235    # Controls source route verification
 236    net.ipv4.conf.default.rp_filter = 0
 237
 238 Load the modified sysctl's on the system:
 239
 240 .. code-block:: shell
 241
 242    sudo sysctl -p /etc/sysctl.d/90-routing-sysctl.conf
 243
 244 Add init.d startup file
 245 ^^^^^^^^^^^^^^^^^^^^^^^
 246
 247 .. code-block:: shell
 248
 249    sudo install -p -m 755 tools/frr /etc/init.d/frr
 250    sudo chkconfig --add frr
 251
 252 Enable FRR daemon at startup
 253 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 254
 255 .. code-block:: shell
 256
 257    sudo chkconfig frr on
 258
 259 Start FRR manually (or reboot)
 260 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 261
 262 .. code-block:: shell
 263
 264    sudo /etc/init.d/frr start