From: Howard Chu <hyc@openldap.org>
Date: Sat, 19 Feb 2011 00:05:47 +0000 (+0000)
Subject: ITS#6836 conversion notes from Andrew Findlay
X-Git-Tag: MIGRATION_CVS2GIT~69
X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=b9c7e4b0ce734c1b2057ee0e6633c4157600c3ee;p=openldap

ITS#6836 conversion notes from Andrew Findlay
---

diff --git a/doc/guide/admin/slapdconf2.sdf b/doc/guide/admin/slapdconf2.sdf
index e5295cccac..256a25d7e9 100644
--- a/doc/guide/admin/slapdconf2.sdf
+++ b/doc/guide/admin/slapdconf2.sdf
@@ -26,8 +26,8 @@ configuration database normally resides in the
 directory (or file) can be specified via a command-line option to
 {{slapd}}(8).
 
-This chapter briefly discusses converting to the new style configuration,
-then describes the general format of the configuration system, followed by
+This chapter
+describes the general format of the configuration system, followed by
 a detailed description of commonly used config settings.
 
 Note: some of the backends and of the distributed overlays
@@ -1103,11 +1103,26 @@ E: 52.    olcAccess: to * by users read
 
 H2: Converting old style {{slapd.conf}}(5) file to {{cn=config}} format
 
+Before converting to the {{cn=config}} format you should make sure that the
+config backend is properly configured in your existing config file.
+If you do not already have a {{EX:database config}} section, add something
+like this to the end of {{EX:slapd.conf}}
+
+> database config
+> 
+> rootdn "cn=config"
+> rootpw secret
+
 An existing {{slapd.conf}}(5) file can be converted to the new format using
 {{slaptest}}(8) or any of the slap tools:
 
 >	slaptest -f /usr/local/etc/openldap/slapd.conf -F /usr/local/etc/openldap/slapd.d
 
+Test that you can access entries under {{EX:cn=config}} using the {{rootdn}}
+and {{rootpw}} configured above:
+
+>	ldapsearch -x -D cn=config -w secret -b cn=config
+
 You can then discard the old {{slapd.conf}}(5) file. Make sure to launch
 {{slapd}}(8) with the {{-F}} option to specify the configuration directory.