lmdb backend schema upgrade note

diff --git a/docs/changelog/5.0.rst b/docs/changelog/5.0.rst
index 09e990649197906999f4c8fc0ce6e1921aeb4380..f486f234ea43d36509aaf2fadcdfe6c74810149e 100644 (file)
--- a/docs/changelog/5.0.rst
+++ b/docs/changelog/5.0.rst
@@ -489,12 +489,6 @@ Changelogs for 5.0.x
 
     Properly finalize PKCS11 modules before releasing them
 
-  .. change::
-    :tags: New Features
-    :pullreq: 14021
-
-    LUA: make whitespace insertion on chunk combine optional
-
   .. change::
     :tags: Improvements
     :pullreq: 14011

diff --git a/docs/index.rst b/docs/index.rst
index 9f781dc76f9c458e3f6708a016bc8a8e5f7543d6..083f8aab40f8c12d619cf0f6024ab2501ed8ab4c 100644 (file)
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -24,6 +24,8 @@ Getting Started
 * :doc:`Configure the Server <settings>`
 * :doc:`Configure the backend(s) <backends/index>`
 
+.. _getting-support:
+
 Getting Support
 ---------------
 PowerDNS is an open source program so you may get help from the PowerDNS users' community or from its authors.

diff --git a/docs/upgrading.rst b/docs/upgrading.rst
index cd90382f3b971d346ef2e0dba772192c9e1d255a..b20f0e7c2d8bb7efa8b8383c2b57f4817e282cb6 100644 (file)
--- a/docs/upgrading.rst
+++ b/docs/upgrading.rst
@@ -11,6 +11,21 @@ upgrade notes if your version is older than 3.4.2.
 4.9.0 to 5.0.0/master
 ---------------------
 
+LMDB backend, views support
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Version 5.0.0-alpha1 ships a new version of the LMDB database schema (called version 6), in support of the new views feature.
+There is no downgrade process.
+If you upgrade your database (by starting 5.0.0 without setting :ref:`setting-lmdb-schema-version` to ``5``), you cannot go back.
+
+Upgrading is supported from schema version 3 and up.
+
+The implementation of views involved a massive refactoring of many parts of the code base.
+While many things have been thoroughly tested, some loose ends likely remain.
+Specifically, catalog zones have not been updated for views support at all.
+DNS Update (RFC2136) support has not been well tested with views.
+Most other things are expected to work; if you find something wrong, please :ref:`let us know <getting-support>`.
+
 LUA records whitespace insertion
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^