* [gentoo-doc-cvs] cvs commit: ldapdns-guide.xml
@ 2005-07-25 17:19 Sven Vermeulen
0 siblings, 0 replies; 6+ messages in thread
From: Sven Vermeulen @ 2005-07-25 17:19 UTC (permalink / raw
To: gentoo-doc-cvs
swift 05/07/25 17:19:26
Added: xml/htdocs/doc/en/draft ldapdns-guide.xml
Log:
Draft for ldapdns configuration, see #67932
Revision Changes Path
1.1 xml/htdocs/doc/en/draft/ldapdns-guide.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/draft/ldapdns-guide.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/draft/ldapdns-guide.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: ldapdns-guide.xml
===================================================================
<?xml version='1.0' encoding="UTF-8"?>
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/draft/ldapdns-guide.xml,v 1.1 2005/07/25 17:19:26 swift Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/draft/ldapdns-guide.xml">
<title>Gentoo LDAP-DNS Guide</title>
<author title="Author">
<mail link="fnjordy@gmail.com">Steve-o</mail>
</author>
<author title="Editor">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
</author>
<abstract>
With ldapdns, you can provide DNS services to your network easily. The DNS
records used are stored inside an LDAP environment. This document guides you
through the configuration of OpenLDAP and ldapdns for this purpose.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
<version>0.1</version>
<date>2005-07-25</date>
<chapter>
<title>Introduction</title>
<section>
<body>
<p>
LDAPDNS is a small server that provides DNS services to your network. With DNS
services, you can manage your hostnames in a central manner deprecating the
tedious <path>/etc/hosts</path> updates every time a system is added/removed or
has changed its host name.
</p>
<p>
The LDAPDNS package uses an LDAP service to store all DNS records (which is,
simply explained, a line that contains the mapping between a hostname and an IP
address). LDAP is a standard protocol to obtain information from a
hierarchically represented knowledge base (directories). The most well-known
LDAP service for Linux is OpenLDAP, a free LDAP implementation.
</p>
<p>
With this small guide at hand, you should be able to set up DNS services on your
network with as little effort as possible.
</p>
</body>
</section>
</chapter>
<chapter>
<title>Configuring LDAP-DNS</title>
<section>
<body>
<p>
First, install <c>net-dns/ldapdns</c>.
</p>
<pre caption="Installing ldapdns">
# <i>emerge net-dns/ldapdns</i>
</pre>
<p>
Next, configure <c>ldapdns</c> to host the DNS records for your network. We use
<c>ldapdns-conf</c> which uses the following syntax:
</p>
<pre caption="Syntax for ldapdns-conf">
ldapdns-conf acct logacct /path yourip ldaphost dn [suffix]
</pre>
<table>
<tr>
<th>Keyword</th>
<th>Explanation</th>
<th>Example</th>
</tr>
<tr>
<ti>acct</ti>
<ti>Username as which ldapdns will run</ti>
<ti>ldapdns</ti>
</tr>
<tr>
<ti>logacct</ti>
<ti>Username as which the ldapdns logging will run</ti>
<ti>dnslog</ti>
</tr>
<tr>
<ti>/path</ti>
<ti>Chrooted home directory for ldapdns</ti>
<ti><path>/var/lib/ldapdns</path></ti>
</tr>
<tr>
<ti>yourip</ti>
<ti>IP address to listen to</ti>
<ti>127.0.0.1</ti>
</tr>
<tr>
<ti>ldaphost</ti>
<ti>Address of the LDAP service</ti>
<ti><c>ldapi://%2fvar%2frun%2fopenldap%2fslapd.sock</c></ti>
</tr>
<tr>
<ti>dn</ti>
<ti>LDAP login credentials</ti>
<ti>cn=Manager,dc=<c>yourdomain</c></ti>
</tr>
<tr>
<ti>suffix</ti>
<ti>Optional default ldap path to add on all queries</ti>
<ti>ou=Machines,dc=<c>yourdomain</c></ti>
</tr>
</table>
<p>
You should substitute the <c>127.0.0.1</c> IP address with an IP address that
all hosts can reach and don't forget to use the domain name you want instead of
<c>yourdomain</c>.
</p>
<pre caption="Example ldapdns-conf run">
# <i>ldapdns-conf ldapdns dnslog /var/lib/ldapdns 127.0.0.1 ldapi://%2fvar%2frun%2fopenldap%2fsldapd.sock cn=Manager,dc=yourdomain ou=Machines,dc=yourdomain</i>
</pre>
<p>
Now set the LDAP login password:
</p>
<pre caption="Setting the LDAP login password">
# <i>echo YourSecretPassword > /var/lib/ldapdns/root/password</i>
# <i>chmod 0400 /var/lib/ldapdns/root/password</i>
</pre>
<p>
Now configure ldapdns to use the simple authentication method and the cosine
LDAP schemas:
</p>
<pre caption="Configuring ldapdns">
# <i>echo simple > /var/lib/ldapdns/env/LDAP_AUTH</i>
# <i>echo cosine > /var/lib/ldapdns/env/SCHEMA</i>
</pre>
<p>
You can optionally set an e-mail address for the service:
</p>
<pre caption="Setting a host master e-mail address">
# <i>echo YourMail@address > /var/lib/ldapdns/env/HOSTMASTER</i>
</pre>
<p>
Add the service to the supervise scan and run the service supervisor if you
haven't started it already:
</p>
<pre caption="Managing supervise services">
# <i>ln -s /var/lib/ldapdns /service</i>
# <i>/etc/init.d/svscan start</i>
# <i>rc-update add svscan default</i>
</pre>
</body>
</section>
</chapter>
<chapter>
<title>Configuring OpenLDAP</title>
<section>
<body>
<p>
Now we need to configure OpenLDAP with the DNS schema. Open up
<path>/etc/openldap/sldap.conf</path> with your favorite editor and make sure
the following three lines are listed:
</p>
<pre caption="Editing /etc/openldap/sldap.conf">
include /etc/openldap/schema/cosine.schema
include /etc/openldap/schema/inetorgperson.schema
include /etc/openldap/schema/nis.schema
</pre>
<p>
Bootstrap LDAP with the base dn you defined previously with <c>ldapdns-conf</c>.
To accomplish this, we first create a file called <path>bootstrap.ldif</path>
(it is just a name) and have it contain the following information:
</p>
<pre caption="Creating bootstrap.ldif">
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 6+ messages in thread
* [gentoo-doc-cvs] cvs commit: ldapdns-guide.xml
@ 2005-09-20 18:26 swift
0 siblings, 0 replies; 6+ messages in thread
From: swift @ 2005-09-20 18:26 UTC (permalink / raw
To: gentoo-doc-cvs
swift 05/09/20 18:26:04
Modified: xml/htdocs/doc/en/draft ldapdns-guide.xml
Log:
Update from #67932
Revision Changes Path
1.2 +19 -48 xml/htdocs/doc/en/draft/ldapdns-guide.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/draft/ldapdns-guide.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/draft/ldapdns-guide.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/draft/ldapdns-guide.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: ldapdns-guide.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/draft/ldapdns-guide.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- ldapdns-guide.xml 25 Jul 2005 17:19:26 -0000 1.1
+++ ldapdns-guide.xml 20 Sep 2005 18:26:03 -0000 1.2
@@ -1,6 +1,6 @@
<?xml version='1.0' encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/draft/ldapdns-guide.xml,v 1.1 2005/07/25 17:19:26 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/draft/ldapdns-guide.xml,v 1.2 2005/09/20 18:26:03 swift Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
@@ -193,58 +193,14 @@
<p>
Bootstrap LDAP with the base dn you defined previously with <c>ldapdns-conf</c>.
To accomplish this, we first create a file called <path>bootstrap.ldif</path>
-(it is just a name) and have it contain the following information:
-</p>
-
-<pre caption="Creating bootstrap.ldif">
-dn: dc=<i>yourdomain</i>
-objectclass: dcObject
-objectclass: organization
-o: Example company
-dc: example
-
-dn: cn=Manager,dc=<i>yourdomain</i>
-objectclass: organizationalRole
-cn: Manager
-</pre>
-
-<p>
-Add DNS entries to build up a tree like this:
-</p>
-
-<pre caption="DNS tree for your domain">
-dc=example,dc=com
-`- ou=Machines
- `- dc=yourdomain
-</pre>
-
-<p>
-Now add a DNS record for the domain itself:
-</p>
-
-<pre caption="Adding attributes to dc=yourdomain,ou=Machines,dc=yourdomain">
-associatedDomain = yourdomain
-nSRecord = ns1.yourdomain
-sOARecord = n1.yourdomain YourMail@address 2004101701 1800 3600 604800 84600
-</pre>
-
-<p>
-The first number is the serial number using the YYYYMMDDNN syntax where NN is a
-counter used for multiple updates a day.
+(it is just a name) which we fill up with DNS information.
</p>
<p>
-This will give you a base tree for the domain <c>yourdomain</c>. Now add an
-entry for each machine, starting with the one for your name server itself
-(ns1.yourdomain):
+As an example, we provide a <uri link="bootstrap.ldif.txt">bootstrap.ldif</uri>
+file for a fictuous domain <c>cherchetoujours.org</c>.
</p>
-<pre caption="DNS entry for a single machine">
-dn=ns1,dc=yourdomain,ou=Machines,dc=yourdomain
- aRecord = <comment>(IP address of the system)</comment>
- associatedDomain = n1.yourdomain
-</pre>
-
<p>
Now bootstrap your LDAP with this information:
</p>
@@ -283,4 +239,19 @@
</section>
</chapter>
+<chapter>
+<title>Resources</title>
+<section>
+<body>
+
+<p>
+The <uri
+link="http://cvs.lp.se/doc/ldapdns/README.configure.gz">README.configure.gz</uri>
+file for the ldapdns project.
+</p>
+
+</body>
+</section>
+</chapter>
+
</guide>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 6+ messages in thread
* [gentoo-doc-cvs] cvs commit: ldapdns-guide.xml
@ 2006-03-25 12:15 swift
0 siblings, 0 replies; 6+ messages in thread
From: swift @ 2006-03-25 12:15 UTC (permalink / raw
To: gentoo-doc-cvs
swift 06/03/25 12:15:39
Removed: ldapdns-guide.xml
Log:
Removing ldapdns-guide.xml from this location
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 6+ messages in thread
* [gentoo-doc-cvs] cvs commit: ldapdns-guide.xml
@ 2006-11-05 10:13 Josh Saddler
0 siblings, 0 replies; 6+ messages in thread
From: Josh Saddler @ 2006-11-05 10:13 UTC (permalink / raw
To: gentoo-doc-cvs
nightmorph 06/11/05 10:13:04
Modified: ldapdns-guide.xml
Log:
typo fix, **no content change**
Revision Changes Path
1.2 xml/htdocs/doc/en/ldapdns-guide.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/ldapdns-guide.xml?rev=1.2&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/ldapdns-guide.xml?rev=1.2&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/ldapdns-guide.xml?r1=1.1&r2=1.2
Index: ldapdns-guide.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/ldapdns-guide.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- ldapdns-guide.xml 25 Mar 2006 12:14:46 -0000 1.1
+++ ldapdns-guide.xml 5 Nov 2006 10:13:04 -0000 1.2
@@ -1,6 +1,6 @@
<?xml version='1.0' encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/ldapdns-guide.xml,v 1.1 2006/03/25 12:14:46 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/ldapdns-guide.xml,v 1.2 2006/11/05 10:13:04 nightmorph Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
@@ -198,7 +198,7 @@
<p>
As an example, we provide a <uri link="bootstrap.ldif.txt">bootstrap.ldif</uri>
-file for a fictuous domain <c>cherchetoujours.org</c>.
+file for the fictitous domain <c>cherchetoujours.org</c>.
</p>
<p>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 6+ messages in thread
* [gentoo-doc-cvs] cvs commit: ldapdns-guide.xml
@ 2006-11-05 18:46 Josh Saddler
0 siblings, 0 replies; 6+ messages in thread
From: Josh Saddler @ 2006-11-05 18:46 UTC (permalink / raw
To: gentoo-doc-cvs
nightmorph 06/11/05 18:46:45
Modified: ldapdns-guide.xml
Log:
oops. real typo fix this time; last time i typoed a typo fix, sigh. no content change.
Revision Changes Path
1.3 xml/htdocs/doc/en/ldapdns-guide.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/ldapdns-guide.xml?rev=1.3&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/ldapdns-guide.xml?rev=1.3&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/ldapdns-guide.xml?r1=1.2&r2=1.3
Index: ldapdns-guide.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/ldapdns-guide.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- ldapdns-guide.xml 5 Nov 2006 10:13:04 -0000 1.2
+++ ldapdns-guide.xml 5 Nov 2006 18:46:45 -0000 1.3
@@ -1,6 +1,6 @@
<?xml version='1.0' encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/ldapdns-guide.xml,v 1.2 2006/11/05 10:13:04 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/ldapdns-guide.xml,v 1.3 2006/11/05 18:46:45 nightmorph Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
@@ -198,7 +198,7 @@
<p>
As an example, we provide a <uri link="bootstrap.ldif.txt">bootstrap.ldif</uri>
-file for the fictitous domain <c>cherchetoujours.org</c>.
+file for the fictitious domain <c>cherchetoujours.org</c>.
</p>
<p>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 6+ messages in thread
* [gentoo-doc-cvs] cvs commit: ldapdns-guide.xml
@ 2008-05-02 4:24 Joshua Saddler
0 siblings, 0 replies; 6+ messages in thread
From: Joshua Saddler @ 2008-05-02 4:24 UTC (permalink / raw
To: gentoo-doc-cvs
nightmorph 08/05/02 04:24:03
Modified: ldapdns-guide.xml
Log:
some path fixes for bug 220007. some were in <pre>s, so i revbumped the doc too.
Revision Changes Path
1.6 xml/htdocs/doc/en/ldapdns-guide.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/ldapdns-guide.xml?rev=1.6&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/ldapdns-guide.xml?rev=1.6&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/ldapdns-guide.xml?r1=1.5&r2=1.6
Index: ldapdns-guide.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/ldapdns-guide.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- ldapdns-guide.xml 29 Nov 2006 15:48:57 -0000 1.5
+++ ldapdns-guide.xml 2 May 2008 04:24:03 -0000 1.6
@@ -1,6 +1,6 @@
<?xml version='1.0' encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/ldapdns-guide.xml,v 1.5 2006/11/29 15:48:57 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/ldapdns-guide.xml,v 1.6 2008/05/02 04:24:03 nightmorph Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
@@ -24,8 +24,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>0.2</version>
-<date>2006-03-25</date>
+<version>0.3</version>
+<date>2008-05-01</date>
<chapter>
<title>Introduction</title>
@@ -128,7 +128,7 @@
</p>
<pre caption="Example ldapdns-conf run">
-# <i>ldapdns-conf ldapdns dnslog /var/lib/ldapdns 127.0.0.1 ldapi://%2fvar%2frun%2fopenldap%2fsldapd.sock cn=Manager,dc=yourdomain ou=Machines,dc=yourdomain</i>
+# <i>ldapdns-conf ldapdns dnslog /var/lib/ldapdns 127.0.0.1 ldapi://%2fvar%2frun%2fopenldap%2fslapd.sock cn=Manager,dc=yourdomain ou=Machines,dc=yourdomain</i>
</pre>
<p>
@@ -180,11 +180,11 @@
<p>
Now we need to configure OpenLDAP with the DNS schema. Open up
-<path>/etc/openldap/sldap.conf</path> with your favorite editor and make sure
+<path>/etc/openldap/slapd.conf</path> with your favorite editor and make sure
the following three lines are listed:
</p>
-<pre caption="Editing /etc/openldap/sldap.conf">
+<pre caption="Editing /etc/openldap/slapd.conf">
include /etc/openldap/schema/cosine.schema
include /etc/openldap/schema/inetorgperson.schema
include /etc/openldap/schema/nis.schema
--
gentoo-doc-cvs@lists.gentoo.org mailing list
^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2008-05-02 4:24 UTC | newest]
Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2006-11-05 10:13 [gentoo-doc-cvs] cvs commit: ldapdns-guide.xml Josh Saddler
-- strict thread matches above, loose matches on Subject: below --
2008-05-02 4:24 Joshua Saddler
2006-11-05 18:46 Josh Saddler
2006-03-25 12:15 swift
2005-09-20 18:26 swift
2005-07-25 17:19 Sven Vermeulen
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox