[Date Prev][Date Next]
[Chronological]
[Thread]
[Top]
Re: (ITS#6277) Missing documentation for cn=config
> Full_Name: Ryan Steele
> Version: 2.4.15
> OS: Ubuntu 8.04 LTD
> URL: ftp://ftp.openldap.org/incoming/
> Submission from: (NULL) (207.106.239.81)
>
>
> According to chapter 5 of the admin guide, "some of the backends and of the
> distributed overlays do not support runtime configuration yet. In those
cases,
> the old style slapd.conf(5) file must be used." However, there is no
> documentation on which backends and overlays do and don't have said support.
> Without grokking the code, it is a trial-and-error operation at best.
Point taken. I'm pretty sure they all do now. Will check and update that
section.
> Also, there is no documentation on how to add overlay-specific directives
(man
> pages or otherwise). Take, for example, autogroup-attrset; the olcAGattrSet
> directive is only described in autogroup.c, and nowhere else. This is not
the
> only instance of missing module documentation, but it should give a general
idea
> of where to look.
Some of the contribs one don't come with a man page unfortunately. Core ones
do.
I'll look into the relevant sections and add one or two examples.
> Of course, grepping the code is easy enough, but you shouldn't have to do
that
> to learn how to achieve simple configurations. If there's going to be a
> fundamental paradigm shift from slapd.conf to cn=config, there has to be
> documentation (man pages, admin guide sections, et. al.) on the appropriate
> methods for achieving what once was done through slapd.conf. IMHO, that
should
> include concrete examples, such as the following, pulled from the Courier
> documentation:
>
> The following LDIF could be used to add [the auditlog] overlay to cn=config
> (adjust to suit):
>
> dn: olcOverlay=auditlog,olcDatabase={1}hdb,cn=config
> changetype: add
> objectClass: olcOverlayConfig
> objectClass: olcAuditLogConfig
> olcOverlay: auditlog
> olcAuditlogFile: /tmp/auditlog.ldif
>
Well there are two places that talk about how to convert from slapd.conf to
cn=config formats. In the guide and man pages, so that is the best way to do a
full conversion and see the end result.
Where would you like to see these added?
Thanks for the feedback as always!
Gavin.