quickstart.xml 4.24 KB
Newer Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
<?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;" >
]>

  <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">
      <title>Quick start guide for DHCPv4 and DHCPv6 services</title>

      <orderedlist>

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

        <!-- We may need to replace it with the link to a downloadable tarball
        once we have it. -->
        <listitem>
          <simpara>
            Checkout the latest Kea revision from the Git repository:
            <screen>$ <userinput>git clone git://git.kea.isc.org/kea</userinput> </screen>
          </simpara>
        </listitem>

        <listitem>
38
          <para>Go into the source directory and run the configure script:
39
40
41
42
43
44
45
46
47
48
49
50
51
            <screen>$ <userinput>cd kea</userinput>
$ <userinput>autoreconf --install</userinput>
$ <userinput>./configure [your extra parameters]</userinput></screen>
          </para>
        </listitem>

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

        <listitem>
52
53
          <para>Install it (by default the installation prefix is <filename>/usr/local/</filename>,
          so you need root privileges for that step):
54
55
56
57
58
            <screen>$ <userinput>make install</userinput></screen>
          </para>
        </listitem>

        <listitem>
59
          <para>If you wish to run a DHCP server for IPv4, you need to set up and start
60
          the kea-dhcp4 server:</para>
61
62
63
64
65
          <orderedlist>
          <listitem>
          <para>Edit your configuration file for DHCPv4. <xref linkend="dhcp4-configuration"/>
          describes the configuration choices available; example DHCPv4 configuration can be found in
          doc/examples/kea4.</para>
66
67
68
69
	</listitem>

        <listitem>
          <para>Start Kea DHCPv4 server (as root):
70
            <screen># <userinput>kea-dhcp4 -c /path/to/your/kea4/config/file.json</userinput></screen>
71
72
73
74
75
76
77
78
79
80
81
          </para>
        </listitem>

        <listitem>
         <para>Test it; for example, use the
         <ulink url="http://www.isc.org/downloads/DHCP/">ISC DHCP client</ulink>
         to send DHCPv4 queries to the server and verify that the client receives a
         configuration from the server:
            <screen>$ <userinput>dhclient -4 eth0</userinput></screen>
         </para>
        </listitem>
82
83
        </orderedlist>
        </listitem>
84
85

        <listitem>
86
          <para>If you wish to run a DHCP server for IPv6, you need to set up and start
87
          the kea-dhcp6 server:</para>
88
89
90
          <orderedlist>
        <listitem>
          <para>Edit your configuration file for DHCPv6. <xref linkend="dhcp6-configuration"/>
Jeremy C. Reed's avatar
Jeremy C. Reed committed
91
          describes the configuration choices, and some example DHCPv6 configuration can be found in
92
          doc/examples/kea6.</para>
93
94
95
96
	</listitem>

        <listitem>
          <para>Start Kea DHCPv6 server (as root):
97
            <screen># <userinput>kea-dhcp6 -c /path/to/your/kea6/config/file.json</userinput></screen>
98
99
100
101
102
103
104
105
106
107
108
          </para>
        </listitem>

        <listitem>
         <para>Test it; for example, use the
         <ulink url="http://www.isc.org/downloads/DHCP/">ISC DHCP client</ulink>
         to send DHCPv6 queries to the server and verify that the client receives a
         configuration from the server:
            <screen>$ <userinput>dhclient -6 eth0</userinput></screen>
         </para>
        </listitem>
109
110
        </orderedlist>
        </listitem>
111
      </orderedlist>
112
113
114
115
116
      <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>
117
118
119
120

    </section>

  </chapter>