2
0
mirror of https://gitlab.isc.org/isc-projects/kea synced 2025-08-22 09:57:41 +00:00
kea/platforms.md

123 lines
4.6 KiB
Markdown
Raw Normal View History

2020-01-21 18:23:31 +00:00
<!--
- Copyright (C) Internet Systems Consortium, Inc. ("ISC")
-
- This Source Code Form is subject to the terms of the Mozilla Public
- License, v. 2.0. If a copy of the MPL was not distributed with this
- file, You can obtain one at http://mozilla.org/MPL/2.0/.
-
- See the COPYRIGHT file distributed with this work for additional
- information regarding copyright ownership.
-->
## Supported platforms
In general, this version of Kea will build and run on any POSIX-compliant
system with a C++ compiler, the Botan cryptographic ibrary, the log4cplus logging library and the Boost system library.
Required Software at Run-Time
=============================
Running Kea uses various extra software packages which may not be
provided in the default installation of some operating systems, nor in
the standard package collections. You may need to install this required
software separately. (For the build requirements, also see :ref:`build-requirements`.)
- Kea supports two cryptographic libraries: Botan and OpenSSL. Only one
of them is required to be installed during compilation. Kea uses the
Botan library for C++ (https://botan.randombit.net/), version 2.0 or
later. Note that support for Botan versions earlier than 2.0 was
removed in Kea 1.7.0 and later. As an alternative to Botan, Kea can
use the OpenSSL cryptographic library (https://www.openssl.org/),
version 1.0.2 or later.
- Kea uses the log4cplus C++ logging library
(https://sourceforge.net/p/log4cplus/wiki/Home/). It requires log4cplus version
1.0.3 or later.
- Kea requires the Boost system library (https://www.boost.org/).
Building with the header-only version of Boost is no longer
recommended.
Some optional features of Kea have additional dependencies.
- To store lease information in a MySQL database, Kea requires
MySQL headers and libraries. This is an optional dependency;
Kea can be built without MySQL support.
- To store lease information in a PostgreSQL database, Kea
requires PostgreSQL headers and libraries. This is an optional
dependency; Kea can be built without PostgreSQL support.
- To store lease information in a Cassandra database (CQL),
Kea requires Cassandra headers and libraries. This is an optional
dependency; Kea can be built without Cassandra support.
- Integration with RADIUS is provided in Kea via the hooks library
available to our paid support customers. Use of this library requires
the FreeRadius-client library to be present on the system where Kea
is running. This is an optional dependency; Kea can be built
without RADIUS support.
- Kea provides a NETCONF interface with the
kea-netconf agent. This Kea module is built optionally and requires
Sysrepo software when used. Building Kea with NETCONF support
requires many dependencies to be installed, which are described in
more detail in :ref:`netconf-install`.
---
ISC regularly tests Kea on many operating systems and architectures, but
lacks the resources to test all of them. Consequently, ISC is only able to
offer support on a "best effort" basis for some.
### Regularly tested platforms
As of January, 2020, Kea is officially supported on CentOS, Fedora, Ubuntu, Debian, and
FreeBSD systems. Kea-|release| builds have been tested on:
* CentOS Linux — 7, 8
* Fedora — 29, 30
* Ubuntu — 16.04, 18.04, 19.04
* Debian GNU/Linux — 9, 10
There are currently no plans to port Kea to Windows systems.
### Best effort
The following are platforms on which Kea is known to build and run.
ISC makes every effort to fix bugs on these platforms, but may be unable to
do so quickly due to lack of hardware, less familiarity on the part of
engineering staff, and other constraints.
* FreeBSD — 11.3, 12.0
* Alpine Linux — 3.10
* macOS — 10.13, 10.14
### Community maintained
These systems may not all have the required dependencies for building Kea
easily available, although it will be possible in many cases to compile
those directly from source. The community and interested parties may wish
to help with maintenance, and we welcome patch contributions, although we
cannot guarantee that we will accept them. All contributions will be
assessed against the risk of adverse effect on officially supported
platforms.
* Platforms past or close to their respective EOL dates, such as:
* Ubuntu 14.04, 18.10
* CentOS 6
* Debian Jessie
* FreeBSD 10.x
## Unsupported platforms
These are platforms on which Kea 1.7+ is known *not* to build or run:
* Windows (all versions)
* Windows Server (all versions)
* Any platform with OpenSSL 1.01 or earlier, which does not also have Botan as an alternative
* Any platform with log4cplus version 1.0.2 or earlier.