OpenLDAP
Up to top level
Build   Contrib   Development   Documentation   Historical   Incoming   Software Bugs   Software Enhancements   Web  

Logged in as guest

Viewing Documentation/5915
Full headers

From: ghenry@OpenLDAP.org
Subject: Some man pages still only talk about slapd.conf
Compose comment
Download message
State:
0 replies:
7 followups: 1 2 3 4 5 6 7

Major security issue: yes  no

Notes:

Notification:


Date: Thu, 29 Jan 2009 23:33:23 GMT
From: ghenry@OpenLDAP.org
To: openldap-its@openldap.org
Subject: Some man pages still only talk about slapd.conf
Full_Name: Gavin Henry
Version: 
OS: 
URL: ftp://ftp.openldap.org/incoming/
Submission from: (NULL) (92.41.236.102)
Submitted by: ghenry


Some discussion will be needed on the best way to talk about config. We don't
want to list everything twice for both formats...lots of slapd.conf written
throughout most (5/8) man pages.

Thanks.


Followup 1

Download message
Date: Thu, 29 Jan 2009 15:39:58 -0800
From: Howard Chu <hyc@symas.com>
To: ghenry@OpenLDAP.org
CC: openldap-its@OpenLDAP.org
Subject: Re: (ITS#5915) Some man pages still only talk about slapd.conf
ghenry@OpenLDAP.org wrote:
> Full_Name: Gavin Henry
> Version:
> OS:
> URL: ftp://ftp.openldap.org/incoming/
> Submission from: (NULL) (92.41.236.102)
> Submitted by: ghenry
>
>
> Some discussion will be needed on the best way to talk about config. We
don't
> want to list everything twice for both formats...lots of slapd.conf written
> throughout most (5/8) man pages.

I guess for this release (and probably for 2.5) we're just going to have to 
document both, as cumbersome as that will be. When we get to to 2.6/3.0 and 
drop support for slapd.conf we'll have to come back thru again and delete the 
slapd.conf references from all the docs. Unless anyone has a better idea...

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



Followup 2

Download message
From: Hallvard B Furuseth <h.b.furuseth@usit.uio.no>
Date: Fri, 30 Jan 2009 12:42:26 +0100
To: hyc@symas.com
Cc: openldap-its@openldap.org
Subject: Re: (ITS#5915) Some man pages still only talk about slapd.conf
hyc@symas.com writes:
> I guess for this release (and probably for 2.5) we're just going to
> have to document both, as cumbersome as that will be. When we get to
> to 2.6/3.0 and drop support for slapd.conf we'll have to come back
> thru again and delete the slapd.conf references from all the
> docs. Unless anyone has a better idea...

I'm not sure I see the problem, except that Someone(TM) must do the
work...

For each configuration keyword, use two headers in the manpages: Both
the slapd.conf syntax and the cn=config syntax.  Explain at the
beginning of slapd.conf.5 or slapd-config.5.  We'll be deleting most of
the other one, since they are mostly duplicates.  Other manpages need
just one-line reminder for explanation.

There'll be exceptions that spell things out too differently, or use
slightly different parameters in slapd.conf and cn=config.  Keep them in
just slapd.conf-syntax, and add a separate cn=config attribute
description below.  Likely that'll only need to explain the difference.
Don't go trough literary contortions to fit them both into the same
description.  Some of these will likely be things that could use some
cleanup in the code anyway, bringing the two config formats in sync.

Take a random sample of the slapd.conf-syntax example sections and
replace with their cn=config equivalent.  Ensure all example sections
say either "slapd.conf example" or "cn=config example".

slapd.conf.5 and slapd-config.5 themselves will need sections about how
they work as interfaces to configuration, separate from the
configuration keywords/attributes themselves.  Since we are moving
towards cn=config, I suppose it's that one which should keep the actual
keyword/attribute descriptions.  Or they could move to a third file.

-- 
Hallvard



Followup 3

Download message
Date: Wed, 4 Jan 2012 12:16:22 -0600 (CST)
From: chris@blueoxsolutions.com
To: openldap-its@openldap.org
cc: hyc@highlandsun.com
Subject: Re: (ITS#5915) Some man pages still only talk about slapd.conf
Is there any progress on this?  Speaking as a user who wanted to setup 
an ldap server so that I can combine a thunderbird and alpine address 
book in to one and perhaps export to my external memory unit (a 
semi-intelligent phone) I found the documentation on this sight (and 
others) to be very confusing.  Is there gong to be any effort to fix the 
doccumentation in the near future?  Is there a better guide by somone 
else that I can use to set up a simple address book with openldap?


-- 
========================================================================
Chris Oxenreider                   |
chris@blueoxsolutions.com          |
========================================================================
Personal



Followup 4

Download message
Date: Fri, 06 Jan 2012 16:05:12 +0100
From: Gabriele Pohl <contact@dipohl.com>
To: openldap-its@OpenLDAP.org
CC: ghenry@OpenLDAP.org
Subject: Re: (ITS#5915) Some man pages still only talk about slapd.conf
It was getting on my nerves and I had to spend a lot of time
to clear up the situation. Being a beginner in both areas
Debian Distribution and OpenLDAP-Server I entered the docs
via Quick Start and immediately stuck headover in the mud
of outdated and inconsistent docs / references..

Please add at least a note about the new configuration
method and a link to the explaining wiki page
http://www.openldap.org/doc/admin24/slapdconf2.html

in Quick-Start:
http://www.openldap.org/doc/admin24/quickstart.html

As you link to http://www.openldap.org/doc/admin24/slapdconfig.html
from there in section 8 about Configuration you should
also add a note and link there or even better add an own section
about the dynamic configuration method in Quick-Start.

Thanks in advance and cheers

Gabriele



Followup 5

Download message
Date: Fri, 06 Jan 2012 19:18:08 -0000 (GMT)
From: Gavin Henry <ghenry@OpenLDAP.org>
To: Gabriele Pohl <contact@dipohl.com>
Cc: ghenry@OpenLDAP.org, openldap-its@OpenLDAP.org
Subject: Re: (ITS#5915) Some man pages still only talk about slapd.conf
Thanks, will do!

----- Original Message -----
> It was getting on my nerves and I had to spend a lot of time
> to clear up the situation. Being a beginner in both areas
> Debian Distribution and OpenLDAP-Server I entered the docs
> via Quick Start and immediately stuck headover in the mud
> of outdated and inconsistent docs / references..
> 
> Please add at least a note about the new configuration
> method and a link to the explaining wiki page
> http://www.openldap.org/doc/admin24/slapdconf2.html
> 
> in Quick-Start:
> http://www.openldap.org/doc/admin24/quickstart.html
> 
> As you link to http://www.openldap.org/doc/admin24/slapdconfig.html
> from there in section 8 about Configuration you should
> also add a note and link there or even better add an own section
> about the dynamic configuration method in Quick-Start.
> 
> Thanks in advance and cheers
> 
> Gabriele
> 

-- 
Kind Regards,

Gavin Henry.
OpenLDAP Engineering Team.

E ghenry@OpenLDAP.org

Community developed LDAP software.

http://www.openldap.org/project/



Followup 6

Download message
Date: Mon, 19 Mar 2012 15:51:24 +0100
To: openldap-its@OpenLDAP.org
From: Bruno Schrade <bs@schwarzwald-software.de>
Subject: Re: (ITS#5915) Some man pages still only talk about slapd.conf
Cc: ghenry@OpenLDAP.org
Sehr geehrter Herr Henry,

i just moved an OpenLDAP-Server from Debian-5 to Debian-6. Expecting it would
simply run using the same configuration file i just copied slapd.conf. This
resulted in error messages along the line "missing credentials". So i looked up
the QuickStartGuide and continued debugging the authorization process - finally
found the reason and cure by reading /etc/init.d/slapd.

I would like to suggest two changes:

1  May i suggest a quick fix: add something like "don't read this" 
   to the top of the QuickStartGuide.
2  If possible change your mind on dropping slapd.conf-Support.
   - Dropping it will break existing configurations.
   - People are quite accustomed to /etc/.../.. .conf-files

I would like to add that i really appreciate the work you are doing.

Mit freundlichen Gr.ssen

Schwarzwald Software Engineering * Bruno Schrade
Theodor-Kreuz-Strasse 6 * D-79868 Feldberg * Tel. +49 (0)7655 618
http://www.schwarzwald-software.de




Followup 7

Download message
Cc: "openldap-its@OpenLDAP.org" <openldap-its@OpenLDAP.org>,
        "ghenry@OpenLDAP.org" <ghenry@OpenLDAP.org>
From: Gavin Henry <ghenry@suretecsystems.com>
Subject: Re: (ITS#5915) Some man pages still only talk about slapd.conf
Date: Mon, 19 Mar 2012 15:11:42 +0000
To: Bruno Schrade <bs@schwarzwald-software.de>
It is on the list for updating and a migration section. 

-- 
Kind Regards,

Gavin Henry.
Managing Director.

T +44 (0) 1224 279484
M +44 (0) 7930 323266
F +44 (0) 1224 824887
E ghenry@suretecsystems.com

Open Source. Open Solutions(tm).

http://www.suretecsystems.com/

Suretec Systems is a limited company registered in Scotland. Registered
number: SC258005. Registered office: 24 Cormack Park, Rothienorman, Inverurie,
Aberdeenshire, AB51 8GL.

Subject to disclaimer at http://www.suretecgroup.com/disclaimer.html




On 19 Mar 2012, at 14:51, Bruno Schrade <bs@schwarzwald-software.de>
wrote:

> Sehr geehrter Herr Henry,
> 
> i just moved an OpenLDAP-Server from Debian-5 to Debian-6. Expecting it
would simply run using the same configuration file i just copied slapd.conf.
This resulted in error messages along the line "missing credentials". So i
looked up the QuickStartGuide and continued debugging the authorization process
- finally found the reason and cure by reading /etc/init.d/slapd.
> 
> I would like to suggest two changes:
> 
> 1  May i suggest a quick fix: add something like "don't read this" 
>   to the top of the QuickStartGuide.
> 2  If possible change your mind on dropping slapd.conf-Support.
>   - Dropping it will break existing configurations.
>   - People are quite accustomed to /etc/.../.. .conf-files
> 
> I would like to add that i really appreciate the work you are doing.
> 
> Mit freundlichen Gr..ssen
> 
> Schwarzwald Software Engineering * Bruno Schrade
> Theodor-Kreuz-Strasse 6 * D-79868 Feldberg * Tel. +49 (0)7655 618
> http://www.schwarzwald-software.de
> 


Up to top level
Build   Contrib   Development   Documentation   Historical   Incoming   Software Bugs   Software Enhancements   Web  

Logged in as guest


The OpenLDAP Issue Tracking System uses a hacked version of JitterBug

______________
© Copyright 2013, OpenLDAP Foundation, info@OpenLDAP.org