Kea Administrator Reference Manual i Kea Administrator Reference Manual Copyright © 2010-2016 Internet Systems Consortium, Inc. Kea Administrator Reference Manual ii Kea Administrator Reference Manual iii Contents 1 Introduction 1 1.1 Supported Platforms . .1 1.2 Required Software at Run-time . .1 1.3 Kea Software . .2 2 Quick start 3 2.1 Quick start guide for DHCPv4 and DHCPv6 services . .3 2.2 Running Kea servers directly . .4 3 Installation 5 3.1 Packages . .5 3.2 Install Hierarchy . .5 3.3 Building Requirements . .5 3.4 Installation from Source . .6 3.4.1 Download Tar File . .6 3.4.2 Retrieve from Git . .6 3.4.3 Configure before the build . .7 3.4.4 Build . .8 3.4.5 Install . .8 3.5 Selecting the Configuration Backend . .8 3.6 DHCP Database Installation and Configuration . .8 3.6.1 Building with MySQL Support . .9 3.6.2 Building with PostgreSQL support . .9 3.6.3 Building with CQL (Cassandra) support . .9 4 Kea Database Administration 10 4.1 Databases and Database Version Numbers . 10 4.2 The kea-admin Tool . 10 4.3 Supported Databases . 11 4.3.1 memfile . 11 4.3.1.1 Upgrading Memfile Lease Files from an Earlier Version of Kea . 11 4.3.2 MySQL . 11 Kea Administrator4.3.2.1 Reference First Manual Time Creation of Kea Database . 12iv 4.3.2.2 Upgrading a MySQL Database from an Earlier Version of Kea . 12 4.3.3 PostgreSQL . 13 4.3.3.1 Manually Create the PostgreSQL Database and the Kea User . 13 4.3.3.2 Initialize the PostgreSQL Database Using kea-admin . 14 4.3.3.3 Upgrading a PostgreSQL Database from an Earlier Version of Kea . 14 4.3.4 CQL (Cassandra) . 15 4.3.4.1 First Time Creation of Kea Database . 15 4.3.4.2 Upgrading a CQL Database from an Earlier Version of Kea . 15 4.3.5 Using read only databases with host reservations . 16 4.3.6 Limitations related to the use of the SQL databases . 16 5 Kea configuration 17 5.1 JSON configuration backend . 17 5.1.1 JSON syntax . 17 5.1.2 Simplified Notation . 18 6 Managing Kea with keactrl 19 6.1 Overview . 19 6.2 Command Line Options . 19 6.3 The keactrl Configuration File . 19 6.4 Commands . 20 6.5 Overriding the Server Selection . 22 7 The DHCPv4 Server 23 7.1 Starting and Stopping the DHCPv4 Server . 23 7.2 DHCPv4 Server Configuration . 24 7.2.1 Introduction . 24 7.2.2 Lease Storage . 26 7.2.2.1 Memfile, Basic Storage for Leases . 26 7.2.2.2 Lease Database Configuration . 27 7.2.3 Hosts Storage . 28 7.2.3.1 DHCPv4 Hosts Database Configuration . 28 7.2.3.2 Using Read-Only Databases for Host Reservations . 28 7.2.4 Interface configuration . 29 7.2.5 Issues with unicast responses to DHCPINFORM . 30 7.2.6 IPv4 Subnet Identifier . 31 7.2.7 Configuration of IPv4 Address Pools . 31 7.2.8 Standard DHCPv4 options . 33 7.2.9 Custom DHCPv4 options . 34 Kea Administrator7.2.10 DHCPv4 Reference Vendor Manual Specific Options . 38v 7.2.11 Nested DHCPv4 Options (Custom Option Spaces) . 39 7.2.12 Unspecified parameters for DHCPv4 option configuration . 41 7.2.13 Stateless Configuration of DHCPv4 clients . 41 7.2.14 Client Classification in DHCPv4 . 42 7.2.14.1 Setting fixed fields in Classification . 42 7.2.14.2 Using Vendor Class Information in Classification . 43 7.2.14.3 Defining and Using Custom Classes . 43 7.2.15 DDNS for DHCPv4 . 44 7.2.15.1 DHCP-DDNS Server Connectivity . 45 7.2.15.2 When Does the kea-dhcp4 Server Generate DDNS Requests? . 46 7.2.15.3 kea-dhcp4 name generation for DDNS update requests . 47 7.2.16 Next Server (siaddr) . 48 7.2.17 Echoing Client-ID (RFC 6842) . 48 7.2.18 Using Client Identifier and Hardware Address . 49 7.2.19 DHCPv4-over-DHCPv6 DHCPv4 side . 50 7.3 Host reservation in DHCPv4 . 51 7.3.1 Address reservation types . 52 7.3.2 Conflicts in DHCPv4 reservations . 53 7.3.3 Reserving a hostname . ..