From: Marcin Siodelski Date: Fri, 22 Aug 2014 09:35:34 +0000 (+0200) Subject: [3519] Updated "Quick Start" section of the Kea Guide. X-Git-Tag: trac3482_base~17^2~5^2~1 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=516df19ad353f631280febc2fac1a7977f11bb21;p=thirdparty%2Fkea.git [3519] Updated "Quick Start" section of the Kea Guide. --- diff --git a/doc/guide/dhcp4-srv.xml b/doc/guide/dhcp4-srv.xml index 36f407d2a8..7e4ae71c4a 100644 --- a/doc/guide/dhcp4-srv.xml +++ b/doc/guide/dhcp4-srv.xml @@ -77,7 +77,7 @@
- Configuring the DHCPv4 Server + DHCPv4 Server Configuration
Introduction diff --git a/doc/guide/quickstart.xml b/doc/guide/quickstart.xml index 026b831576..1bbcd4b0a6 100644 --- a/doc/guide/quickstart.xml +++ b/doc/guide/quickstart.xml @@ -25,18 +25,22 @@ - - - Checkout the latest Kea revision from the Git repository: - $ git clone git://git.kea.isc.org/kea - + + Download Kea source tarball from ISC.org downloads page or ISC ftp server. + + + + + + Extract the tarball. For example: + $ tar xvf kea-0.9-beta1.tar.gz + Go into the source directory and run the configure script: - $ cd kea + $ cd kea-0.9-beta1 $ autoreconf --install $ ./configure [your extra parameters] @@ -56,60 +60,63 @@ $ ./configure [your extra parameters] - If you wish to run a DHCP server for IPv4, you need to set up and start - the kea-dhcp4 server: - - - Edit your configuration file for DHCPv4. - describes the configuration choices available; example DHCPv4 configuration can be found in - doc/examples/kea4. - + Edit configuration file which is by default 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. + - Start Kea DHCPv4 server (as root): - # kea-dhcp4 -c /path/to/your/kea4/config/file.json + 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 - Test it; for example, use the - ISC DHCP client - to send DHCPv4 queries to the server and verify that the client receives a - configuration from the server: - $ dhclient -4 eth0 - - - + 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 you wish to run a DHCP server for IPv6, you need to set up and start - the kea-dhcp6 server: - - - Edit your configuration file for DHCPv6. - describes the configuration choices, and some example DHCPv6 configuration can be found in - doc/examples/kea6. - - - - Start Kea DHCPv6 server (as root): - # kea-dhcp6 -c /path/to/your/kea6/config/file.json + + 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. - Test it; for example, use the - ISC DHCP client - to send DHCPv6 queries to the server and verify that the client receives a - configuration from the server: - $ dhclient -6 eth0 - - - + + Stop running server(s): + # keactrl stop + + 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 +