]> git.ipfire.org Git - thirdparty/kea.git/commitdiff
[#1990] docs about installing libyang and sysrepo
authorAndrei Pavel <andrei@isc.org>
Wed, 28 Jul 2021 08:48:00 +0000 (11:48 +0300)
committerAndrei Pavel <andrei@isc.org>
Thu, 12 Aug 2021 15:33:27 +0000 (18:33 +0300)
doc/sphinx/arm/install.rst
doc/sphinx/arm/netconf.rst

index 79a1654d259e025c6223e115a96570b18debe946..174f9ed50614eaf972346b37ab640d7d8a251b86 100644 (file)
@@ -107,8 +107,10 @@ the system:
    This is specified using the --with-freeradius configuration switch.
 
 -  Sysrepo v1.4.140 and libyang v1.0.240 are needed to connect to a Sysrepo
-   datastore. This is specified using the --with-sysrepo option when running
-   "configure". Earlier versions are no longer supported.
+   datastore. Earlier versions are no longer supported. When compiling from
+   sources, the configure switches that can be used are --with-libyang and
+   --with-sysrepo without any parameters. If these dependencies were installed
+   in custom paths, point the switches to them.
 
 -  googletest (version 1.8 or later) is required when using the --with-gtest
    configuration option to build the unit tests.
index 4436f6ac407dd27d52c220c5762c0e377c7a81cb..90cd347c1087a70fdd83ace50bc05de28e7838e6 100644 (file)
@@ -17,23 +17,44 @@ Kea provides optional support for a YANG/NETCONF interface with the
 Installing NETCONF
 ==================
 
-To get its NETCONF capabilities, Kea uses Sysrepo.
+To get its NETCONF capabilities, Kea uses libyang v1.0.240 and sysrepo v1.4.140.
+Use packages if they are provided on your system. There is always the
+alternative method of building from sources which should work on all popular
+OSs:
 
-The following sections provide installation instructions for Ubuntu and CentOS.
+.. _libyang-install-sources:
 
-.. _netconf-ubuntu-install:
+Installing libyang From Sources
+-------------------------------
 
-Installing NETCONF on Ubuntu
-----------------------------
+.. code-block:: console
+
+    $ git clone https://github.com/CESNET/libyang.git
+    $ cd libyang
+    $ git checkout v1.0.240
+    $ mkdir build
+    $ cd build
+    $ cmake .. -DGEN_CPP_BINDINGS=ON -DGEN_LANGUAGE_BINDINGS=ON -DGEN_PYTHON_BINDINGS=OFF
+    $ make
+    $ make install  # without sudo if you're doing development and want to run unit tests
 
-For detailed installation instructions, see the `Ubuntu installation notes page <https://gitlab.isc.org/isc-projects/kea/wikis/docs/ubuntu-installation-notes>`__.
+.. _sysrepo-install-sources:
 
-.. _netconf-centos-install:
+Installing sysrepo From Sources
+-------------------------------
+
+.. code-block:: console
 
-Installing NETCONF on CentOS
-----------------------------
+    $ git clone https://github.com/sysrepo/sysrepo.git
+    $ cd sysrepo
+    $ git checkout v1.4.140
+    $ mkdir build
+    $ cd build
+    $ cmake .. -DGEN_CPP_BINDINGS=ON -DGEN_LANGUAGE_BINDINGS=ON -DGEN_PYTHON_BINDINGS=OFF
+    $ make
+    $ make install  # without sudo if you're doing development and want to run unit tests
 
-For detailed installation instructions, see the `CentOS installation notes page <https://gitlab.isc.org/isc-projects/kea/wikis/docs/centos-installation-notes>`__.
+.. _sysrepo-overview:
 
 Quick Sysrepo Overview
 ======================