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

   1 OpenWRT
   2 =======
   3
   4 Prepare build environment
   5 -------------------------
   6
   7 For Debian based distributions, run:
   8
   9 ::
  10
  11     sudo apt-get install git build-essential libssl-dev libncurses5-dev \
  12        unzip zlib1g-dev subversion mercurial
  13
  14 For other environments, instructions can be found in the
  15 `official documentation
  16 <https://wiki.openwrt.org/doc/howto/buildroot.exigence#examples_of_package_installations>`_.
  17
  18
  19 Get OpenWRT Sources (from Git)
  20 ------------------------------
  21
  22 .. note::
  23    The OpenWRT build will fail if you run it as root. So take care to run it as a nonprivileged user.
  24
  25 Clone the OpenWRT sources and retrieve the package feeds
  26
  27 ::
  28
  29     git clone https://github.com/openwrt/openwrt.git
  30     cd openwrt
  31     ./scripts/feeds update -a
  32     ./scripts/feeds install -a
  33     cd feeds/routing
  34     git fetch origin pull/319/head
  35     git read-tree --prefix=frr/ -u FETCH_HEAD:frr
  36     cd ../../package/feeds/routing/
  37     ln -sv ../../../feeds/routing/frr .
  38     cd ../../..
  39
  40 Configure OpenWRT for your target and select the needed FRR packages in Network -> Routing and Redirection -> frr,
  41 exit and save
  42
  43 ::
  44
  45     make menuconfig
  46
  47 Then, to compile either a complete OpenWRT image, or the FRR packages, run:
  48
  49 ::
  50
  51     make or make package/frr/compile
  52
  53 It may be possible that on first build ``make package/frr/compile`` not
  54 to work and it may be needed to run a ``make`` for the entire build
  55 environment. Add ``V=s`` to get more debugging output.
  56
  57 Work with sources
  58 -----------------
  59
  60 To update to a newer version, or change other options, you need to edit the ``feeds/routing/frr/Makefile``.
  61
  62 Usage
  63 -----
  64
  65 Edit ``/usr/sbin/frr.init`` and add/remove the daemons name in section
  66 ``DAEMONS=`` or don't install unneeded packages For example: zebra bgpd ldpd
  67 isisd nhrpd ospfd ospf6d pimd ripd ripngd
  68
  69 Enable the service
  70 ^^^^^^^^^^^^^^^^^^
  71
  72 -  ``service frr enable``
  73
  74 Start the service
  75 ^^^^^^^^^^^^^^^^^
  76
  77 -  ``service frr start``