diff --git a/doc/notes/notes-9.21.1.rst b/doc/notes/notes-9.21.1.rst index 0c91ae3e29..fa3dc44192 100644 --- a/doc/notes/notes-9.21.1.rst +++ b/doc/notes/notes-9.21.1.rst @@ -122,6 +122,12 @@ Bug Fixes Known Issues ~~~~~~~~~~~~ -- There are no new known issues with this release. See :ref:`above - ` for a list of all known issues affecting this - BIND 9 branch. +- Long-running tasks in offloaded threads (e.g. the loading of RPZ zones + or processing zone transfers) may block the resolution of queries + during these operations and cause the queries to time out. + + To work around the issue, the ``UV_THREADPOOL_SIZE`` environment + variable can be set to a larger value before starting :iscman:`named`. + The recommended value is the number of RPZ zones (or number of + transfers) plus the number of threads BIND should use, which is + typically the number of CPUs. :gl:`#4898` diff --git a/doc/notes/notes-known-issues.rst b/doc/notes/notes-known-issues.rst index 3ee1928522..bc6832eced 100644 --- a/doc/notes/notes-known-issues.rst +++ b/doc/notes/notes-known-issues.rst @@ -14,4 +14,12 @@ Known Issues ------------ -- There are no known issues affecting this BIND 9 branch. +- Long-running tasks in offloaded threads (e.g. loading RPZ zones or + processing zone transfers) may block the resolution of queries during + these operations and cause the queries to time out. + + To work around the issue, the ``UV_THREADPOOL_SIZE`` environment + variable can be set to a larger value before starting :iscman:`named`. + The recommended value is the number of RPZ zones (or number of + transfers) plus the number of threads BIND should use, which is + typically the number of CPUs. :gl:`#4898`