Add Known Issue [#GL 4898]

diff --git a/doc/notes/notes-9.20.2.rst b/doc/notes/notes-9.20.2.rst
index bc356073d1b49ca3c197b17f93a403f49c8b985f..6062bc95a2638ebb3523d23f6d892dd7f25b174b 100644 (file)
--- a/doc/notes/notes-9.20.2.rst
+++ b/doc/notes/notes-9.20.2.rst
@@ -98,6 +98,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`