From: Miod Vallat Date: Fri, 28 Nov 2025 15:15:23 +0000 (+0100) Subject: Mention manual cleanup of no-longer-built modules if manual upgrade. X-Git-Tag: rec-5.4.0-alpha1~39^2 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=refs%2Fpull%2F16575%2Fhead;p=thirdparty%2Fpdns.git Mention manual cleanup of no-longer-built modules if manual upgrade. Fixes: #16549 Signed-off-by: Miod Vallat --- 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 ^^^^^^^^^^^^^^^^^^^