From: Peter van Dijk Date: Fri, 16 Jul 2021 17:54:00 +0000 (+0200) Subject: auth 4.5 upgrade notes and settings: more words on the zone cache X-Git-Tag: dnsdist-1.7.0-alpha1~82^2 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=refs%2Fpull%2F10595%2Fhead;p=thirdparty%2Fpdns.git auth 4.5 upgrade notes and settings: more words on the zone cache --- diff --git a/docs/settings.rst b/docs/settings.rst index d15302644f..693ee3061c 100644 --- a/docs/settings.rst +++ b/docs/settings.rst @@ -1898,7 +1898,7 @@ means no restriction. Seconds to cache a list of all known zones. A value of 0 will disable the cache. -If your backends do not respond to unknown or dynamically generated zones, it is suggested to enable :ref:`setting-consistent-backends` and set this option to `60`. +If your backends do not respond to unknown or dynamically generated zones, it is suggested to enable :ref:`setting-consistent-backends` (default since 4.5) and leave this option at its default of `300`. .. _setting-zone-metadata-cache-ttl: diff --git a/docs/upgrading.rst b/docs/upgrading.rst index 8f21f5178b..51e6307907 100644 --- a/docs/upgrading.rst +++ b/docs/upgrading.rst @@ -49,15 +49,22 @@ Changed defaults - The default value of the :ref:`setting-consistent-backends` option has been changed from ``no`` to ``yes``. - The default value of the :ref:`setting-max-nsec3-iterations` option has been changed from ``500`` to ``100``. - The default value of the ``timeout`` parameter for :func:`ifportup` and :func:`ifurlup` functions has been changed from ``1`` to ``2`` seconds. +- The default value of the new :ref:`setting-zone-cache-refresh-interval` option is ``300``. + +Zone cache +~~~~~~~~~~ + +Version 4.5 introduces the zone cache. +The default refresh interval (:ref:`setting-zone-cache-refresh-interval`) is 300, meaning that zones newly added to your backend may need a few minutes to appear. +However, zones added using the API should not notice a delay. + +If your backend is dynamic in what zones it does or does not offer, and thus cannot easily provide a complete list of zones every few minutes, set the interval to 0 to disable the feature. Removed options ~~~~~~~~~~~~~~~ - :ref:`setting-local-ipv6` has been removed. IPv4 and IPv6 listen addresses should now be set with :ref:`setting-local-address`. - :ref:`setting-query-local-address6` has been removed. IPv4 and IPv6 addresses used for sending queries should now be set with :ref:`setting-query-local-address`. -Starting with auth-4.5.0-beta1: - -- The default value of the ``zone-cache-refresh-interval`` option has been changed from ``0`` to ``300``. 4.3.x to 4.4.0 --------------