mir/kea
2
0
Fork 0
mirror of https://gitlab.isc.org/isc-projects/kea synced 2025-08-31 05:55:28 +00:00
Code Issues Releases Wiki Activity

[#1842] document overlapping pools and subnets

Browse Source
This commit is contained in:
Andrei Pavel
2022-04-04 16:34:14 +03:00
committed by Tomek Mrugalski
parent 9e62cc59e6
commit 4a035f60cf
3 changed files with 51 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
doc/sphinx/arm/dhcp4-srv.rst
View File

@@ -1231,6 +1231,26 @@ address) address from that pool. In the aforementioned example of pool
assigned as well. This may be invalid in some network configurations. To assigned as well. This may be invalid in some network configurations. To
avoid this, use the ``min-max`` notation. avoid this, use the ``min-max`` notation.
.. note::
Here are some liberties and limits to the values that subnets and pools can
take in Kea configurations that are out of the ordinary:
+-------------------------------------------------------------+---------------+--------------------------------------------------------------------------------+
| Kea configuration case | Result | Comment |
+=============================================================+===============+================================================================================+
| Overlapping subnets | Allowed | Administrator consideration needs to be given to how clients are matched to |
| | | these subnets. |
+-------------------------------------------------------------+---------------+--------------------------------------------------------------------------------+
| Overlapping pools in one subnet | Startup error | DHCP4_PARSER_FAIL |
+-------------------------------------------------------------+---------------+--------------------------------------------------------------------------------+
| Overlapping address pools in different subnets | Allowed | Can act as a substitute for a global pool mechanic. When assigning leases from |
| | | one pool, Kea correctly excludes leases given under any pool that overlaps |
| | | with it such that no lease is given twice. |
+-------------------------------------------------------------+---------------+--------------------------------------------------------------------------------+
| Pools that are outside the subnet they are configured under | Startup error | DHCP4_PARSER_FAIL |
+-------------------------------------------------------------+---------------+--------------------------------------------------------------------------------+
.. _dhcp4-t1-t2-times: .. _dhcp4-t1-t2-times:
Sending T1 (Option 58) and T2 (Option 59) Sending T1 (Option 58) and T2 (Option 59)

28
doc/sphinx/arm/dhcp6-srv.rst
View File

@@ -1142,6 +1142,34 @@ and which is delegated a prefix from this pool.
] ]
} }
.. note::
Here are some liberties and limits to the values that subnets and pools can
take in Kea configurations that are out of the ordinary:
+-------------------------------------------------------------------------------+---------------+--------------------------------------------------------------------------------+
| Kea configuration case | Result | Comment |
+===============================================================================+===============+================================================================================+
| Overlapping subnets | Allowed | Administrator consideration needs to be given to how clients are matched to |
| | | these subnets. |
+-------------------------------------------------------------------------------+---------------+--------------------------------------------------------------------------------+
| Overlapping address pools in one subnet | Startup error | DHCP6_PARSER_FAIL |
+-------------------------------------------------------------------------------+---------------+--------------------------------------------------------------------------------+
| Overlapping address pools in different subnets | Allowed | Can act as a substitute for a global pool mechanic. When assigning leases from |
| | | one pool, Kea correctly excludes leases given under any pool that overlaps |
| | | with it such that no lease is given twice. |
+-------------------------------------------------------------------------------+---------------+--------------------------------------------------------------------------------+
| Address pools that are outside the subnet they are configured under | Startup error | DHCP6_PARSER_FAIL |
+-------------------------------------------------------------------------------+---------------+--------------------------------------------------------------------------------+
| Overlapping prefix delegation pools in one subnet | Startup error | DHCP6_PARSER_FAIL |
+-------------------------------------------------------------------------------+---------------+--------------------------------------------------------------------------------+
| Overlapping prefix delegation pools in different subnets | Allowed | Can act as a substitute for a global pool mechanic. When assigning leases from |
| | | one pool, Kea correctly excludes leases given under any pool that overlaps |
| | | with it such that no lease is given twice. |
+-------------------------------------------------------------------------------+---------------+--------------------------------------------------------------------------------+
| Prefix delegation pools that are outside the subnet they are configured under | Allowed | |
+-------------------------------------------------------------------------------+---------------+--------------------------------------------------------------------------------+
.. _dhcp6-std-options: .. _dhcp6-std-options:
Standard DHCPv6 Options Standard DHCPv6 Options

7
src/lib/dhcpsrv/subnet.h
View File

@@ -146,10 +146,9 @@ public:
/// ///
/// @param pool pool to be added /// @param pool pool to be added
/// ///
/// @throw isc::BadValue if the pool type is invalid, the pool /// @throw isc::BadValue if the pool type is invalid, in the case of address
/// is not an IA_PD pool and the address range of this pool does not /// pools if the address range of the pool does not match the subnet prefix,
/// match the subnet prefix, or the pool overlaps with an existing pool /// or if the pool overlaps with an existing pool within the subnet.
/// within the subnet.
void addPool(const PoolPtr& pool); void addPool(const PoolPtr& pool);
/// @brief Deletes all pools of specified type. /// @brief Deletes all pools of specified type.