Changes between Version 76 and Version 77 of KeaKnownIssues


Ignore:
Timestamp:
Aug 2, 2018, 8:35:31 PM (11 months ago)
Author:
vicky
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • KeaKnownIssues

    v76 v77  
    1 = Known Issues in Kea =
    2 
    3 == Kea master ==
    4 
    5 * When interface re-detection is enabled and an incorrect configuration (for instance because it uses a disappearing interface in a subnet definition) is loaded the load fails leaving interface sockets closed.
    6 
    7 == Kea 1.4.0 ==
    8 
    9 * A new High Availability feature introduces a mechanism to synchronize leases between partners. If there is a large (on the order of hundreds of thousands) number of leases to by synced, the amount of time it takes for the server to fully transmit the database may be higher than then timeout. As a result, an attempt to sync large database may timeout even though the partner is alive and responding. This limitation can be worked around by changing the timeout values in src/lib/config/timeouts.h and recompiling. HA improvements are expected in 1.5.
    10 
    11 * The table 8.2. " List of standard DHCP option types" in the Kea Administrator Reference Manual includes '''hex''' as a supported option type. The type name provided in the document is wrong. The '''binary''' type should be used in configuration to define options for which values are specified as a string of hexadecimal digits.
    12 
    13 * The Kea configuration example file for High Availability (doc/examples/kea4/ha-load-balancing-primary.json) includes extraneous comma sign at the end of line 218. This causes the server to reject this configuration and consequently the server fails to start. Removing the culprit comma sign from this configuration resolves the problem.
    14 
    15 * The Kea configuration example file for High Availability (doc/examples/kea4/ha-load-balancing-primary.json) includes logger configuration for the High Availability library at line 215. The name of the logger "kea-dhcp4.ha_hooks" is wrong and should be modified to "kea-dhcp4.ha-hooks". Starting the server with wrong logger name would succeed, but the logger configuration for the HA library will have no effect.
    16 
    17 * The unit-tests for Forensic Logger, a premium hook library, incorrectly construct expected log file name on first through ninth day of each month. As a result, the unit-tests incorrectly signal a non-existing problem. This is only a unit-test issue and does not affect production code. For fix of this problem, see #5666.
    18 
    19 == Kea 1.4.0-beta ==
    20 * The Kea configuration example file for High Availability (doc/examples/kea4/ha-load-balancing-primary.json) includes extraneous comma signs at the end of lines 56 and 218. This causes the server to reject this configuration and consequently the server fails to start. Removing the culprit comma signs from this configuration resolves the problem.
    21 
    22 == Kea 1.3.0 ==
    23 
    24 == Kea 1.2.0 ==
    25 
    26 * Two scripts used to update databases schemes to newest versions {{{src/share/database/scripts/mysql/upgrade_5.0_to_5.1.sh}}} and {{{src/share/database/scripts/pgsql/upgrade_3.0_to_3.1.sh}}} are not installed during the installation process. They should be manually copied from the tarball to {{{{kea_installation_directory}/share/kea/scripts/mysql}}} and {{{{kea_installation_directory}/share/kea/scripts/pgsql}}}
    27 * The DHCPv4, DHCPv6 and D2 daemons are not able to parse a Control Agent section (#5176) in their configuration file. As a simple work around, please keep the Control Agent configuration in a separate file.
    28 * By default, Kea does not join and listen the All_DHCP_Servers multicast address used by the DHCPv6 relays (See ticket #4539). The workaround is to configure DHCPv6 relays with the server (unicast) address(es).
    29 * The following unit-tests may fail on some systems: DStubControllerTest, !NameChangeTransactionTest (6 tests), !DnsClientTest (4 tests), D2UpdateMgr (4 tests), QueueMgrUDPTest (2 tests) and D2ProcessTest (6 tests). The issues are believed to be problems with the unit-tests, not with the production code issues. Over 4000 of remaining tests will pass. If you see any of those tests fail, you may wish to rebuild using the boost-system library (specify --with-boost-libs=lboost-system when running {{{configure}}}) or without optimization (Set the CXXFLAGS environment variable to -O0 before running {{{configure}}}).
    30 * Several unit-tests may fail on systems with kernels that do not support the SO_REUSEPORT socket option. One example of such system is !RedHat Enterprise Linux 6.4 or earlier. This is considered a minor flaw in the tests and should not affect production code.
    31 
    32 == Kea 1.2.0-beta ==
    33 
    34 * When Kea-shell is enabled (--enable-shell) and installation is done to default directory (no --prefix specified), kea-shell will install, but will not work. To work around the issue, please use --prefix=/usr/local if you want to install to the default directory (#5214).
    35 * DHCPv4, DHCPv6 and D2 daemons are not able to parse Control Agent section (#5176). As a simple work around, please keep CA configuration in a separate file.
    36 * Kea doesn't join and listen the All_DHCP_Servers multicast address used by DHCPv6 relays by default (See ticket #4539). The workaround is to configure DHCPv6 relays with server (unicast) address(es).
    37 * The following unit-tests may fail on some systems: !HttpListenerTest (3 tests), DStubControllerTest, !NameChangeTransactionTest (6 tests), !DnsClientTest (4 tests), D2UpdateMgr (4 tests), QueueMgrUDPTest (2 tests) and D2ProcessTest (6 tests). The issues are believed to be unit-test issues, not production code issues. Over 4000 of remaining tests will pass. If you see any of those tests fail, you may wish to rebuild either using --with-boost-libs=lboost-system or without optimization (-O0).
    38 * Several unit-tests may fail on systems with kernels that do not support SO_REUSEPORT socket option. One example of such system is RedHat Enterprise Linux 6.4 or earlier. This is consider a minor flaw in the tests and should not affect production code.
    39 
    40 == Kea 1.1.0-beta, 1.1.0 (final) ==
    41 
    42 * When Kea is compiled with unit tests and the --with-dhcp-mysql configuration option is specified, the "mysql.host_reservation-upgrade" unit test may fail on some systems. The test misinterprets output from a MySQL query. This is considered a test bug.
    43 
    44 * Kea doesn't join and listen the All_DHCP_Servers multicast address used by DHCPv6 relays by default (See ticket #4539). The workaround is to configure DHCPv6 relays with server (unicast) address(es).
    45 
    46 * Kea doesn't handle missing hooks libraries information correctly during the reconfiguration process. If Kea has one or more hooks libraries loaded and the hooks-libraries element is removed from the configuration file, a reconfiguration will not unload the libraries.  The workaround is to keep the hooks-libraries element in the configuration file, but specify it as an empty list, i.e. {{{"hooks-libraries": [{ }] }}}. (See ticket #3998.)
    47 
    48 * Configuration option --disable-rpath is not working. Binaries always have hard coded RPATH value. See #3738 for details.
    49 
    50 * The option code used in the examples for classification in V6 is incorrect.  It should be 1 (client-id) instead of 2 (server-id).  The examples affected are in sections 8.2.17, 12.4 and 12.5.
    51 
    52 * Compilation with gcc 5 is still somewhat fragile: the boost version is not reported properly (#4242) and this may lead to compilation issues.
    53 
    54 * Compilation on Ubuntu 15.10 x64 with gcc-4.9 fails. The reason is to be investigated (#4244).
    55 
    56 
    57 == Kea 1.0.0-beta, 1.0.0 (final) ==
    58 
    59 * Kea doesn't handle missing hooks libraries information correctly during the reconfiguration process. If Kea has one or more hooks libraries loaded and the hooks-libraries element is removed from the configuration file, a reconfiguration will not unload the libraries.  The workaround is to keep the hooks-libraries element in the configuration file, but specify it as an empty list, i.e. {{{"hooks-libraries": [{ }] }}}. (See ticket #3998.)
    60 
    61 * Kea doesn't handle missing lease database configuration properly. See ticket #3696. When the lease database configuration is missing, Kea will try to run but the server will produce errors on each attempt to access the database. The workaround: always make sure that the lease database configuration is specified.
    62 
    63 * Storing host reservation information in MySQL is supported just for DHCP v4.
    64 
    65 * Static reservation of multiple IPv6 addresses or multiple IPv6 prefixes is not supported.
    66 
    67 * Configuration option --disable-rpath is not working. Binaries always have hard coded RPATH value. See #3738 for details.
    68 
    69 * The option code used in the examples for classification in V6 is incorrect.  It should be 1 (client-id) instead of 2 (server-id).  The examples affected are in sections 8.2.17, 12.4 and 12.5.
    70 
    71 * Compilation with gcc 5 is still somewhat fragile: one of the unit-tests in libdhcp_ddns may fail, depending on optimization used (see ticket #4243) and boost version is not reported properly (#4242).
    72 
    73 * Compilation on Ubuntu 15.10 x64 with gcc-4.9 fails. The reason is to be investigated (#4244).
    74 
    75 * Creating host reservations in DHCPv4 using client identifier (or DUID) is currently not supported but the configuration parsing code will accept the "duid" parameter in the reservation configuration. The server misinterprets the value specified for this parameter, so it MUST NOT be used until the client identifier based host reservations are properly implemented and documented.
    76 
    77 == Kea 0.9.2 ==
    78 
    79 * Kea doesn't handle missing hooks libraries information correctly during the reconfiguration process. If Kea has one or more hooks libraries loaded and the hooks-libraries element is removed from the configuration file, a reconfiguration will not unload the libraries.  The workaround is to keep the hooks-libraries element in the configuration file, but specify it as an empty list, i.e. {{{"hooks-libraries": []}}}. (See ticket #3998.)
    80 
    81 * Kea doesn't handle missing lease database configuration properly. See ticket #3696. When the lease database configuration is missing, Kea will try to run but the server will produce errors on each attempt to access the database. The workaround: always make sure that the lease database configuration is specified.
    82 
    83 * Even though the MySQL schema has been updated, storing host reservation information in MySQL is not supported yet. Host reservations can only be defined in the Kea configuration file.
    84 
    85 * Static reservation of multiple IPv6 addresses or multiple IPv6 prefixes is not supported.
    86 
    87 * Configuration option --disable-rpath is not working. Binaries always have hard coded RPATH value. See #3738 for details.
    88 
    89 == Kea 0.9.2-beta ==
    90 
    91 * Kea doesn't handle missing lease database configuration properly. See ticket #3892. When the lease database configuration is missing, Kea will try to run but the server will produce errors on each attempt to access the database. The workaround: always make sure that the lease database configuration is specified.
    92 
    93 * Even though the MySQL schema has been updated, storing host reservation information in MySQL is not supported yet. Host reservations can only be defined in the Kea configuration file.
    94 
    95 * Kea developer's guide contains some outdated sections. See #3484 and #3485 for details.
    96 
    97 * Static reservation of multiple IPv6 addresses or multiple IPv6 prefixes is not supported.
    98 
    99 * Configuration option --disable-rpath is not working. Binaries always have hard coded RPATH value. See #3738 for details.
    100 
    101 * When using the beta tarball, the -W feature for tools will report wrong build information. Consult your config.report file in the source tree instead. See ticket #3929 for details.
    102 
    103 == Kea 0.9.1 ==
    104 
    105 * The kea-admin script does not support upgrading the lease file from 0.9 to 0.9.1 yet. See #3601 for details.
    106 
    107 * Server configuration allows for reserving the same address for multiple hosts (clients). See #3652 for details.
    108 
    109 * Kea developer's guide contains some outdated sections. See #3484 and #3485 for details.
    110 
    111 * The JSON-based configuration file needs to be updated when migrating from 0.9
    112 
    113 * The MySQL/PostgreSQL lease databases (if used) need to be updated when migrating from 0.9.
    114 
    115 * Storing host reservation information in MySQL is not supported yet. Host reservations can only be defined in the Kea configuration file.
    116 
    117 * Static reservation of multiple IPv6 addresses or multiple IPv6 prefixes is not supported.
    118 
    119 * Configuration option --disable-rpath is not working. Binaries always have hard coded RPATH value. Seee #3738 for details.
    120 
    121 == Kea 0.9.1 beta1 ==
    122 
    123 * The JSON-based configuration file needs to be updated when migrating from 0.9
    124 
    125 * The MySQL/PostgreSQL lease databases (if used) need to be updated when migrating from 0.9.
    126 
    127 * With PostgreSQL enabled (./configure --with-dhcp-pgsql), two unit-tests (!PgSqlLeaseMgrTest.maxDate4 and !PgSqlLeaseMgrTest.maxDate6) are failing on some systems (they fail on our automated build system, but pass on similar system when run manually). The root cause is not investigated yet. See #3673 for details.
    128 
    129 * Storing host reservation information in MySQL is not supported yet.
    130 
    131 * Configuration for host reservations allows for reserving a hostname for the client, but this setting is ignored.
    132 
    133 * Reservation of multiple IPv6 addresses or multiple IPv6 prefixes is not supported.
    134 
    135 * Extracting MAC address information from link-layer IPv6 address is not working as expected. See #3691 for details.
    136 
    137 * Configure option --disable-rpath is not working. Binaries always have hard coded RPATH value. See #3738 for details.
    138 
    139 == Kea 0.9 ==
    140 
    141 * We need to audit our handling of administrative passwords. See ticket 3645 for example. Currently there are some areas where the MySQL or Kea admin password could be exposed.
    142 
    143 * The admin scripting may not be entirely compatible across scripting systems. We have been using BASH, which has some enhancements not included in vanilla SSH
    144 
    145 * The default Kea configuration file kea.conf contains an invalid example of the IPv4 pool declaraion - see ticket #3538 for details.
    146 
    147 * The kea.conf file contains invalid logger configuration; it specifies the configuration for the logger called "kea" whereas it should have 3 logger entries for "kea-dhcp4", "kea-dhcp6" and "kea-dhcp-ddns"
    148 
    149 * Kea Administrator Reference Manual, section 1.1 is out of date. Kea is tested on many recent OS versions, including Mac OS X 10.9.4, FreeBSD 10 and Ubuntu 13.10. It does not, however, compile on older Solaris 10.
    150 
    151 * Kea Administrator Reference Manual, section 10.1 about logging configuration is broken - see ticket #3536 for details.
    152 
    153 * Before upgrading from Kea 0.8, make sure you understand that configuration has changed (bindctl is no longer used, and configuration is stored in JSON files).
    154 
    155 * It is possible to configure DDNS to listen on an insecure interface. (If you do this there will be a warning message in the log) See issue #3514 for details.
    156 
    157 * Host reservation and client classification are not supported yet. Support for those features are planned.
    158 
    159 * Kea's DDNS daemon is using DHCID records to store hosts' identity. Older versions of ISC DHCP used TXT records for that purpose. Migration from TXT-based to DHCID-based zones may cause issues.
    160 
    161 For the full list of open bugs and requests, see http://kea.isc.org/report.
    162 
    163 For DHCPv4 server limitations, see http://kea.isc.org/docs/kea-guide.html#dhcp4-limit.
    164 
    165 For DHCPv6 server limitations, see http://kea.isc.org/docs/kea-guide.html#dhcp6-limit.
    166 
    167 
    168 == Kea 0.9 beta1 ==
    169 This version of Kea is a first stand-alone (without BIND10 framework) release.
    170 
    171 * Before upgrading from Kea 0.8, make sure you understand that configuration has changed (bindctl is no longer used, and configuration is stored in JSON files).
    172 
    173 * There is one unit-test (!IfaceMgrTest.detectIfaces) that fails on !RedHat 6.4 when run on a host system that runs KVM virtualization software. See #3517 for details.
    174 
    175 * It is possible to configure DDNS to listen on an insecure interface. (If you do this there will be a warning message in the log) See issue #3514 for details.
    176 
    177 * Host reservation and client classification are not supported yet. Support for those features are planned.
    178 
    179 For the full list of open bugs and requests, see http://kea.isc.org/report.
    180 
    181 For DHCPv4 server limitations, see http://kea.isc.org/docs/kea-guide.html#dhcp4-limit.
    182 
    183 For DHCPv6 server limitations, see http://kea.isc.org/docs/kea-guide.html#dhcp6-limit.
    184 
    185 == Kea 0.8 (BIND10 1.2.0) ==
    186 The version of Kea 0.8 included in BIND 1.2.0 is an engineering snapshot and intended for experimental use only.  The current list of known defects in Kea can be found [http://kea.isc.org/query?status=accepted&status=assigned&status=new&status=reopened&status=reviewing&subproject=DHCP&type=defect&col=id&col=summary&col=type&col=priority&col=component&col=time&order=id here].
    187 
    188 Significant known issues with the DHCP servers in this release are:
    189 
    190 * The DHCP servers do not yet use the "socket creator" to bind to privileged ports.  As a result, to use Kea DHCP, BIND 10 must be started by root (or via "sudo").
    191 
    192 * BIND 10 configuration mechanism doesn't handle partial configuration of map elements. When the new value is being set for one of the elements of the map, the existing values for other elements of this map are lost. This means, that the user must always configure all elements of the map. Some maps for which this issue can be observed: Dhcp4/lease-database, Dhcp6/lease-database and maps in !DhcpDdns module.
    193 
    194 * Memfile lease database backend doesn't yet differentiate between different lease types, e.g. IA_NA and IA_PD. When a client requests both assignment of a non temporary address and a prefix, and the IA_NA and IA_PD options sent by the client happen to have the same IAID, one of the two: address or prefix returned will be invalid.
    195 
    196 * Support for operating systems other than Linux is partial. Kea lacks the capability to send DHCPv4 responses to directly connected clients. This affects all BSD systems, including Mac OS X. Kea is currently being tested on Linux only.
    197 
    198 We would appreciate feedback on usability and reports of any DHCP bugs.  Please contribute your experiences to the Kea users mailing list: https://lists.isc.org/mailman/listinfo/kea-users2
     1See [Gitlab]https://gitlab.isc.org/isc-projects/kea/wikis/known-issues-list