2 # Copyright 2007-2012 The OpenLDAP Foundation, All Rights Reserved.
3 # COPYING RESTRICTIONS APPLY, see COPYRIGHT.
5 H1: Upgrading from 2.3.x
7 The following sections attempt to document the steps you will need to take in order
8 to upgrade from the latest 2.3.x OpenLDAP version.
10 The normal upgrade procedure, as discussed in the {{SECT:Maintenance}} section, should
11 of course still be followed prior to doing any of this.
13 H2: {{B:cn=config}} olc* attributes
15 Quite a few {{olc*}} attributes have now become obsolete, if you see in your logs
16 entries like below, just remove them from the relevant ldif file.
18 > olcReplicationInterval: value #0: <olcReplicationInterval> keyword is obsolete (ignored)
20 H2: ACLs: searches require privileges on the search base
22 Search operations now require "search" privileges on the "entry" pseudo-attribute of the search
23 base. While upgrading from 2.3.x, make sure your ACLs grant such privileges to all desired search
26 For example, assuming you have the following ACL:
28 > access to dn.sub="ou=people,dc=example,dc=com" by * search
30 Searches using a base of "dc=example,dc=com" will only be allowed if you add the following ACL:
32 > access to dn.base="dc=example,dc=com" attrs=entry by * search
34 Note: The {{slapd.access}}(5) man page states that this requirement was introduced
35 with OpenLDAP 2.3. However, it is the default behavior only since 2.4.