[Pkg-openldap-devel] [openldap] 01/01: mention db upgrades in README.Debian (#594711)

[Ryan Tandy]

This is an automated email from the git hooks/post-receive script.

rtandy-guest pushed a commit to branch master
in repository openldap.

commit 166dd253cfe3f172a679497987ee6bd989eec655
Author: Ryan Tandy <ryan at nardis.ca>
Date:   Thu Jun 19 12:59:47 2014 -0700

    mention db upgrades in README.Debian (#594711)
---
 debian/changelog           |  2 ++
 debian/slapd.README.Debian | 19 +++++++++++++++++++
 2 files changed, 21 insertions(+)

diff --git a/debian/changelog b/debian/changelog
index 504ff98..1d9550e 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -14,6 +14,8 @@ openldap (2.4.39-2) UNRELEASED; urgency=low
   * debian/rules, debian/patches/pw-sha2-makefile: Build and install the sha2 
     password module. (Closes: #746727)
   * debian/rules: Enable parallel building.
+  * debian/slapd.README.Debian: Add a note about database format upgrades and 
+    the consequences of missing one. (Closes: #594711)
 
   [ Jelmer Vernooij ]
   * Depend on heimdal-multidev rather than heimdal-dev. (Closes: #745356, 
diff --git a/debian/slapd.README.Debian b/debian/slapd.README.Debian
index 5b0ecb4..5233e98 100644
--- a/debian/slapd.README.Debian
+++ b/debian/slapd.README.Debian
@@ -200,3 +200,22 @@ Modifications Compared to Upstream
   openldap source package.
 
  -- Russ Allbery <rra at debian.org>, Thu, 14 Feb 2008 18:47:07 -0800
+
+Database format upgrades
+
+  When upgrading slapd to a new version where the Berkeley DB library's
+  storage format has changed, the database has to be backed up using
+  slapcat(8) before upgrading and restored using slapadd(8) afterwards.
+  Normally the maintainer scripts will handle this automatically,
+  performing the dump and restore as needed.
+
+  If, after upgrading, slapd fails to start and you see the message
+  "Program version doesn't match environment version" in syslog, then
+  the DB version may have changed without a dump and reload. This should
+  be reported as a bug in the slapd package. In this case you will have
+  to downgrade slapd to the previous version as the new tools are unable
+  to dump the old database, and the same error would prevent you from
+  upgrading to the fixed version. Old package versions can be
+  found at http://snapshot.debian.org if needed.
+
+ -- Ryan Tandy <ryan at nardis.ca>, Thu, 19 Jun 2014 12:51:38 -0700

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-openldap/openldap.git