xref: /netbsd-src/external/bsd/openldap/dist/doc/guide/admin/appendix-upgrading.sdf (revision 4b71a66d0f279143147d63ebfcfd8a59499a3684)
1# $OpenLDAP: pkg/openldap-guide/admin/appendix-upgrading.sdf,v 1.1.2.4 2008/02/11 23:26:39 kurt Exp $
2# Copyright 2007-2008 The OpenLDAP Foundation, All Rights Reserved.
3# COPYING RESTRICTIONS APPLY, see COPYRIGHT.
4
5H1: Upgrading from 2.3.x
6
7The following sections attempt to document the steps you will need to take in order
8to upgrade from the latest 2.3.x OpenLDAP version.
9
10The normal upgrade procedure, as discussed in the {{SECT:Maintenance}} section, should
11of course still be followed prior to doing any of this.
12
13H2: Monitor Backend
14
15Note: This is a temporary requirement and is subject to change over the next 2.4.x beta release cycle
16
17A monitor ({{slapd-monitor(5)}}) now needs a {{rootdn}} entry. If you do not have
18one, {{slapd}} will fail to start up with an error message like so:
19
20>           monitor_back_register_entry_attrs(""): base="cn=databases,cn=monitor" scope=one
21>           filter="(namingContexts:distinguishedNameMatch:=dc=example,dc=com)": unable to find entry
22>           backend_startup_one: bi_db_open failed! (1)
23>           slap_startup failed (test would succeed using the -u switch)
24
25Here is a complete {{database monitor}} example:
26
27
28>           database monitor
29>           rootdn cn=monitor
30>           rootpw change_me
31
32
33H2: {{B:cn=config}} olc* attributes
34
35Quite a few {{olc*}} attributes have now become obsolete, if you see in your logs
36entries like below, just remove them from the relevant ldif file.
37
38>           olcReplicationInterval: value #0: <olcReplicationInterval> keyword is obsolete (ignored)
39
40
41
42
43ADD MORE HERE
44
45