%version; ]> Quick start This quickly covers the standard steps for installing and deploying Kea. For further details, full customizations, and troubleshooting, see the respective chapters in the Kea guide.
Quick start guide for DHCPv4 and DHCPv6 services Install required run-time and build dependencies. See for details. Download Kea source tarball from ISC.org downloads page or ISC ftp server. Extract the tarball. For example: $ tar xvzf kea-&__VERSION__;.tar.gz Go into the source directory and run the configure script: $ cd kea-&__VERSION__; $ ./configure [your extra parameters] Build it: $ make Install it (by default the installation prefix is /usr/local/, so you likely need root privileges for that step): # make install Edit the configuration file which by default is installed in [kea-install-dir]/etc/kea/kea.conf and contains configuration for all Kea services. Configuration choices for DHCPv4 and DHCPv6 services are described in and , respectively. In order to start the DHCPv4 server in background, run the following command (as root): # keactrl start -s dhcp4 Or run the following command to start DHCPv6 server instead: # keactrl start -s dhcp6 Note that it is also possible to start both servers simultaneously: $ keactrl start Verify that Kea server(s) are running: # keactrl status If the server status is "inactive" may indicate a configuration error. Please check a log file (by default located in [kea-install-dir]/var/kea/kea.log) for the details of the error. If the server has been started sucessfully, test that it is responding to DHCP queries and that the client receives a configuration from the server; for example, use the ISC DHCP client. Stop running server(s): # keactrl stop For more system specific installation procedures, you may want to visit System specific notes, available on Kea homepage. The details of keactrl script usage can be found in .
Running Kea servers directly Kea servers can be started directly (without a need to use keactrl). To start DHCPv4 server run the following commmand: # kea-dhcp4 -c /path/to/your/kea4/config/file.json And, to start the DHCPv6 server run the following command: # kea-dhcp6 -c /path/to/your/kea6/config/file.json