mir/kea
2
0
Fork 0
mirror of https://gitlab.isc.org/isc-projects/kea synced 2025-08-29 21:18:02 +00:00
Code Issues Releases Wiki Activity

[4518] Changes after review:

Browse Source 
- added vendor options example and made it out-of-pool in
   kea6/reservations.json
 - fixed couple indents in dhcp{4,6}-srv.xml
 - added enclosing subnet4 where it was missing in examples
 - renamed section dedicated to option reservations
 - default value of host-reservation-identifiers presented
   differently
This commit is contained in:
Tomek Mrugalski 2016-07-05 14:27:25 +02:00
parent e73e9daf37
commit cba07cb92b
3 changed files with 90 additions and 63 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
doc/examples/kea6/reservations.json
View File

@ -84,11 +84,25 @@
}, },
# This is a bit more advanced reservation. The client with the specified # This is a bit more advanced reservation. The client with the specified
# DUID will get a reserved address, a reserved prefix and a hostname. # DUID will get a reserved address, a reserved prefix and a hostname.
# This reservation is for an address that it not within the dynamic pool.
# Finally, this reservation features vendor specific options for CableLabs,
# which happen to use enterprise-id 4491. Those particular values will
# be returned only to the client that has a DUID matching this reservation.
{ {
"duid": "01:02:03:04:05:06:07:08:09:0A", "duid": "01:02:03:04:05:06:07:08:09:0A",
"ip-addresses": [ "2001:db8:1::102" ], "ip-addresses": [ "2001:db8:1:cafe::1" ],
"prefixes": [ "2001:db8:2:abcd::/64" ], "prefixes": [ "2001:db8:2:abcd::/64" ],
"hostname": "foo.example.com" "hostname": "foo.example.com",
"option-data": [ {
"name": "vendor-opts",
"data": "4491"
},
{
"name": "tftp-servers",
"space": "vendor-4491",
"data": "3000:1::234"
} ]
} }
] ]
} }

87
doc/guide/dhcp4-srv.xml
View File

@ -10,13 +10,11 @@
<section id="dhcp4-start-stop"> <section id="dhcp4-start-stop">
<title>Starting and Stopping the DHCPv4 Server</title> <title>Starting and Stopping the DHCPv4 Server</title>
<!-- @todo Rewrite this section once #3422 is done -->
<para> <para>
It is recommended that the Kea DHCPv4 server be started and stopped It is recommended that the Kea DHCPv4 server be started and stopped
using <command>keactrl</command> (described in <xref linkend="keactrl"/>). using <command>keactrl</command> (described in <xref linkend="keactrl"/>).
However, it is also possible to run the server directly: it accepts However, it is also possible to run the server directly: it accepts
the following command-line switches: the following command-line switches:
</para> </para>
<itemizedlist> <itemizedlist>
@ -64,25 +62,25 @@
</itemizedlist> </itemizedlist>
<para> <para>
The <command>-V</command> command returns the versions of the The <command>-V</command> command returns the versions of the
external libraries dynamically linked. external libraries dynamically linked.
</para> </para>
<para> <para>
The <command>-W</command> command describes the environment used The <command>-W</command> command describes the environment used
to build Kea. This command displays a copy of the to build Kea. This command displays a copy of the
<filename>config.report</filename> file produced by <filename>config.report</filename> file produced by
<userinput>./configure</userinput> that is embedded in the <userinput>./configure</userinput> that is embedded in the
executable binary. executable binary.
</para> </para>
<para> <para>
The <filename>config.report</filename> may also be accessed more The <filename>config.report</filename> may also be accessed more
directly. The following command may be used to extract this directly. The following command may be used to extract this
information. The binary <userinput>path</userinput> may be found information. The binary <userinput>path</userinput> may be found
in the install directory or in the <filename>.libs</filename> in the install directory or in the <filename>.libs</filename>
subdirectory in the source tree. For example subdirectory in the source tree. For example
<filename>kea/src/bin/dhcp4/.libs/kea-dhcp4</filename>. <filename>kea/src/bin/dhcp4/.libs/kea-dhcp4</filename>.
<screen> <screen>
strings <userinput>path</userinput>/kea-dhcp4 | sed -n 's/;;;; //p' strings <userinput>path</userinput>/kea-dhcp4 | sed -n 's/;;;; //p'
@ -90,9 +88,9 @@ strings <userinput>path</userinput>/kea-dhcp4 | sed -n 's/;;;; //p'
</para> </para>
<para> <para>
When running in a console, the server can be shut down by When running in a console, the server can be shut down by
pressing ctrl-c. It detects the key combination and shuts pressing ctrl-c. It detects the key combination and shuts
down gracefully. down gracefully.
</para> </para>
<para> <para>
@ -2493,7 +2491,7 @@ It is merely echoed by the server
192.0.2.204 for a client that uses a client identifier with value 192.0.2.204 for a client that uses a client identifier with value
01:11:22:33:44:55:66.</para> 01:11:22:33:44:55:66.</para>
<para>Note that the above example is used for ilustrational purposes only <para>The above example is used for ilustrational purposes only
and in actual deployments it is recommended to use as few types as possible and in actual deployments it is recommended to use as few types as possible
(preferably just one). See <xref linkend="reservations4-tuning"/> for detailed (preferably just one). See <xref linkend="reservations4-tuning"/> for detailed
discussion.</para> discussion.</para>
@ -2675,7 +2673,7 @@ It is merely echoed by the server
</section> </section>
<section id="reservation4-options"> <section id="reservation4-options">
<title>Reserving specific options</title> <title>Including specific DHCPv4 options in reservations</title>
<para>Kea 1.1.0 introduced the ability to specify options on a <para>Kea 1.1.0 introduced the ability to specify options on a
per host basis. The options follow the same rules as any other per host basis. The options follow the same rules as any other
options. These can be standard options (see <xref options. These can be standard options (see <xref
@ -2685,20 +2683,24 @@ It is merely echoed by the server
example showcases how standard options can be defined.</para> example showcases how standard options can be defined.</para>
<screen> <screen>
"reservations": [
{ {
"hw-address": "aa:bb:cc:dd:ee:ff", "subnet4": [ {
"ip-address": "192.0.2.1", "reservations": [
<userinput>"option-data": [ {
{ "hw-address": "aa:bb:cc:dd:ee:ff",
"name": "cookie-servers", "ip-address": "192.0.2.1",
"data": "10.1.1.202,10.1.1.203" <userinput>"option-data": [
}, {
{ "name": "cookie-servers",
"name": "log-servers", "data": "10.1.1.202,10.1.1.203"
"data": "10.1.1.200,10.1.1.201" },
} ]</userinput> {
} ]</screen> "name": "log-servers",
"data": "10.1.1.200,10.1.1.201"
} ]</userinput>
} ]
} ]
}</screen>
<para>Vendor specific options can be reserved in a similar manner:</para> <para>Vendor specific options can be reserved in a similar manner:</para>
@ -2852,10 +2854,17 @@ It is merely echoed by the server
]</screen> ]</screen>
</para> </para>
<para>If not specified, the default value is: <command>hw-address, duid, <para>If not specified, the default value is:
circuit-id</command>.</para> <!-- see CfgHostOperations::createConfig4() in
<screen>
<userinput>"host-reservation-identifiers": [ "hw-address", "duid", "circuit-id" ]</userinput>
</screen>
<!-- see CfgHostOperations::createConfig4() in
src/lib/dhcpsrv/cfg_host_operations.cc --> src/lib/dhcpsrv/cfg_host_operations.cc -->
</para>
</section> </section>

48
doc/guide/dhcp6-srv.xml
View File

@ -11,10 +11,10 @@
<title>Starting and Stopping the DHCPv6 Server</title> <title>Starting and Stopping the DHCPv6 Server</title>
<para> <para>
It is recommended that the Kea DHCPv6 server be started and stopped It is recommended that the Kea DHCPv6 server be started and stopped
using <command>keactrl</command> (described in <xref linkend="keactrl"/>). using <command>keactrl</command> (described in <xref linkend="keactrl"/>).
However, it is also possible to run the server directly: it accepts However, it is also possible to run the server directly: it accepts
the following command-line switches: the following command-line switches:
</para> </para>
<itemizedlist> <itemizedlist>
@ -62,25 +62,25 @@
</itemizedlist> </itemizedlist>
<para> <para>
The <command>-V</command> command returns the versions of the The <command>-V</command> command returns the versions of the
external libraries dynamically linked. external libraries dynamically linked.
</para> </para>
<para> <para>
The <command>-W</command> command describes the environment used The <command>-W</command> command describes the environment used
to build Kea. This command displays a copy of the to build Kea. This command displays a copy of the
<filename>config.report</filename> file produced by <filename>config.report</filename> file produced by
<userinput>./configure</userinput> that is embedded in the <userinput>./configure</userinput> that is embedded in the
executable binary. executable binary.
</para> </para>
<para> <para>
The <filename>config.report</filename> may also be accessed more The <filename>config.report</filename> may also be accessed more
directly. The following command may be used to extract this directly. The following command may be used to extract this
information. The binary <userinput>path</userinput> may be found information. The binary <userinput>path</userinput> may be found
in the install directory or in the <filename>.libs</filename> in the install directory or in the <filename>.libs</filename>
subdirectory in the source tree. For example subdirectory in the source tree. For example
<filename>kea/src/bin/dhcp6/.libs/kea-dhcp6</filename>. <filename>kea/src/bin/dhcp6/.libs/kea-dhcp6</filename>.
<screen> <screen>
strings <userinput>path</userinput>/kea-dhcp6 | sed -n 's/;;;; //p' strings <userinput>path</userinput>/kea-dhcp6 | sed -n 's/;;;; //p'
@ -88,9 +88,9 @@ strings <userinput>path</userinput>/kea-dhcp6 | sed -n 's/;;;; //p'
</para> </para>
<para> <para>
When running in a console, the server can be shut down by When running in a console, the server can be shut down by
pressing ctrl-c. It detects the key combination and shuts pressing ctrl-c. It detects the key combination and shuts
down gracefully. down gracefully.
</para> </para>
<para> <para>
@ -2404,7 +2404,7 @@ should include options from the isc option space:
</section> </section>
<section id="reservation6-options"> <section id="reservation6-options">
<title>Reserving specific options</title> <title>Including specific DHCPv6 options in reservations</title>
<para>Kea 1.1.0 introduced the ability to specify options on a <para>Kea 1.1.0 introduced the ability to specify options on a
per host basis. The options follow the same rules as any other per host basis. The options follow the same rules as any other
@ -2583,7 +2583,11 @@ should include options from the isc option space:
</para> </para>
<para> <para>
If not specified, the default value is: <command>hw-address,duid</command>. If not specified, the default value is:
<screen>
<userinput>"host-reservation-identifiers": [ "hw-address", "duid" ]</userinput>
</screen>
</para> </para>
<!-- see CfgHostOperations::createConfig6() in <!-- see CfgHostOperations::createConfig6() in
src/lib/dhcpsrv/cfg_host_operations.cc --> src/lib/dhcpsrv/cfg_host_operations.cc -->