Skip to content
GitLab
Projects
Groups
Snippets
/
Help
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
Menu
Open sidebar
Adam Osuchowski
Kea
Commits
b3c0d4fe
Commit
b3c0d4fe
authored
Apr 14, 2014
by
Marcin Siodelski
Browse files
[3395] bind10-guide cleanup.
parent
e7a7acb5
Changes
1
Hide whitespace changes
Inline
Side-by-side
doc/guide/bind10-guide.xml
View file @
b3c0d4fe
...
...
@@ -72,10 +72,24 @@
(
<ulink
url=
"http://bind10.isc.org"
/>
). In early 2014, ISC has
made a decision to discontinue active development of BIND 10 and
continue development of Kea as standalone DHCP servers. As a result,
the DNS-related binaries and libraries are going to be removed from
the Kea source tree over time.
the DNS server implementation is going to be removed from
the Kea source tree over time. In order to remove the dependency on Python 3,
the BIND 10 framework will be replaced by the server startup and
configuration mechanisms written in C++.
</para>
<note>
<simpara>
Kea has been implemented in BIND 10 framework and to certain extent
it still depends on various BIND 10 libraries. It also requires the BIND 10
framework to run, because BIND 10 configuration mechanisms are used to
configure Kea. As a result, this document still refers to BIND 10 in many
paragraphs. The term "BIND 10" in the context of this document means
"BIND 10 libraries and applications which are necessary for Kea to run
and configure". The term "Kea" means "the collection of binaries and libraries
which, as a whole, implement the DHCP protocols.
</simpara>
</note>
<para>
This guide covers Kea version
&__VERSION__;
.
</para>
...
...
@@ -1831,10 +1845,9 @@ address, but the usual ones don't." mean? -->
be deployed that facilitate communication between servers and
clients. Even though principles of both DHCPv4 and DHCPv6 are
somewhat similar, these are two radically different
protocols. BIND 10 offers two server implementations, one for DHCPv4
and one for DHCPv6. The DHCP part of the BIND 10 project is codenamed
Kea. The DHCPv4 component is colloquially referred to as Kea4 and its
DHCPv6 counterpart is called Kea6.
</para>
protocols. Kea offers two server implementations, one for DHCPv4
and one for DHCPv6. The DHCPv4 component is colloquially referred to
as Kea4 and its DHCPv6 counterpart is called Kea6.
</para>
<para>
In addition to providing lease management services, both Kea4 and
Kea6 can provide dynamic DNS (DDNS) updates driven by the lease changes they
make. These updates are carried out with the assistance of the
...
...
@@ -1843,30 +1856,23 @@ address, but the usual ones don't." mean? -->
them to the appropriate DNS servers and instruct those severs to add or
delete the requisite DNS entries.
</para>
<para>
This chapter covers those parts of
BIND 10
that are common to
<para>
This chapter covers those parts of
Kea
that are common to
both servers. DHCPv4-specific details are covered in
<xref
linkend=
"dhcp4"
/>
,
while those details specific to DHCPv6 are described in
<xref
linkend=
"dhcp6"
/>
.
The DHCP-DDNS server details are covered in
<xref
linkend=
"dhcp-ddns-server"
/>
</para>
<note>
<simpara>
In this release of BIND 10, the DHCPv4 and DHCPv6 servers
must be considered experimental.
</simpara>
</note>
<section
id=
"dhcp-install-configure"
>
<title>
DHCP Database Installation and Configuration
</title>
<para>
BIND 10 DHCP
stores its leases in a lease database. The software has been written in
a way that makes it possible to choose which database product should be used to
store the lease information. At present, Kea supports 3 database backends: MySQL,
PostgreSQL and
m
emfile. To limit external dependencies, both MySQL and PostgreSQL
support are disabled by default and only
m
emfile (which is implemented in pure C++)
is available. Support for a given database backend must be explicitly included when
BIND 10
is built. This section covers the building of
BIND 10
with MySQL and/or PostgreSQL
and the creation of the lease database.
Kea
stores its leases in a lease database. The software has been written in
a way that makes it possible to choose which database product should be used to
store the lease information. At present, Kea supports 3 database backends: MySQL,
PostgreSQL and
M
emfile. To limit external dependencies, both MySQL and PostgreSQL
support are disabled by default and only
M
emfile (which is implemented in pure C++)
is available. Support for a given database backend must be explicitly included when
Kea
is built. This section covers the building of
Kea
with MySQL and/or PostgreSQL
and the creation of the lease database.
</para>
<section>
<title>
Building with MySQL support
</title>
...
...
@@ -1875,7 +1881,7 @@ address, but the usual ones don't." mean? -->
libraries must be installed.
</para>
<para>
Build and install
BIND 10
as described in
<xref
linkend=
"installation"
/>
, with
Build and install
Kea
as described in
<xref
linkend=
"installation"
/>
, with
the following modification: to enable the MySQL database code, at the
"configure" step (see
<xref
linkend=
"configure"
/>
), specify the location of the
MySQL configuration program "mysql_config" with the "--with-dhcp-mysql" switch,
...
...
@@ -1930,7 +1936,7 @@ $</screen>
libraries must be installed. Client development libraries are often packaged as
"
libpq
"
.
</para>
<para>
Build and install
BIND 10
as described in
<xref
linkend=
"installation"
/>
, with
Build and install
Kea
as described in
<xref
linkend=
"installation"
/>
, with
the following modification: to enable the PostgreSQL database code, at the
"configure" step (see
<xref
linkend=
"configure"
/>
), specify the location of the
PostgreSQL configuration program "pg_config" with the "--with-dhcp-pgsql" switch,
...
...
@@ -2043,13 +2049,12 @@ host <replaceable>database-name</replaceable> <replaceable>user-name</repl
<title>
Starting and Stopping the DHCPv4 Server
</title>
<para>
<command>
b10-dhcp4
</command>
is the BIND 10 DHCPv4 server and, like other
parts of BIND 10, is configured through the
<command>
bindctl
</command>
program.
<command>
b10-dhcp4
</command>
is the Kea DHCPv4 server and is configured
through the
<command>
bindctl
</command>
program.
</para>
<para>
After starting
BIND 10
and entering bindctl, the first step
in configuring the server is to add it to the list of running
BIND 10
services.
After starting
<command>
bind10
</command>
and entering bindctl, the first step
in configuring the server is to add it to the list of running services.
<screen>
>
<userinput>
config add Init/components b10-dhcp4
</userinput>
>
<userinput>
config set Init/components/b10-dhcp4/kind dispensable
</userinput>
...
...
@@ -2231,8 +2236,8 @@ Dhcp4/dhcp-ddns/qualifying-suffix "example.com" string
If there is no password to the account, set the password to the empty string "". (This is also the default.)
</para>
<note>
<para>
The password is echoed when entered and is stored in clear text in the
BIND 10
configuration
database. Improved password security will be added in a future version of
BIND 10 DHCP
</para>
<para>
The password is echoed when entered and is stored in clear text in the configuration
database. Improved password security will be added in a future version of
Kea.
</para>
</note>
</section>
...
...
@@ -2805,7 +2810,7 @@ Dhcp4/dhcp-ddns/qualifying-suffix "example.com" string
<note>
<para>
With this version of
BIND 10
, the "vendor-encapsulated-options" option
With this version of
Kea
, the "vendor-encapsulated-options" option
must be specified in the configuration although it has no configurable
parameters. If it is not specified, the server will assume that it is
not configured and will not send it to a client. In the future there
...
...
@@ -3555,13 +3560,12 @@ Dhcp4/dhcp-ddns/qualifying-suffix "example.com" string
<title>
Starting and Stopping the DHCPv6 Server
</title>
<para>
<command>
b10-dhcp6
</command>
is the BIND 10 DHCPv6 server and, like other
parts of BIND 10, is configured through the
<command>
bindctl
</command>
program.
<command>
b10-dhcp6
</command>
is the Kea DHCPv6 server and is configured
through the
<command>
bindctl
</command>
program.
</para>
<para>
After starting
BIND 10
and starting
<command>
bindctl
</command>
, the first step
in configuring the server is to add
<command>
b10-dhcp6
</command>
to the list of running
BIND 10
services.
After starting
<command>
bind10
</command>
and starting
<command>
bindctl
</command>
, the first step
in configuring the server is to add
<command>
b10-dhcp6
</command>
to the list of running services.
<screen>
>
<userinput>
config add Init/components b10-dhcp6
</userinput>
>
<userinput>
config set Init/components/b10-dhcp6/kind dispensable
</userinput>
...
...
@@ -3646,7 +3650,7 @@ Dhcp6/dhcp-ddns/qualifying-suffix "example.com" string
</para>
<note>
<para>
With this version of
BIND 10
, there are a number of known limitations
With this version of
Kea
, there are a number of known limitations
and problems in the DHCPv6 server. See
<xref
linkend=
"dhcp6-limit"
/>
.
</para>
</note>
...
...
@@ -3742,8 +3746,8 @@ Dhcp6/dhcp-ddns/qualifying-suffix "example.com" string
If there is no password to the account, set the password to the empty string "". (This is also the default.)
</para>
<note>
<para>
The password is echoed when entered and is stored in clear text in the
BIND 10
configuration
database. Improved password security will be added in a future version of
BIND 10 DHCP
</para>
<para>
The password is echoed when entered and is stored in clear text in the configuration
database. Improved password security will be added in a future version of
Kea.
</para>
</note>
</section>
...
...
@@ -5127,9 +5131,9 @@ Dhcp6/renew-timer 1000 integer (default)
</screen>
</para>
<para>
Note that the server was only removed from the list, so
BIND10
will not
restart
it
, but the server itself is still running. Hence it
is usually
desired to stop it:
Note that the server was only removed from the list, so
it
will not
be
automatically
restart
ed
, but the server itself is still running. Hence it
is usually
desired to stop it:
</para>
<screen>
>
<userinput>
DhcpDdns shutdown
</userinput>
...
...
@@ -5820,7 +5824,7 @@ DhcpDdns/reverse_ddns/ddns_domains[0]/dns_servers[0]/port 53 integer(default)
</para>
<para>
While this library is currently used by
BIND 10 DHCP
, it is designed to
While this library is currently used by
Kea
, it is designed to
be a portable, universal library, useful for any kind of DHCP-related software.
</para>
...
...
Write
Preview
Supports
Markdown
0%
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment