summaryrefslogtreecommitdiff
path: root/doc/developer/building-libyang.rst
blob: 5f82447d744a14788111ce7d6803058d9a9068fb (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
FRR depends on the relatively new ``libyang`` library to provide YANG/NETCONF
support. Unfortunately, most distributions do not yet offer a ``libyang``
package from their repositories. Therefore we offer two options to install this
library.

**Option 1: Binary Install**

The FRR project builds some binary ``libyang`` packages.

RPM packages are at our `RPM repository <https://rpm.frrouting.org>`_.

DEB packages are available as CI artifacts `here
<https://ci1.netdef.org/browse/LIBYANG-LY1REL-DEB10AMD64-4/artifact>`_.

.. warning::

   ``libyang`` version 1.0.184 or newer is required to build FRR.

.. note::

   The ``libyang`` development packages need to be installed in addition to the
   libyang core package in order to build FRR successfully. Make sure to
   download and install those from the link above alongside the binary
   packages.

   Depending on your platform, you may also need to install the PCRE
   development package. Typically this is ``libpcre-dev`` or ``pcre-devel``.

.. note::

   For Debian-based systems, the official ``libyang`` package requires recent
   versions of ``swig`` (3.0.12) and ``debhelper`` (11) which are only
   available in Debian buster (10).  However, ``libyang`` packages built on
   Debian buster can be installed on both Debian jessie (8) and Debian stretch
   (9), as well as various Ubuntu systems.  The ``python3-yang`` package will
   not work, but the other packages (``libyang-dev`` is the one needed for FRR)
   will.

**Option 2: Source Install**

.. note::

   Ensure that the `libyang build requirements
   <https://github.com/CESNET/libyang/blob/master/README.md#build-requirements>`_
   are met before continuing. Usually this entails installing ``cmake`` and
   ``libpcre-dev`` or ``pcre-devel``.

.. code-block:: console

   git clone https://github.com/CESNET/libyang.git
   cd libyang
   mkdir build; cd build
   cmake -DENABLE_LYD_PRIV=ON -DCMAKE_INSTALL_PREFIX:PATH=/usr \
         -D CMAKE_BUILD_TYPE:String="Release" ..
   make
   sudo make install