DHCP. Установка сервера DHCP Kea

Установка сервера DHCP ISC Kea.

1 Общая информация

• Сайт: https://www.isc.org/kea/
• Репозиторий:
  • https://gitlab.isc.org/isc-projects/kea
  • https://github.com/isc-projects/kea
• Документация: https://kea.readthedocs.io/en/latest/index.html

1.1 Особенности

• Модульная конструкция компонентов
  • Расширяется с помощью модулей-хуков.
  • Дистрибутив Kea включает отдельные демоны для сервера DHCPv4, сервера DHCPv6 и модуля динамического DNS (DDNS).
• Онлайн-реконфигурация с помощью REST API.
  • Kea использует файл конфигурации JSON, который можно изменить удалённо без остановки и перезапуска сервера.
• Панель управления через веб-интерфейс.
• Поддерживает базы данных MySQL, PostgreSQL:
  • упрощает интеграцию с другими системами;
  • можно использовать один и тот же сервер резервирования хостов для нескольких DHCP-серверов;
  • администрирование глобальных параметров из централизованной системы настройки.

2 Опции DHCP

3 Установка

• Устанавливаем сервер Linux (см. Rocky Linux. Установка сервера).

3.1 Репозиторий RockyLinux

• Текущая версия в репозитории: 2.2.x.
• В версии 2.3.2 изменили систему именования.
• Если в дальнейше планируется обновление, возможно стоит использовать репозитории ISC.
• Подключаем репозиторий EPEL:

  1dnf config-manager --set-enabled crb
  2dnf -y install epel-release
  

• Устанавливаем сервер Kea:

  1dnf -y install kea kea-hooks
  

3.2 Репозиторий ISC

• Текущая стабильная версия в репозитории: 2.6.x.

3.2.1 Kea-2.6

• Подключаем репозиторий:

  1curl -1sLf 'https://dl.cloudsmith.io/public/isc/kea-2-6/setup.rpm.sh' | sudo -E bash
  

• Отключите старые репозитории, если они были установлены:

  1dnf config-manager --disable isc-kea-2-4 isc-kea-2-4-noarch isc-kea-2-4-source
  2dnf clean all
  

• Проверьте, что репозитории отключены:

  1dnf repolist
  

• Устанавливаем сервер Kea:

  1dnf -y install isc-kea isc-kea-hooks
  

3.2.2 Kea-2.4

• Подключаем репозиторий:

  1curl -1sLf 'https://dl.cloudsmith.io/public/isc/kea-2-4/setup.rpm.sh' | sudo -E bash
  

• Устанавливаем сервер Kea:

  1dnf -y install isc-kea isc-kea-hooks
  

3.3 Инструментарий миграции keama

• При необходимости миграции с реализации ISC DHCP на ISC KEA можно установить помощник миграции.
• Документация:
  • https://gitlab.isc.org/isc-projects/dhcp/-/wikis/kea-migration-assistant
  • https://kb.isc.org/docs/migrating-from-isc-dhcp-to-kea-dhcp-using-the-migration-assistant
• Репозиторий: https://gitlab.isc.org/isc-projects/dhcp/-/tree/master/keama
• Бинарные сборки:
  • https://cloudsmith.io/~isc/repos/keama/packages/
  • заблокирован доступ из России
• Подключаем репозиторий бинарных файлов:

  1curl -1sLf 'https://dl.cloudsmith.io/public/isc/keama/setup.rpm.sh' | sudo -E bash
  

• Устанавливаем сервер Kea:

  1dnf -y install isc-dhcp-keama
  

4 Подготовка

4.1 Брандмауэр

• Сконфигурируем брандмауэр:

  1firewall-cmd --add-service=dhcp --permanent
  2firewall-cmd --reload
  

5 Подготовка базы данных

5.1 PostgreSQL

• Установка базы данных:

  1dnf install postgresql-server
  

• Проверьте временную зону сервера:

  1date +%Z
  

• Рекомендуется использовать временную зону UTC.
• Инициализируйте базу данных:

  1postgresql-setup --initdb
  

• Запустим базу данных:

  1systemctl enable --now postgresql.service
  

5.1.1 Создание базы данных

• Подключимся к базе данных:

  1sudo -i -u postgres psql postgres
  

• Проверим временную зону базы:

  1show timezone;
  2SELECT * FROM pg_timezone_names WHERE name = current_setting('TIMEZONE');
  

• Настройки временной зоны для postgresql находятся в файле /var/lib/pgsql/data/postgresql.conf:

  1timezone = 'Etc/UTC'
  

• Можно использовать следующие названия:
  • database-name : kea;
  • user-name : kea;
  • password : сгенерите нужный пароль.
• Создадим базу данных:

  1CREATE DATABASE database-name;
  

• Создадим пользователя и пароль для взаимодействия с базой:

  1CREATE USER user-name WITH PASSWORD 'password';
  2GRANT ALL PRIVILEGES ON DATABASE database-name TO user-name;
  

• Выйдем из интерфейса базы данных:

  1\q
  

5.1.2 Заполнение базы данных

• Настроим доступ к базе данных в файле /var/lib/pgsql/data/pg_hba.conf.
• Добавьте эти записи до других записей:

  1local   database-name    user-name                                 password
  2host    database-name    user-name          127.0.0.1/32           password
  3host    database-name    user-name          ::1/128                password
  

• Перезагрузите postgresql:

  1systemctl restart postgresql.service
  

1. Загрузка значений вручную

   • Загрузим значения в базу данных:

     1psql -d database-name -U user-name -f /usr/share/kea/scripts/pgsql/dhcpdb_create.pgsql
     

2. Загрузка значений через kea-admin

   • Загрузим значения в базу данных:

     1kea-admin db-init pgsql -u database-user -p database-password -n database-name
     

5.1.3 Обновление базы данных

• При переходе с предыдущей версии kea надо обновить базу данных.
• Проверьте текущую версию базы данных:

  1kea-admin db-version pgsql -u database-user -p database-password -n database-name
  

• Обновите базу (при необходимости):

  1kea-admin db-upgrade pgsql -u database-user -p database-password -n database-name
  

5.2 Миграция с ISC DHCP на ISC Kea

• Преобразуем конфигурационные файлы:

  1keama -4 -i dhcpd.conf -o kea-dhcp4.conf
  

5.3 Тьюнинг базы данных

• Отключите синхронные коммиты.
• Можно отключить в базе данных:

  1sudo -i -u postgres psql postgres
  2ALTER SYSTEM SET synchronous_commit=OFF;
  3\q
  

• Можно задать в файле конфигурации /var/lib/pgsql/data/postgresql.conf:

  1synchronous_commit = off
  

5.4 Конфигурация базы данных для Kea

• Добавим конфигурацию базы данных:

   1"Dhcp4": {
   2    "lease-database": {
   3        "type": "postgresql",
   4        "name": "database_name",
   5        "host" : "localhost",
   6        "user": "user_name",
   7        "password": "password"
   8    },
   9
  10    "hosts-database": {
  11        "type": "postgresql",
  12        "name": "database_name",
  13        "host" : "localhost",
  14        "user": "user_name",
  15        "password": "password"
  16    },
  17}
  

6 Виртуальные интерфейсы

• Для подключения к сети использовал интерфейсы VLAN (см. Linux. Настройка vlan)

6.1 Миграция интерфейсов

• Файлы описания интерфейсов на старой системе имеют следующий вид (/etc/sysconfig/network-scripts/ifcfg-eth1.200):

  1VLAN=yes
  2DEVICE=eth1.200
  3BOOTPROTO=none
  4ONBOOT=yes
  5TYPE=Ethernet
  6IPADDR=10.200.0.2
  7NETMASK=255.255.0.0
  8NETWORK=10.200.0.0
  9BROADCAST=10.200.255.255
  

• Для миграции сделал набор скриптов.

• Скрипт для извлечения параметров интерфейсов (mk-if-list):

   1#!/bin/bash
   2
   3OUTFILE=iflist
   4[[ -f ${OUTFILE} ]] && rm ${OUTFILE}
   5
   6for i in ifcfg-eth*.*
   7do
   8        vlan_id=$(grep DEVICE= ${i} | cut -d "." -f 2)
   9        ip=$(grep IPADDR= ${i} | cut -d "=" -f 2)
  10        mask=$(grep NETMASK= ${i} | cut -d "=" -f 2)
  11        prefix=$(ipcalc -p 1.1.1.1 ${mask}  | sed -n 's:^PREFIX=\(.*\):\1:p')
  12        echo ${vlan_id}" "${ip}"/"${prefix} >> ${OUTFILE}
  13done
  

  • Для скрипта необходима утилита ipcalc:

    1dnf -y install ipcalc
    

• Получившийся файл iflist имеет следующий формат:

  1200 10.200.0.2/16
  

• Скрипт mk-if-script для получения команд генерации интерфейсов VLAN:

  1#!/usr/bin/awk -f
  2
  3BEGIN { print "#!/bin/sh\n" }
  4{ print "nmcli connection add type vlan con-name vlan"$1"-con ifname vlan"$1"-if dev eno1 id "$1"\n""nmcli connection modify vlan"$1"-con ipv4.addresses "$2"\n""sudo nmcli connection modify vlan"$1"-con ipv4.method manual" }
  

• Получим файл с командами интерфейсов:

  1./mk-if-script iflist > iflist-run
  

• Сгенерим новые интерфейсы:

  1chmod +x iflist-run
  2./iflist-run
  

6.2 Конфигурация интерфейсов для Kea

• Добавим интерфейсы в файл конфигурации /etc/kea/kea-dhcp4.conf:

   1"Dhcp4": {
   2    "interfaces-config": {
   3        "interfaces": [
   4            "vlan200-if",
   5            "vlan201-if",
   6            "vlan202-if"
   7        ],
   8        "dhcp-socket-type": "raw"
   9    },
  10}
  

7 Управляющий агент kea-ctrl-agent

7.1 По умолчанию

• По умолчанию агент устанавливает unix-сокеты и доступ по сети для локального хоста.
• Если ничего другого не надо, то дополнительной настройки не требуется.

7.2 Доступ по сети

• Для доступа к управляющему агенту из вне необходимо настроить сетевой доступ.
• Например, это может понадобиться для интеграции с Netbox (см. NetBox. Плагин netbox-kea).

7.2.1 Брандмауэр

• Сконфигурируем брандмауэр:

  1firewall-cmd --add-port=8000/tcp --permanent
  2firewall-cmd --reload
  

7.2.2 Сертификаты

• В качестве сертификатов можно использовать сертификаты ACME.
• Если сертификаты не установлены, то используется протокол http.

7.2.3 Конфигурационный файл

• Конфигурация в файле будет будет иметь вид:

   1{
   2    "Control-agent": {
   3        "http-host": "10.20.30.40",
   4        "http-port": 8000,
   5        "trust-anchor": "/path/to/the/ca-cert.pem",
   6        "cert-file": "/path/to/the/agent-cert.pem",
   7        "key-file": "/path/to/the/agent-key.pem",
   8        "cert-required": true,
   9        "authentication": {
  10            "type": "basic",
  11            "realm": "kea-control-agent",
  12            "clients": [
  13                {
  14                    "user": "admin",
  15                    "password": "1234"
  16                }
  17            ]
  18        },
  19        ...
  20    }
  

7.2.4 Пример запроса

• Пример запроса с использованием RESTful API:

  1curl -u admin:1234 -X POST -H "Content-Type: application/json" -d '{ "command": "config-get", "service": [ "dhcp4" ] }' http://10.20.30.40:8000/
  

8 Запуск

• Запуск управляющего агента:

  1systemctl enable --now kea-ctrl-agent.service
  

• Запуск сервера DHCPv4:

  1systemctl enable --now kea-dhcp4.service
  

• Запуск сервиса DDNS:

  1systemctl enable --now kea-dhcp-ddns.service
  

9 Утилиты

9.1 Просмотр арендованных адресов

• Арендованные адреса можно смотреть в базе данных.
• Для разных баз данных существуют конкретные утилиты.

9.1.1 Postgres

1. kea-list-leases

   • Репозиторий: https://git.sr.ht/~cstrotm/kea-list-leases
   • В репозитории скрипт и конфигурационный файл.

   1. Пререквизиты

      • Нужно установить драйвер PostgreSQL для python : psycopg (https://www.psycopg.org/):

        1dnf -y install python3-psycopg2
        

   2. Настройка

      • Задайте конфигурационный файл kea-list-leases.conf (в том же каталоге, что и скрипт):

        1[postgresql]
        2host=127.0.0.1
        3database=kea_lease_db
        4user=kea
        5password=password
        

10 После установки

• Настройте DDNS (см. Динамическое обновление DNS-сервера BIND при помощи Kea DHCP)