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

   1 NetBSD 7
   2 ========================================
   3
   4 NetBSD 7 restrictions:
   5 ----------------------
   6
   7 -  MPLS is not supported on ``NetBSD``. MPLS requires a Linux Kernel
   8    (4.5 or higher). LDP can be built, but may have limited use without
   9    MPLS
  10
  11 Install required packages
  12 -------------------------
  13
  14 ::
  15
  16     sudo pkgin install git autoconf automake libtool gmake openssl \
  17        pkg-config json-c python27 py27-test python35 py-sphinx
  18
  19 Install SSL Root Certificates (for git https access):
  20
  21 ::
  22
  23     sudo pkgin install mozilla-rootcerts
  24     sudo touch /etc/openssl/openssl.cnf
  25     sudo mozilla-rootcerts install
  26
  27 Select default Python and py.test
  28
  29 ::
  30
  31     sudo ln -s /usr/pkg/bin/python2.7 /usr/bin/python
  32     sudo ln -s /usr/pkg/bin/py.test-2.7 /usr/bin/py.test
  33
  34 .. include:: building-libyang.rst
  35
  36 Get FRR, compile it and install it (from Git)
  37 ---------------------------------------------
  38
  39 Add frr groups and user
  40 ^^^^^^^^^^^^^^^^^^^^^^^
  41
  42 ::
  43
  44     sudo groupadd -g 92 frr
  45     sudo groupadd -g 93 frrvty
  46     sudo useradd -g 92 -u 92 -G frrvty -c "FRR suite" \
  47         -d /nonexistent -s /sbin/nologin frr
  48
  49 Download Source, configure and compile it
  50 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  51
  52 (You may prefer different options on configure statement. These are just
  53 an example)
  54
  55 ::
  56
  57     git clone https://github.com/frrouting/frr.git frr
  58     cd frr
  59     ./bootstrap.sh
  60     MAKE=gmake
  61     export LDFLAGS="-L/usr/pkg/lib -R/usr/pkg/lib"
  62     export CPPFLAGS="-I/usr/pkg/include"
  63     ./configure \
  64         --sysconfdir=/usr/pkg/etc/frr \
  65         --enable-exampledir=/usr/pkg/share/examples/frr \
  66         --enable-pkgsrcrcdir=/usr/pkg/share/examples/rc.d \
  67         --localstatedir=/var/run/frr \
  68         --enable-multipath=64 \
  69         --enable-user=frr \
  70         --enable-group=frr \
  71         --enable-vty-group=frrvty \
  72         --enable-configfile-mask=0640 \
  73         --enable-logfile-mask=0640 \
  74         --enable-fpm \
  75         --with-pkg-git-version \
  76         --with-pkg-extra-version=-MyOwnFRRVersion
  77     gmake
  78     gmake check
  79     sudo gmake install
  80
  81 Create empty FRR configuration files
  82 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  83
  84 ::
  85
  86     sudo mkdir /usr/pkg/etc/frr
  87     sudo touch /usr/pkg/etc/frr/zebra.conf
  88     sudo touch /usr/pkg/etc/frr/bgpd.conf
  89     sudo touch /usr/pkg/etc/frr/ospfd.conf
  90     sudo touch /usr/pkg/etc/frr/ospf6d.conf
  91     sudo touch /usr/pkg/etc/frr/isisd.conf
  92     sudo touch /usr/pkg/etc/frr/ripd.conf
  93     sudo touch /usr/pkg/etc/frr/ripngd.conf
  94     sudo touch /usr/pkg/etc/frr/pimd.conf
  95     sudo chown -R frr:frr /usr/pkg/etc/frr
  96     sudo touch /usr/local/etc/frr/vtysh.conf
  97     sudo chown frr:frrvty /usr/pkg/etc/frr/*.conf
  98     sudo chmod 640 /usr/pkg/etc/frr/*.conf
  99
 100 Enable IP & IPv6 forwarding
 101 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 102
 103 Add the following lines to the end of ``/etc/sysctl.conf``:
 104
 105 ::
 106
 107     # Routing: We need to forward packets
 108     net.inet.ip.forwarding=1
 109     net.inet6.ip6.forwarding=1
 110
 111 **Reboot** or use ``sysctl`` to apply the same config to the running
 112 system
 113
 114 Install rc.d init files
 115 ^^^^^^^^^^^^^^^^^^^^^^^
 116
 117 ::
 118
 119     cp pkgsrc/*.sh /etc/rc.d/
 120     chmod 555 /etc/rc.d/*.sh
 121
 122 Enable FRR processes
 123 ^^^^^^^^^^^^^^^^^^^^
 124
 125 (Enable the required processes only)
 126
 127 ::
 128
 129     echo "zebra=YES" >> /etc/rc.conf
 130     echo "bgpd=YES" >> /etc/rc.conf
 131     echo "ospfd=YES" >> /etc/rc.conf
 132     echo "ospf6d=YES" >> /etc/rc.conf
 133     echo "isisd=YES" >> /etc/rc.conf
 134     echo "ripngd=YES" >> /etc/rc.conf
 135     echo "ripd=YES" >> /etc/rc.conf
 136     echo "pimd=YES" >> /etc/rc.conf