Kea Administrator Reference Manual i Kea Administrator Reference Manual Kea Administrator Reference Manual ii Copyright © 2010-2015 Internet Systems Consortium, Inc. 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 . .7 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 . .8 3.6.2 Building with PostgreSQL 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.2 MySQL . 11 4.3.2.1 First Time Creation of Kea Database . 11 Kea Administrator Reference Manual iv 4.3.2.2 Upgrading a MySQL Database from an Earlier Version of Kea . 12 4.3.3 PostgreSQL . 12 4.3.3.1 Manually Create the PostgreSQL Database and the Kea User . 12 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 Limitations related to the use of the SQL databases . 14 5 Kea configuration 15 5.1 JSON configuration backend . 15 5.1.1 JSON syntax . 15 5.1.2 Simplified Notation . 16 6 Managing Kea with keactrl 17 6.1 Overview . 17 6.2 Command Line Options . 17 6.3 The keactrl Configuration File . 17 6.4 Commands . 18 6.5 Overriding the Server Selection . 20 7 The DHCPv4 Server 21 7.1 Starting and Stopping the DHCPv4 Server . 21 7.2 DHCPv4 Server Configuration . 22 7.2.1 Introduction . 22 7.2.2 Lease Storage . 24 7.2.2.1 Memfile, Basic Storage for Leases . 24 7.2.2.2 Database Configuration . 25 7.2.3 Interface configuration . 25 7.2.4 Issues with unicast responses to DHCPINFORM . 27 7.2.5 IPv4 Subnet Identifier . 27 7.2.6 Configuration of IPv4 Address Pools . 28 7.2.7 Standard DHCPv4 options . 29 7.2.8 Custom DHCPv4 options . 31 7.2.9 DHCPv4 Vendor Specific Options . 34 7.2.10 Nested DHCPv4 Options (Custom Option Spaces) . 35 7.2.11 Unspecified parameters for DHCPv4 option configuration . 37 7.2.12 Stateless Configuration of DHCPv4 clients . 37 7.2.13 Client Classification in DHCPv4 . 38 7.2.13.1 Limiting Access to IPv4 Subnet to Certain Classes . 39 7.2.14 Configuring DHCPv4 for DDNS . 39 7.2.14.1 DHCP-DDNS Server Connectivity . 40 Kea Administrator Reference Manual v 7.2.14.2 When Does the kea-dhcp4 Server Generate DDNS Requests? . 41 7.2.14.3 kea-dhcp4 name generation for DDNS update requests . 42 7.2.15 Next Server (siaddr) . 43 7.2.16 Echoing Client-ID (RFC 6842) . 43 7.2.17 Using Client Identifier and Hardware Address . 44 7.3 Host reservation in DHCPv4 . 45 7.3.1 Address reservation types . 46 7.3.2 Conflicts in DHCPv4 reservations . 46 7.3.3 Reserving a hostname . 47 7.3.4 Reserving specific options . 48 7.3.5 Fine Tuning IPv4 Host Reservation . 48 7.4 Server Identifier in DHCPv4 . 49 7.5 How the DHCPv4 Server Selects a Subnet for the Client . 49 7.5.1 Using a Specific Relay Agent for a Subnet . 49 7.5.2 Segregating IPv4 Clients in a Cable Network . 50 7.6 Statistics in DHCPv4 server . 51 7.7 Management API for the DHCPv4 server . 51 7.8 Supported DHCP Standards . 51 7.9 DHCPv4 Server Limitations . ..