diff options
| -rw-r--r-- | doc/sphinx/arm/admin.rst | 4 | ||||
| -rw-r--r-- | doc/sphinx/arm/hooks-radius.rst | 144 | ||||
| -rw-r--r-- | doc/sphinx/arm/install.rst | 2 | ||||
| -rw-r--r-- | platforms.rst | 6 |
4 files changed, 67 insertions, 89 deletions
diff --git a/doc/sphinx/arm/admin.rst b/doc/sphinx/arm/admin.rst index dbf83f6397..1d4657ea7d 100644 --- a/doc/sphinx/arm/admin.rst +++ b/doc/sphinx/arm/admin.rst @@ -541,8 +541,8 @@ which the servers will access it. A number of steps are required: file is normally located in the primary data directory for the PostgreSQL server. The precise path may vary depending on the operating system and version, but the default location for PostgreSQL is - ``/etc/postgresql/*/main/postgresql.conf``. However, on some systems - (notably CentOS 8), the file may reside in ``/var/lib/pgsql/data``. + ``/etc/postgresql/*/main/postgresql.conf``. However, on some systems, the + file may reside in ``/var/lib/pgsql/data``. Assuming Kea is running on the same host as PostgreSQL, adding lines similar to the following should be sufficient to provide diff --git a/doc/sphinx/arm/hooks-radius.rst b/doc/sphinx/arm/hooks-radius.rst index b82d14327a..b349adb0e7 100644 --- a/doc/sphinx/arm/hooks-radius.rst +++ b/doc/sphinx/arm/hooks-radius.rst @@ -92,25 +92,24 @@ Compilation and Installation of the RADIUS Hook ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The following section describes how to compile and install the software -on CentOS 7.0. Other systems may differ slightly. +on Ubuntu 22.04. Other systems may differ slightly. .. note:: - ISC provides Kea software and hooks in convenient-to-use - native DEB, and RPM packages. This includes the RADIUS hook and the required patched version - of the FreeRADIUS client library. The software compilation for RADIUS is complicated; unless - there are specific reasons to compile it, administrators should seriously consider using - native packages. + ISC provides Kea software and hooks in convenient-to-use native DEB, and RPM + packages. This includes the RADIUS hook and the required patched version of + the FreeRADIUS client library. The software compilation for RADIUS is + complicated; unless there are specific reasons to compile it, administrators + should seriously consider using native packages. STEP 1: Install dependencies -Several tools are needed to build the dependencies and Kea itself. The -following commands should install them: +Several tools are needed to build the dependencies and Kea itself. The following +commands should install them: .. code-block:: console - $ sudo rpm -Uvh https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm - $ sudo yum install gcc-g++ openssl-devel log4cplus-devel wget git + $ apt-get install gcc g++ make autoconf automake libtool libssl-dev liblog4cplus-dev libboost-system-dev STEP 2: Install FreeRADIUS @@ -137,44 +136,11 @@ version, please use the following steps: $ sudo make install Additional parameters may be passed to the configure script, if needed. -The FreeRADIUS client will be installed in -/usr/local, which is the default path where Kea will look for it. -It can be installed in a different directory; if so, +The FreeRADIUS client will be installed in /usr/local, which is the default path +where Kea will look for it. It can be installed in a different directory; if so, make sure to add that path to the configure script when compiling Kea. -STEP 3: Install a recent Boost version - -Kea requires a reasonably recent Boost version. Unfortunately, the -version available in CentOS 7 is too old, so a newer Boost version is -necessary. Furthermore, CentOS 7 has an old version of the g++ compiler -that does not handle the latest Boost versions. Fortunately, Boost 1.65 -meets both requirements; it is both recent enough for Kea and can be -compiled using the g++ 4.8 version in CentOS. - -To download and compile Boost 1.65, please use the following commands: - -.. code-block:: console - - $ wget -nd https://boostorg.jfrog.io/artifactory/main/release/1.65.1/source/boost_1_65_1.tar.gz - $ tar -zxvf boost_1_65_1.tar.gz - $ cd boost_1_65_1/ - $ ./bootstrap.sh - $ ./b2 --without-python - $ sudo ./b2 install - -Note that the ``b2`` script may optionally take extra parameters; one of -them specifies the destination path where the sources are to be -compiled. - -Alternatively, some systems provide newer Boost packages. For example, -CentOS 7 provides ``boost169-devel``. If it is installed with -``yum install boost169-devel``, Kea must be pointed to it with: - -.. code-block:: console - - $ ./configure --with-boost-include=/usr/include/boost169 --with-boost-lib-dir=/usr/lib64/boost169 - -STEP 4: Compile and install Kea +STEP 3: Compile and install Kea Obtain the Kea sources either by downloading them from the git repository or extracting the tarball. Use one of these commands @@ -234,18 +200,7 @@ be specified. .. code-block:: console $ autoreconf -i - $ ./configure --with-freeradius=/path/to/freeradius --with-boost-include=/path/to/boost --with-boost-lib-dir=/path/to/boost/state/lib - -For example, assuming the FreeRADIUS client was installed in the default -directory (/usr/local) and the Boost 1.65 sources were compiled in -/home/thomson/devel/boost1_65_1, the configure path should look as -follows: - -.. code-block:: console - - $ ./configure --with-freeradius=/usr/local \ - --with-boost-include=/home/thomson/devel/boost_1_65_1 \ - --with-boost-lib-dir=/home/thomson/devel/boost_1_65_1/stage/lib + $ ./configure --with-freeradius=/path/to/freeradius After some checks, the configure script should print a report similar to the following: @@ -257,20 +212,25 @@ the following: Package: Name: kea - Version: |release| - Extended version: |release| (tarball) + Version: 2.4.0 + Extended version: 2.4.0 (tarball) + Version type: stable OS Family: Linux + Prefix: /usr/local Hooks directory: /usr/local/lib/kea/hooks Premium hooks: yes - Included Hooks: forensic_log flex_id host_cmds subnet_cmds radius host_cache + Included Hooks: ddns_tuning forensic_log flex_id host_cmds limits subnet_cmds radius host_cache class_cmds cb_cmds lease_query gss_tsig rbac + + Configure arguments: + '--with-freeradius' C++ Compiler: - CXX: g++ --std=c++11 - CXX_VERSION: g++ (GCC) 4.8.5 20150623 (Red Hat 4.8.5-16) - CXX_STANDARD: 201103 + CXX: g++ + CXX_VERSION: g++ (Ubuntu 12.3.0-1ubuntu1~22.04) 12.3.0 + CXX_STANDARD: 201703 DEFS: -DHAVE_CONFIG_H - CPPFLAGS: -DOS_LINUX -DBOOST_ASIO_HEADER_ONLY + CPPFLAGS: -DOS_LINUX -I$(top_srcdir) -I$(top_builddir) CXXFLAGS: -g -O2 LDFLAGS: -lpthread KEA_CXXFLAGS: -Wall -Wextra -Wnon-virtual-dtor -Wwrite-strings -Woverloaded-virtual -Wno-sign-compare -pthread -Wno-missing-field-initializers -fPIC @@ -279,27 +239,28 @@ the following: PYTHON_VERSION: not needed (because kea-shell is disabled) Boost: - BOOST_VERSION: 1.65.1 - BOOST_INCLUDES: -I/home/thomson/devel/boost_1_65_1 - BOOST_LIBS: -L/home/thomson/devel/boost_1_65_1/stage/lib -lboost_system + BOOST_VERSION: 1.74 + BOOST_INCLUDES: + BOOST_LIBS: -lboost_system OpenSSL: - CRYPTO_VERSION: OpenSSL 1.0.2k 26 Jan 2017 + CRYPTO_VERSION: OpenSSL 3.0.2 15 Mar 2022 CRYPTO_CFLAGS: CRYPTO_INCLUDES: CRYPTO_LDFLAGS: - CRYPTO_LIBS: -lcrypto + CRYPTO_LIBS: -lssl -lcrypto + TLS support: yes Botan: no Log4cplus: - LOG4CPLUS_VERSION: 1.1.3 + LOG4CPLUS_VERSION: 2.0.5 LOG4CPLUS_INCLUDES: -I/usr/include LOG4CPLUS_LIBS: -L/usr/lib -L/usr/lib64 -llog4cplus Flex/bison: FLEX: flex - BISON: bison -y + BISON: /usr/bin/bison MySQL: no @@ -307,6 +268,21 @@ the following: PostgreSQL: no + NETCONF: + no + + libyang: + no + + libyang-cpp: + no + + sysrepo: + no + + sysrepo-cpp: + no + Google Test: no @@ -316,23 +292,25 @@ the following: FREERADIUS_DICTIONARY: /usr/local/etc/radiusclient/dictionary Developer: - Enable Debugging: no - Google Tests: no - Valgrind: not found - C++ Code Coverage: no - Logger checks: no - Generate Documentation: no - Parser Generation: no - Kea-shell: no - Perfdhcp: no + Enable Debugging: no + Google Tests: no + Valgrind: no + C++ Code Coverage: no + Logger checks: no + Install existing manuals: yes + Generate Documentation: no + Generate Parser: no + Generate Messages Files: no + Perfdhcp: no + Kea-shell: no + Enable fuzzing: no Please make sure that the compilation includes the following: - RADIUS listed in Included Hooks; - FreeRADIUS client directories printed and pointing to the right directories; -- Boost version at least 1.65.1. The versions available in CentOS 7 - (1.48 and 1.53) are too old. +- Boost version at least 1.65.1. Once the configuration is complete, compile Kea using ``make``. If the system has more than one core, using the ``-jN`` diff --git a/doc/sphinx/arm/install.rst b/doc/sphinx/arm/install.rst index 3ac96b6d1a..fa27e36d74 100644 --- a/doc/sphinx/arm/install.rst +++ b/doc/sphinx/arm/install.rst @@ -20,7 +20,7 @@ instructions or refer to ISC `KB article <https://kb.isc.org/docs/isc-kea-packag Installation From Cloudsmith Packages ------------------------------------- -ISC provides Kea packages for Alpine, CentOS, Debian, Fedora, RHEL, and Ubuntu. +ISC provides Kea packages for Alpine, Debian, Fedora, RHEL, and Ubuntu. The recommended method for installing Kea on any of these systems, from the Cloudsmith repository for Kea release 2.3.1 or later, is to install the ``isc-kea`` metapackage. This metapackage is included on all supported distros and diff --git a/platforms.rst b/platforms.rst index b81f90bf94..78565993f0 100644 --- a/platforms.rst +++ b/platforms.rst @@ -17,8 +17,8 @@ offer support on a "best-effort" basis for some. Regularly Tested Platforms -------------------------- -Kea is officially supported on Alpine, CentOS, Fedora, RHEL, Ubuntu, Debian, -and FreeBSD systems. Kea-|release| builds have been tested on: +Kea is officially supported on Alpine, Debian, Fedora, FreeBSD, RHEL, and Ubuntu +systems. Kea-|release| builds have been tested on: * Alpine — 3.15, 3.16, 3.17 * Debian — 10, 11, 12 @@ -54,7 +54,7 @@ adverse effect on officially supported platforms. These include platforms past their respective EOL dates, such as: * Alpine — 3.10, 3.11, 3.12, 3.13, 3.14 (EOL 01 May 2023) -* CentOS — 6, 7, 8 (EOL 31 December 2021) +* CentOS — 6 (EOL 30 November 2020), 7 (EOL 30 June 2024), 8 (EOL 31 December 2021) * Debian — 8, 9 (EOL 30 June 2022) * Fedora — 31, 32, 33, 34, 35 (EOL 13 December 2022) * FreeBSD — 10, 11 (EOL 30 September 2021) |