summaryrefslogtreecommitdiffstats
path: root/doc/developer/building-frr-for-openwrt.rst
blob: 8f72ab5d9dcf43d7ea2cef1f3237427248d73e45 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
OpenWRT
=======

Prepare build environment
-------------------------

For Debian based distributions, run:

::

    sudo apt-get install git build-essential libssl-dev libncurses5-dev \
       unzip gawk zlib1g-dev subversion mercurial

For other environments, instructions can be found in the
`official documentation
<https://wiki.openwrt.org/doc/howto/buildroot.exigence#examples_of_package_installations>`_.


Get OpenWRT Sources (from Git)
------------------------------

.. note::
   The OpenWRT build will fail if you run it as root. So take care to run it as a nonprivileged user.

Clone the OpenWRT sources and retrieve the package feeds

::

    git clone https://github.com/openwrt/openwrt.git
    cd openwrt
    ./scripts/feeds update -a
    ./scripts/feeds install -a
    cd feeds/routing
    git fetch origin pull/319/head
    git read-tree --prefix=frr/ -u FETCH_HEAD:frr
    cd ../../package/feeds/routing/
    ln -sv ../../../feeds/routing/frr .
    cd ../../..

Configure OpenWRT for your target and select the needed FRR packages in Network -> Routing and Redirection -> frr,
exit and save

::

    make menuconfig

Then, to compile either a complete OpenWRT image, or the FRR packages, run:

::

    make or make package/frr/compile

It may be possible that on first build ``make package/frr/compile`` not
to work and it may be needed to run a ``make`` for the entire build
environment. Add ``V=s`` to get more debugging output.

Work with sources
-----------------

To update to a newer version, or change other options, you need to edit the ``feeds/routing/frr/Makefile``.

Usage
-----

Edit ``/usr/sbin/frr.init`` and add/remove the daemons name in section
``DAEMONS=`` or don't install unneeded packages For example: zebra bgpd ldpd
isisd nhrpd ospfd ospf6d pimd ripd ripngd

Enable the service
^^^^^^^^^^^^^^^^^^

-  ``service frr enable``

Start the service
^^^^^^^^^^^^^^^^^

-  ``service frr start``