From 32a73d92f36bf82f4da2d3fab93a3e33749f9eb4 Mon Sep 17 00:00:00 2001 From: Miod Vallat Date: Fri, 28 Nov 2025 16:15:23 +0100 Subject: [PATCH] Mention manual cleanup of no-longer-built modules if manual upgrade. Fixes: #16549 Signed-off-by: Miod Vallat --- docs/upgrading.rst | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/docs/upgrading.rst b/docs/upgrading.rst index a44dbe48ca..bd56ea6e7a 100644 --- a/docs/upgrading.rst +++ b/docs/upgrading.rst @@ -28,6 +28,25 @@ representation than expected. 4.9.0 to 5.0.0 -------------- +Leftover backend module files +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Until version 5.0.0, built-in backend modules also had a matching dynamic +module being built. From version 5.0.0 onwards, this is no longer the case, +but if not upgrading with a package manager, unless files from previous versions +are manually removed, the Authoritative server will try to load these old +files anyway, and fail. + +In this case, it is recommended that you run:: + + rm /usr/local/lib/pdns/lib*.so + +(substituting the appropriate PowerDNS installation directory to ``/usr/local``) +prior to the installation. +Or you can inspect the contents of this directory after installation and +remove the files which are not present in version 5.0.0, based on their +timestamps. + LMDB backend, views ^^^^^^^^^^^^^^^^^^^ -- 2.47.3