Kea Administrator Reference Manual¶
Kea is an open source implementation of the Dynamic Host Configuration Protocol (DHCP) servers, developed and maintained by Internet Systems Consortium (ISC).
This is the reference guide for Kea version 1.7.8. Links to the most up-to-date version of this document (in PDF, HTML, and plain text formats), along with other documents for Kea, can be found in ISC’s Knowledgebase.
- 1. Introduction
- 2. Quick Start
- 3. Installation
- 4. Kea Database Administration
- 5. Kea Configuration
- 6. Managing Kea with keactrl
- 7. The Kea Control Agent
- 8. The DHCPv4 Server
- 8.1. Starting and Stopping the DHCPv4 Server
- 8.2. DHCPv4 Server Configuration
- 8.2.1. Introduction
- 8.2.2. Lease Storage
- 8.2.3. Hosts Storage
- 8.2.4. Interface Configuration
- 8.2.5. Issues with Unicast Responses to DHCPINFORM
- 8.2.6. IPv4 Subnet Identifier
- 8.2.7. IPv4 Subnet Prefix
- 8.2.8. Configuration of IPv4 Address Pools
- 8.2.9. Sending T1 (Option 58) and T2 (Option 59)
- 8.2.10. Standard DHCPv4 Options
- 8.2.11. Custom DHCPv4 Options
- 8.2.12. DHCPv4 Private Options
- 8.2.13. DHCPv4 Vendor-Specific Options
- 8.2.14. Nested DHCPv4 Options (Custom Option Spaces)
- 8.2.15. Unspecified Parameters for DHCPv4 Option Configuration
- 8.2.16. Stateless Configuration of DHCPv4 Clients
- 8.2.17. Client Classification in DHCPv4
- 8.2.18. DDNS for DHCPv4
- 8.2.19. Next Server (siaddr)
- 8.2.20. Echoing Client-ID (RFC 6842)
- 8.2.21. Using Client Identifier and Hardware Address
- 8.2.22. Authoritative DHCPv4 Server Behavior
- 8.2.23. DHCPv4-over-DHCPv6: DHCPv4 Side
- 8.2.24. Sanity Checks in DHCPv4
- 8.2.25. Storing Extended Lease Information
- 8.2.26. Multi-threading settings
- 8.3. Host Reservation in DHCPv4
- 8.3.1. Address Reservation Types
- 8.3.2. Conflicts in DHCPv4 Reservations
- 8.3.3. Reserving a Hostname
- 8.3.4. Including Specific DHCPv4 Options in Reservations
- 8.3.5. Reserving Next Server, Server Hostname, and Boot File Name
- 8.3.6. Reserving Client Classes in DHCPv4
- 8.3.7. Storing Host Reservations in MySQL, PostgreSQL, or Cassandra
- 8.3.8. Fine-Tuning DHCPv4 Host Reservation
- 8.3.9. Global Reservations in DHCPv4
- 8.3.10. Pool Selection with Client Class Reservations
- 8.3.11. Subnet Selection with Client Class Reservations
- 8.4. Shared Networks in DHCPv4
- 8.5. Server Identifier in DHCPv4
- 8.6. How the DHCPv4 Server Selects a Subnet for the Client
- 8.7. Duplicate Addresses (DHCPDECLINE Support)
- 8.8. Statistics in the DHCPv4 Server
- 8.9. Management API for the DHCPv4 Server
- 8.10. User Contexts in IPv4
- 8.11. Supported DHCP Standards
- 8.12. DHCPv4 Server Limitations
- 8.13. Kea DHCPv4 Server Examples
- 8.14. Configuration Backend in DHCPv4
- 9. The DHCPv6 Server
- 9.1. Starting and Stopping the DHCPv6 Server
- 9.2. DHCPv6 Server Configuration
- 9.2.1. Introduction
- 9.2.2. Lease Storage
- 9.2.3. Hosts Storage
- 9.2.4. Interface Configuration
- 9.2.5. IPv6 Subnet Identifier
- 9.2.6. IPv6 Subnet Prefix
- 9.2.7. Unicast Traffic Support
- 9.2.8. Configuration of IPv6 Address Pools
- 9.2.9. Subnet and Prefix Delegation Pools
- 9.2.10. Prefix Exclude Option
- 9.2.11. Standard DHCPv6 Options
- 9.2.12. Common Softwire46 Options
- 9.2.13. Custom DHCPv6 Options
- 9.2.14. DHCPv6 Vendor-Specific Options
- 9.2.15. Nested DHCPv6 Options (Custom Option Spaces)
- 9.2.16. Unspecified Parameters for DHCPv6 Option Configuration
- 9.2.17. Controlling the Values Sent for T1 and T2 Times
- 9.2.18. IPv6 Subnet Selection
- 9.2.19. Rapid Commit
- 9.2.20. DHCPv6 Relays
- 9.2.21. Relay-Supplied Options
- 9.2.22. Client Classification in DHCPv6
- 9.2.23. DDNS for DHCPv6
- 9.2.24. DHCPv4-over-DHCPv6: DHCPv6 Side
- 9.2.25. Sanity Checks in DHCPv6
- 9.2.26. Storing Extended Lease Information
- 9.2.27. Multi-threading settings
- 9.3. Host Reservation in DHCPv6
- 9.3.1. Address/Prefix Reservation Types
- 9.3.2. Conflicts in DHCPv6 Reservations
- 9.3.3. Reserving a Hostname
- 9.3.4. Including Specific DHCPv6 Options in Reservations
- 9.3.5. Reserving Client Classes in DHCPv6
- 9.3.6. Storing Host Reservations in MySQL, PostgreSQL, or Cassandra
- 9.3.7. Fine-Tuning DHCPv6 Host Reservation
- 9.3.8. Global Reservations in DHCPv6
- 9.3.9. Pool Selection with Client Class Reservations
- 9.3.10. Subnet Selection with Client Class Reservations
- 9.4. Shared Networks in DHCPv6
- 9.5. Server Identifier in DHCPv6
- 9.6. DHCPv6 data directory
- 9.7. Stateless DHCPv6 (Information-Request Message)
- 9.8. Support for RFC 7550 (now part of RFC 8415)
- 9.9. Using a Specific Relay Agent for a Subnet
- 9.10. Segregating IPv6 Clients in a Cable Network
- 9.11. MAC/Hardware Addresses in DHCPv6
- 9.12. Duplicate Addresses (DECLINE Support)
- 9.13. Statistics in the DHCPv6 Server
- 9.14. Management API for the DHCPv6 Server
- 9.15. User Contexts in IPv6
- 9.16. Supported DHCPv6 Standards
- 9.17. DHCPv6 Server Limitations
- 9.18. Kea DHCPv6 server examples
- 9.19. Configuration Backend in DHCPv6
- 10. Lease Expiration
- 11. Congestion Handling
- 12. The DHCP-DDNS Server
- 12.1. Overview
- 12.2. Starting and Stopping the DHCP-DDNS Server
- 12.3. Configuring the DHCP-DDNS Server
- 12.4. DHCP-DDNS Server Limitations
- 12.5. Supported Standards
- 13. The LFC Process
- 14. Client Classification
- 14.1. Client Classification Overview
- 14.2. Built-in Client Classes
- 14.3. Using Expressions in Classification
- 14.4. Configuring Classes
- 14.5. Using Static Host Reservations In Classification
- 14.6. Configuring Subnets With Class Information
- 14.7. Configuring Pools With Class Information
- 14.8. Using Classes
- 14.9. Classes and Hooks
- 14.10. Debugging Expressions
- 15. Hooks Libraries
- 15.1. Introduction
- 15.2. Installing Hook Packages
- 15.3. Configuring Hooks Libraries
- 15.4. Available Hooks Libraries
- 15.5. user_chk: Checking User Access
- 15.6. legal_log: Forensic Logging Hooks
- 15.7. flex_id: Flexible Identifiers for Host Reservations
- 15.8. flex_option Flexible Option for Option value settings
- 15.9. host_cmds: Host Commands
- 15.10. lease_cmds: Lease Commands
- 15.10.1. The lease4-add, lease6-add Commands
- 15.10.2. The lease6-bulk-apply Command
- 15.10.3. The lease4-get, lease6-get Commands
- 15.10.4. The lease4-get-all, lease6-get-all Commands
- 15.10.5. The lease4-get-page, lease6-get-page Commands
- 15.10.6. The lease4-get-by-, lease6-get-by- Commands
- 15.10.7. The lease4-del, lease6-del Commands
- 15.10.8. The lease4-update, lease6-update Commands
- 15.10.9. The lease4-wipe, lease6-wipe Commands
- 15.10.10. The lease4-resend-ddns, lease6-resend-ddns Commands
- 15.11. subnet_cmds: Subnet Commands
- 15.11.1. The subnet4-list Command
- 15.11.2. The subnet6-list Command
- 15.11.3. The subnet4-get Command
- 15.11.4. The subnet6-get Command
- 15.11.5. The subnet4-add Command
- 15.11.6. The subnet6-add Command
- 15.11.7. The subnet4-update Command
- 15.11.8. The subnet6-update Command
- 15.11.9. The subnet4-del Command
- 15.11.10. The subnet6-del Command
- 15.11.11. The network4-list, network6-list Commands
- 15.11.12. The network4-get, network6-get Commands
- 15.11.13. The network4-add, network6-add Commands
- 15.11.14. The network4-del, network6-del Commands
- 15.11.15. The network4-subnet-add, network6-subnet-add Commands
- 15.11.16. The network4-subnet-del, network6-subnet-del Commands
- 15.12. BOOTP support
- 15.13. class_cmds: Class Commands
- 15.14. cb_cmds: Configuration Backend Commands
- 15.14.1. Commands Structure
- 15.14.2. Control Commands for DHCP Servers
- 15.14.3. Metadata
- 15.14.4. remote-server4-del, remote-server6-del commands
- 15.14.5. remote-server4-get, remote-server6-get commands
- 15.14.6. remote-server4-get-all, remote-server6-get-all commands
- 15.14.7. remote-server4-set, remote-server6-set commands
- 15.14.8. The remote-global-parameter4-del, remote-global-parameter6-del Commands
- 15.14.9. The remote-global-parameter4-get, remote-global-parameter6-get Commands
- 15.14.10. The remote-global-parameter4-get-all, remote-global-parameter6-get-all Commands
- 15.14.11. The remote-global-parameter4-set, remote-global-parameter6-set Commands
- 15.14.12. The remote-network4-del, remote-network6-del Commands
- 15.14.13. The remote-network4-get, remote-network6-get Commands
- 15.14.14. The remote-network4-list, remote-network6-list Commands
- 15.14.15. The remote-network4-set, remote-network6-set Commands
- 15.14.16. The remote-option-def4-del, remote-option-def6-del Commands
- 15.14.17. The remote-option-def4-get, remote-option-def6-get Commands
- 15.14.18. The remote-option-def4-get-all, remote-option-def6-get-all Commands
- 15.14.19. The remote-option-def4-set, remote-option-def6-set Commands
- 15.14.20. The remote-option4-global-del, remote-option6-global-del Commands
- 15.14.21. The remote-option4-global-get, remote-option6-global-get Commands
- 15.14.22. The remote-option4-global-get-all, remote-option6-global-get-all Commands
- 15.14.23. The remote-option4-global-set, remote-option6-global-set Commands
- 15.14.24. The remote-option4-network-del, remote-option6-network-del Commands
- 15.14.25. The remote-option4-network-set, remote-option6-network-set Commands
- 15.14.26. The remote-option6-pd-pool-del Command
- 15.14.27. The remote-option6-pd-pool-set Command
- 15.14.28. The remote-option4-pool-del, remote-option6-pool-del Commands
- 15.14.29. The remote-option4-pool-set, remote-option6-pool-set Commands
- 15.14.30. The remote-option4-subnet-del, remote-option6-subnet-del Commands
- 15.14.31. The remote-option4-subnet-set, remote-option6-subnet-set Commands
- 15.14.32. The remote-subnet4-del-by-id, remote-subnet6-del-by-id Commands
- 15.14.33. The remote-subnet4-del-by-prefix, remote-subnet6-del-by-prefix Commands
- 15.14.34. The remote-subnet4-get-by-id, remote-subnet6-get-by-id Commands
- 15.14.35. The remote-subnet4-get-by-prefix, remote-subnet6-get-by-prefix Commands
- 15.14.36. The remote-subnet4-list, remote-subnet6-list Commands
- 15.14.37. The remote-subnet4-set, remote-subnet6-set Commands
- 15.15. ha: High Availability
- 15.15.1. Supported Configurations
- 15.15.2. Clocks on Active Servers
- 15.15.3. Server States
- 15.15.4. Scope Transition in a Partner-Down Case
- 15.15.5. Load-Balancing Configuration
- 15.15.6. Load Balancing with Advanced Classification
- 15.15.7. Hot-Standby Configuration
- 15.15.8. Passive-Backup Configuration
- 15.15.9. Lease Information Sharing
- 15.15.10. Controlling Lease-Page Size Limit
- 15.15.11. Timeouts
- 15.15.12. Pausing the HA State Machine
- 15.15.13. Control Agent Configuration
- 15.15.14. Controlled Shutdown and Maintenance of DHCP servers
- 15.15.15. Upgrading from Older HA Versions
- 15.15.16. Control Commands for High Availability
- 15.15.16.1. The ha-sync Command
- 15.15.16.2. The ha-scopes Command
- 15.15.16.3. The ha-continue Command
- 15.15.16.4. The ha-heartbeat Command
- 15.15.16.5. The status-get Command
- 15.15.16.6. The ha-maintenance-start Command
- 15.15.16.7. The ha-maintenance-cancel Command
- 15.15.16.8. The ha-maintenance-notify Command
- 15.16. stat_cmds: Supplemental Statistics Commands
- 15.17. radius: RADIUS Server Support
- 15.18. host_cache: Caching Host Reservations
- 15.19. lease_query: Leasequery
- 15.20. User Contexts in Hooks
- 16. Statistics
- 16.1. Statistics Overview
- 16.2. Statistics Lifecycle
- 16.3. Commands for Manipulating Statistics
- 16.3.1. The statistic-get Command
- 16.3.2. The statistic-reset Command
- 16.3.3. The statistic-remove Command
- 16.3.4. The statistic-get-all Command
- 16.3.5. The statistic-reset-all Command
- 16.3.6. The statistic-remove-all Command
- 16.3.7. The statistic-sample-age-set Command
- 16.3.8. The statistic-sample-age-set-all Command
- 16.3.9. The statistic-sample-count-set Command
- 16.3.10. The statistic-sample-count-set-all Command
- 16.4. Time series
- 17. Management API
- 17.1. Data Syntax
- 17.2. Using the Control Channel
- 17.3. Commands Supported by Both the DHCPv4 and DHCPv6 Servers
- 17.3.1. The build-report Command
- 17.3.2. The config-get Command
- 17.3.3. The config-reload Command
- 17.3.4. The config-test Command
- 17.3.5. The config-write Command
- 17.3.6. The leases-reclaim Command
- 17.3.7. The libreload Command
- 17.3.8. The list-commands Command
- 17.3.9. The config-set Command
- 17.3.10. The shutdown Command
- 17.3.11. The dhcp-disable Command
- 17.3.12. The dhcp-enable Command
- 17.3.13. The status-get Command
- 17.3.14. The server-tag-get Command:
- 17.3.15. The config-backend-pull Command:
- 17.3.16. The version-get Command
- 17.4. Commands Supported by the D2 Server
- 17.5. Commands Supported by the Control Agent
- 18. Logging
- 19. The Kea Shell
- 20. YANG/NETCONF Support
- 21. Monitoring Kea with Stork