Commit cba07cb9 authored by Tomek Mrugalski's avatar Tomek Mrugalski 🛰
Browse files

[4518] Changes after review:

 - 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
parent e73e9daf
......@@ -84,11 +84,25 @@
},
# This is a bit more advanced reservation. The client with the specified
# 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",
"ip-addresses": [ "2001:db8:1::102" ],
"ip-addresses": [ "2001:db8:1:cafe::1" ],
"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"
} ]
}
]
}
......
......@@ -10,8 +10,6 @@
<section id="dhcp4-start-stop">
<title>Starting and Stopping the DHCPv4 Server</title>
<!-- @todo Rewrite this section once #3422 is done -->
<para>
It is recommended that the Kea DHCPv4 server be started and stopped
using <command>keactrl</command> (described in <xref linkend="keactrl"/>).
......@@ -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
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
(preferably just one). See <xref linkend="reservations4-tuning"/> for detailed
discussion.</para>
......@@ -2675,7 +2673,7 @@ It is merely echoed by the server
</section>
<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
per host basis. The options follow the same rules as any other
options. These can be standard options (see <xref
......@@ -2685,8 +2683,10 @@ It is merely echoed by the server
example showcases how standard options can be defined.</para>
<screen>
"reservations": [
{
"subnet4": [ {
"reservations": [
{
"hw-address": "aa:bb:cc:dd:ee:ff",
"ip-address": "192.0.2.1",
<userinput>"option-data": [
......@@ -2698,7 +2698,9 @@ It is merely echoed by the server
"name": "log-servers",
"data": "10.1.1.200,10.1.1.201"
} ]</userinput>
} ]</screen>
} ]
} ]
}</screen>
<para>Vendor specific options can be reserved in a similar manner:</para>
......@@ -2852,10 +2854,17 @@ It is merely echoed by the server
]</screen>
</para>
<para>If not specified, the default value is: <command>hw-address, duid,
circuit-id</command>.</para> <!-- see CfgHostOperations::createConfig4() in
<para>If not specified, the default value is:
<screen>
<userinput>"host-reservation-identifiers": [ "hw-address", "duid", "circuit-id" ]</userinput>
</screen>
<!-- see CfgHostOperations::createConfig4() in
src/lib/dhcpsrv/cfg_host_operations.cc -->
</para>
</section>
......
......@@ -2404,7 +2404,7 @@ should include options from the isc option space:
</section>
<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
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>
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>
<!-- see CfgHostOperations::createConfig6() in
src/lib/dhcpsrv/cfg_host_operations.cc -->
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment