From: bert hubert <bert.hubert@netherlabs.nl>
Date: Sun, 8 Oct 2017 11:41:50 +0000 (+0200)
Subject: add note on how you can't replace the sqlite3 database file while powerdns is running... 
X-Git-Tag: rec-4.1.0-rc2~52^2
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=694bb03d314ff02d43be6ac68e97376e35b720d6;p=thirdparty%2Fpdns.git

add note on how you can't replace the sqlite3 database file while powerdns is running. Also strenghten sqlite3 analyze remark.
---

diff --git a/docs/backends/generic-sqlite3.rst b/docs/backends/generic-sqlite3.rst
index d04e4f3272..d3904921da 100644
--- a/docs/backends/generic-sqlite3.rst
+++ b/docs/backends/generic-sqlite3.rst
@@ -13,7 +13,7 @@ Generic SQLite 3 backend
 
 .. warning::
   When importing large amounts of data, be sure to run
-  ``analyze;`` afterwards as SQLite3 has a tendency to use sub-optimal
+  ``analyze;`` afterwards as SQLite3 has a tendency to use very sub-optimal
   indexes otherwise.
 
 This backend retrieves all data from a SQLite database, which is an
@@ -40,6 +40,12 @@ with data. The default setup conforms to the following schema:
 This schema contains all elements needed for master, slave and
 superslave operation.
 
+.. warning::
+  It is not possible to replace the sqlite3 database file while PowerDNS is
+  running. Specifically, using ``rsync`` to distribute sqlite3 databases
+  does not work without stopping PowerDNS first and restarting it after the
+  change.
+
 After you have created the database you probably want to fill it with
 data. If you have a BIND zone file it's as easy as:
 ``zone2sql --named-conf=/path/to/named.conf --gsqlite | sqlite3 powerdns.sqlite3``,