Add Known Issue [#GL 4898]

diff --git a/doc/notes/notes-9.21.1.rst b/doc/notes/notes-9.21.1.rst
index 0c91ae3e29b14afda8f4dbb918af48c4e5adfbd6..fa3dc4419289e3c9e9f605f55026494d75b231f1 100644 (file)
--- 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
-  <relnotes_known_issues>` 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 3ee19285228d8c2f17a95d9dbc2626106b958976..bc6832eced61dcd40e2ed6fd940b8112c1dc789d 100644 (file)
--- 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`