1 files changed, 38 insertions, 0 deletions
diff --git a/doc/guide/admin/appendix-upgrading.sdf b/doc/guide/admin/appendix-upgrading.sdf
new file mode 100644
index 0000000..b013769
--- /dev/null
+++ b/doc/guide/admin/appendix-upgrading.sdf
@@ -0,0 +1,38 @@
+# $OpenLDAP$
+# Copyright 2007-2022 The OpenLDAP Foundation, All Rights Reserved.
+# COPYING RESTRICTIONS APPLY, see COPYRIGHT.
+
+H1: Upgrading from 2.5.x
+
+The following sections attempt to document the steps you will need to take
+in order to upgrade from the latest 2.5.x OpenLDAP version.
+
+The normal upgrade procedure, as discussed in the {{SECT:Maintenance}}
+section, should of course still be followed prior to doing any of this.
+
+H2: ppolicy overlay
+
+The pwdCheckModule option has been moved to the overlay configuration.
+Existing settings in password policy entries will be ignored. It will be
+necessary to use pwdUseCheckModule instead and add this configuration
+directive to the overlay when upgrading if it is currently in use.
+
+H2: lloadd backends
+
+Backends for lloadd are now grouped in tiers specifying the balancing
+strategy. OpenLDAP 2.5 configurations must be updated to account for this
+change.
+
+H2: monitor backend
+
+In 2.5 and prior, the managedInfo attribute in the cn=Log entry could be
+used to change the loglevel of the slapd process. In 2.6, monitorLogLevel
+can be used to change the slapd log level and monitorDebugLevel can be used
+to change the slapd debug level.
+
+H2: contrib modules
+
+If still using the lastbind overlay with olcLastBindPrecision (when
+olcLastBindForwardUpdates is needed), you will need to configure
+precision on its backend entry instead and the overlay will honour it.
+The old attribute is no longer accepted or supported.