Issue 3812 - database config documentation
Summary: database config documentation
Status: VERIFIED FIXED
Alias: None
Product: website
Classification: Unclassified
Component: website (show other issues)
Version: unspecified
Hardware: All All
: --- normal
Target Milestone: ---
Assignee: OpenLDAP project
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2005-06-29 14:04 UTC by Raphael Ouazana
Modified: 2014-08-01 21:05 UTC (History)
0 users

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this issue.
Description Raphael Ouazana 2005-06-29 14:04:35 UTC
Full_Name: Raphael Ouazana
Version: 2.3.4
OS: Linux
URL: ftp://ftp.openldap.org/incoming/
Submission from: (NULL) (194.98.7.155)



Hi,

I didn't found any documentation about database config.
I think it should be described at least in slapd.conf(5) or a new
slapd-config(5), and maybe in admin guide or faq.

Unless it shouldn't be used...

Moreother I think slapd.d should be created either at install stage or when
specifying database config in slapd.conf or... in documentation.

Raphael Ouazana.

Comment 1 Kurt Zeilenga 2005-06-30 21:32:23 UTC
moved from Incoming to Documentation
Comment 2 SR, ESC 2005-11-10 09:06:46 UTC
http://www.mail-archive.com/openldap-devel@openldap.org/msg00106.html

summed up really nicely and succinctly what i've been wondering,
myself, for many moons. man page is non-existent (?, at least i don't
see it in my zsh completion ;) ), and i think you'll find that rather
illuminating. i certainly did.

have fun
simon

-- 
The only windows I use are in my window manager and my walls.
Comment 3 Howard Chu 2006-11-16 10:48:51 UTC
changed notes
changed state Open to Test
Comment 4 Howard Chu 2006-11-16 11:09:20 UTC
I've committed a preliminary slapd-config.5 manpage to HEAD. In 
anticipation of deleting slurpd from RE24, I have commented out all of 
the slurpd-related keywords. Most of the text is the same as in 
slapd.conf(5) but I've changed the organization to better reflect the 
actual implementation.

There may be options that I've missed. Please review and send patches / 
corrections / comments.

-- 
   -- Howard Chu
   Chief Architect, Symas Corp.  http://www.symas.com
   Director, Highland Sun        http://highlandsun.com/hyc
   OpenLDAP Core Team            http://www.openldap.org/project/

Comment 5 Raphael Ouazana 2006-12-06 17:38:55 UTC
On Jeu 16 novembre 2006 12:09, hyc@symas.com wrote:
> I've committed a preliminary slapd-config.5 manpage to HEAD. In
> anticipation of deleting slurpd from RE24, I have commented out all of
> the slurpd-related keywords. Most of the text is the same as in
> slapd.conf(5) but I've changed the organization to better reflect the
> actual implementation.
>
> There may be options that I've missed. Please review and send patches /
> corrections / comments.

Thank you very much for this work. I've only some comments.

Even if it is shown in the Examples part, I think the use of slapd.conf
and slapd.d at the same time should be explained as it is in slapd(8).

Furthermore slapd-config(5) make references to slapd-bdb(5), slapd-ldap(5)
and others but these pages use old config style. Maybe you could add in a
first time a note to indicate that users should add olc prefix to use
these directives in cn=config branch. Of course I hope every pages will be
updated one day...

Raphael Ouazana.
PS: I'm not able to see slapd-config(5) with man.cgi on the website (even
if I use OpenLDAP 2.X-Devel). Is it normal ?

Comment 6 Howard Chu 2007-02-14 03:57:55 UTC
changed state Test to Release
Comment 7 Howard Chu 2007-02-23 18:19:21 UTC
changed notes
changed state Release to Open
moved from Documentation to Web
Comment 8 Howard Chu 2007-02-23 19:27:22 UTC
It might be nice to set up an automated script to pull the updated manpages 
from CVS onto the web site.
-- 
   -- Howard Chu
   Chief Architect, Symas Corp.  http://www.symas.com
   Director, Highland Sun        http://highlandsun.com/hyc
   Chief Architect, OpenLDAP     http://www.openldap.org/project/

Comment 9 Quanah Gibson-Mount 2007-02-23 19:33:44 UTC

--On Friday, February 23, 2007 7:27 PM +0000 hyc@symas.com wrote:

> It might be nice to set up an automated script to pull the updated
> manpages  from CVS onto the web site.

>From CVS for the current primary release.  I.e., I think it would be bad if 
the manpages for 2.4 showed up right now on the website.

--Quanah



--
Quanah Gibson-Mount
Principal Software Developer
ITS/Shared Application Services
Stanford University
GnuPG Public Key: http://www.stanford.edu/~quanah/pgp.html

Comment 10 Howard Chu 2007-02-23 19:49:43 UTC
quanah@stanford.edu wrote:
> --On Friday, February 23, 2007 7:27 PM +0000 hyc@symas.com wrote:
> 
>> It might be nice to set up an automated script to pull the updated
>> manpages  from CVS onto the web site.
> 
>>From CVS for the current primary release.  I.e., I think it would be bad if 
> the manpages for 2.4 showed up right now on the website.

You'll note that the web site has a selector for the release you want to view.

In some respects I like the old pages being on there because their dates 
establish a ballpark for when a feature first appeared (well, was first 
documented). But I think we should always have a "Current" selection as well, 
that always corresponds to the latest general-use release.

-- 
   -- Howard Chu
   Chief Architect, Symas Corp.  http://www.symas.com
   Director, Highland Sun        http://highlandsun.com/hyc
   Chief Architect, OpenLDAP     http://www.openldap.org/project/

Comment 11 Howard Chu 2007-02-24 20:40:26 UTC
changed notes
changed state Open to Closed
Comment 12 Howard Chu 2009-02-17 04:45:31 UTC
moved from Web to Archive.Web
Comment 13 OpenLDAP project 2014-08-01 21:05:05 UTC
in HEAD for RE24
manpages on web site need to be updated
done