If you install at least openldap-2.3.35-r1 the postinstall message says: Getting started using OpenLDAP? There is some documentation available: Gentoo Guide to OpenLDAP Authentication (http://www.gentoo.org/doc/en/ldap-howto.xml) --- However if you follow the link the following message apperes over the guide: Disclaimer : This document is not valid and is not maintained anymore. --- So is it possible to follow this guide even if it is "not valid" or should this message be removed from the ebuild? At least change it to tell if there is any danger involved in following that guide or not.
I will look into updating it, talked to docs team, they're fine to keep it then
Created attachment 133513 [details] ldap-howto.xml
Created attachment 133526 [details, diff] robbat2's unfinished patch so far
jokey, Can I get you to post a diff of these changes? (use diff -Nut please) Also CCed robbat2, who promised me some months ago to update this guide. ;)
Created attachment 133527 [details] ldap-howto.xml.diff Attaching diff'ed version
I merged jokey's patch into the doc, so it now has draft status. Hopefully either jokey and/or robbat2 or someone else can fill it out, so we can bring it out of draft once more. I'd like to see an up-to-date, valid, official LDAP doc. Leaving the bug open for now, as a gentle poke to anyone with LDAP knowledge. :)
POKE to jokey and robbat2. I've been getting some muttering from enterprise/sysadmin-type folks who need to read our LDAP guides, but don't think we have a working doc, since that "draft" disclaimer is still in place. Can either of you send in some patches to get this thing finished? Thanks!
(In reply to comment #7) > POKE to jokey and robbat2. I've been getting some muttering from > enterprise/sysadmin-type folks who need to read our LDAP guides, but don't > think we have a working doc, since that "draft" disclaimer is still in place. > > Can either of you send in some patches to get this thing finished? Thanks! > Poke again. Comment #7 still stands.
Created attachment 171283 [details, diff] ldap-howto.xml.patch Hello. I created patch for ldap-howto with small fixes.
(In reply to comment #9) Sorry Azamat, the guide needs substantial fixes, fixing an URL or two doesn't lead anywhere. Thanks for your help anyway.
(In reply to comment #10) > (In reply to comment #9) > > Sorry Azamat, the guide needs substantial fixes, fixing an URL or two doesn't > lead anywhere. Thanks for your help anyway. Yeah, but everything's appreciated. I went ahead and fixed up the guide a bit. Went with the 2.3 documentation link, as 2.4 is still hardmasked.
*** Bug 272727 has been marked as a duplicate of this bug. ***
*** Bug 308947 has been marked as a duplicate of this bug. ***
(In reply to comment #11) > Yeah, but everything's appreciated. I went ahead and fixed up the guide a bit. > Went with the 2.3 documentation link, as 2.4 is still hardmasked. > OpenLDAP is rather long ago stable. But. Until the article is LDAP-howto (NOT OpenLDAP), common LDAP descriptions should refer NOT to OPEN LDAP admin guide, but to more common resources: For example X.500 RFC's: http://www.networksorcery.com/enp/protocol/x500.htm LDAP [v3] RFC: http://www.faqs.org/rfcs/rfc2251.html In addition, I think it's necessary to comment at least the most common object types. For example (not complete, but the best of I've find): Attr desc: http://www.zytrax.com/books/ldap/ape/
(In reply to comment #14) > (In reply to comment #11) > > Went with the 2.3 documentation link, as 2.4 is still hardmasked. > > > OpenLDAP is rather long ago stable. Did you look at the date of my comment? It is *two years old*. Please read the guide; since then I've changed the documentation link to 2.4. > But. Until the article is LDAP-howto (NOT OpenLDAP), common LDAP descriptions > should refer NOT to OPEN LDAP admin guide, but to more common resources: The guide is about installing OpenLDAP, not any other LDAP implementation. What's your point? If you have a patch with updates for the guide, please provide one.
Created attachment 283305 [details, diff] Patch for ldap-howto.xml including replication information and an updated configuration file Updated guide (patches). I have not started explaining some common objects or attributes in more detail, I think that is part of the OpenLDAP docs rather than within a document on OpenLDAP within Gentoo. Document can be viewed at http://dev.gentoo.org/~swift/docs/previews/ldap-howto.xml Comments always appreciated; I'll commit and close if there are none.
Created attachment 283307 [details, diff] Updated patch with correct domain names Previous patch had references to a wrong domain. The guide uses "genfic.com".
This DN is wrong: cn=ldapreader.genfic.com,dc=genfic,dc=com dc is domain component. cn=ldapreader,dc=genfic,dc=com is a straight translation to ldapreader.genfic.com
Created attachment 283395 [details, diff] Updated patch with correct ldapreader CN Thanks. Document updated to use cn=ldapreader,dc=genfic,dc=com Preview at http://dev.gentoo.org/~swift/docs/previews/ldap-howto.xml
Updated ldap-howto.xml committed. Issues or comments are still appreciated, either through e-mail, IRC or bugreports of course.