quickstart.xml 4.83 KB
Newer Older
1
2
3
4
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
<!ENTITY mdash  "&#x2014;" >
5
6
<!ENTITY % version SYSTEM "version.ent">
%version;
7
8
9
10
11
12
13
14
15
16
17
18
]>

  <chapter id="quickstart">
    <title>Quick start</title>

    <para>
        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.
    </para>

    <section id="quick-start">
19
      <title>Quick start guide for DHCPv4 and DHCPv6 services</title>
20
21
22
23
24
25
26
27
28
29
30

      <orderedlist>

        <listitem>
          <simpara>
            Install required run-time and build dependencies. See <xref
	    linkend="build-requirements"/> for details.
          </simpara>
        </listitem>

        <listitem>
31
32
33
34
35
36
37
38
          <para>
            Download Kea source tarball from <ulink url="https://www.isc.org/downloads/">ISC.org downloads page</ulink> or <ulink url="http://ftp.isc.org/isc/kea/">ISC ftp server</ulink>.
          </para>
        </listitem>

        <listitem>
          <para>
            Extract the tarball. For example:
Jeremy C. Reed's avatar
Jeremy C. Reed committed
39
            <screen>$ <userinput>tar xvzf kea-&__VERSION__;.tar.gz</userinput></screen>
40
          </para>
41
42
43
        </listitem>

        <listitem>
44
          <para>Go into the source directory and run the configure script:
45
            <screen>$ <userinput>cd kea-&__VERSION__;</userinput>
46
47
48
49
50
51
52
53
54
55
56
$ <userinput>./configure [your extra parameters]</userinput></screen>
          </para>
        </listitem>

        <listitem>
          <para>Build it:
            <screen>$ <userinput>make</userinput></screen>
          </para>
        </listitem>

        <listitem>
57
          <para>Install it (by default the installation prefix is <filename>/usr/local/</filename>,
58
59
          so you likely need root privileges for that step):
            <screen># <userinput>make install</userinput></screen>
60
61
62
63
          </para>
        </listitem>

        <listitem>
64
65
66
          <para>Edit configuration file which is by default installed in
          <filename>[kea-install-dir]/etc/kea/kea.conf</filename> and contains
          configuration for all Kea services. Configuration choices for DHCPv4
67
          and DHCPv6 services are described in <xref linkend="dhcp4-configuration"/> and <xref linkend="dhcp6-configuration"/>, respectively.</para>
68
        </listitem>
69
70

        <listitem>
71
72
73
74
75
76
77
          <para>In order to start the DHCPv4 server in background, run the
          following command (as root):
          <screen># <userinput>keactrl start -s dhcp4</userinput></screen>
          Or run the following command to start DHCPv6 server instead:
          <screen># <userinput>keactrl start -s dhcp6</userinput></screen>
          Note that it is also possible to start both servers simultaneously:
          <screen>$ <userinput>keactrl start</userinput></screen>
78
79
80
81
          </para>
        </listitem>

        <listitem>
82
83
84
85
86
87
88
          <para>Verify that Kea server(s) are running:
          <screen># <userinput>keactrl status</userinput></screen>
          If the server status is "inactive" may indicate a configuration
          error. Please check a log file (by default located in
          <filename>[kea-install-dir]/var/kea/kea.log</filename>) for the
          details of the error.
          </para>
89
        </listitem>
90
91

        <listitem>
92
93
94
95
96
          <para>
            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 <ulink url="http://www.isc.org/downloads/DHCP/">ISC DHCP client</ulink>.
97
98
99
100
          </para>
        </listitem>

        <listitem>
101
102
103
104
          <para>
            Stop running server(s):
            <screen># <userinput>keactrl stop</userinput></screen>
          </para>
105
        </listitem>
106
      </orderedlist>
107
108
109
110
111
      <para>
        For more system specific installation procedures, you may want to visit
        <ulink url="http://kea.isc.org/wiki/SystemSpecificNotes">System specific notes</ulink>,
        available on <ulink url="http://kea.isc.org/">Kea homepage</ulink>.
      </para>
112

113
      <para>The details of <command>keactrl</command> script usage can be found
114
      in <xref linkend="keactrl"/>.</para>
115
116
117
118
119
120
121
122
123
124
125
    </section>

    <section id="quick-start-direct-run">
      <title>Running Kea servers directly</title>
      <para>Kea servers can be started directly (without a need to use
      <command>keactrl</command>). To start DHCPv4 server run the following
      commmand:
      <screen># <userinput>kea-dhcp4 -c /path/to/your/kea4/config/file.json</userinput></screen>
      And, to start the DHCPv6 server run the following command:
      <screen># <userinput>kea-dhcp6 -c /path/to/your/kea6/config/file.json</userinput></screen>
    </para>
126
127
128
    </section>

  </chapter>