[Pkg-nagios-changes] [pkg-lconf] 09/09: Updated README.Debian

[Markus Frosch]

This is an automated email from the git hooks/post-receive script.

lazyfrosch-guest pushed a commit to branch master
in repository pkg-lconf.

commit 2733d90dd163b91eddfa6fa2b1c814f7248a8acb
Author: Markus Frosch <markus at lazyfrosch.de>
Date:   Fri Sep 6 16:16:11 2013 +0200

    Updated README.Debian
---
 debian/README.Debian |   41 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)

diff --git a/debian/README.Debian b/debian/README.Debian
index eed9a65..b85d775 100644
--- a/debian/README.Debian
+++ b/debian/README.Debian
@@ -1,11 +1,52 @@
 lconf for Debian
 ----------------
 
+[ Setup ]
+
 Please see /usr/share/doc/lconf/ldap/ for the required LDAP schemas, initial
 LDIF data and some examples.
 
+You need a running LDAP server to use LConf, either install slapd or use your
+own one.
+
+Quick guide with slapd:
+ # apt-get install slapd
+ # dpkg-reconfigure -p low slapd     (make sure to set a proper domain,
+                                      admin dn and password)
+
+ # gzip -dc /usr/share/doc/lconf/ldap/netways.schema.ldif.gz \
+    > /tmp/netways.schema.ldif
+ # ldapadd -Y EXTERNAL -H ldapi:/// -f /tmp/netways.schema.ldif
+ # ldapadd -Y EXTERNAL -H ldapi:/// -f /usr/share/doc/lconf/ldap/base.ldif
+
+Please also see the documention on:
+ https://www.netways.org/projects/lconf/wiki
+
+[ permissions and export ]
+
+The export itself should be run under user "nagios", to avoid security issues.
+
+Example:
+ # sudo -u nagios mkdir /etc/icinga/objects/lconf
+ $ sudo -u nagios lconf-export -o /etc/icinga/objects/lconf
+
 Permissions for /etc/lconf/config.pm and /var/cache/lconf/tmp are set to
 root:nagios with 0660 or 0770. Make sure to use dpkg-statoverride when you
 need to change it!
 
+Please see /usr/share/doc/lconf/examples/ for example scripts on how to run
+an export with config testing.
+
+[ OpenLDAP sizelimit ]
+
+While exporting data, OpenLDAP might reach limits of query results very
+quickly, you should update that values to allow exporting the whole tree:
+
+ # ldapmodify -Y EXTERNAL -H ldapi:// <<END
+dn: olcDatabase={-1}frontend,cn=config
+changetype: modify
+replace: olcSizeLimit
+olcSizeLimit: unlimited
+END
+
  -- Markus Frosch <markus at lazyfrosch.de>  Fri, 6 Sep 2013 15:50:34 +0200

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-nagios/pkg-lconf.git