---

ldapconf.sgml

Go to the documentation of this file.

<!doctype linuxdoc system>
<article>
<title>LDAPconf General
<author>Introduction
<p>
<url url="index.html" name="Index">
<p>
LDAPconf is a frontend for the <bf>openldap</bf> package. It is really multiple frontends, designed with different usage areas in mind. Currently, it contains development version of the following frontends:
<p>
<itemize>
<item>Client config - for configuration of the localhost openldap client tools: ldapsearch, ldapmodify etc. (works well).
<item>Server config - for configuration and control of an openldap server running on the localhost. (works partly).
<item>Directory config - for configuration and operation of directories. (works partly).
<item>User client - allowing local users to update their personal info. (works partly).
<item>System client - configuration of nss/pam system. (LDAP setp works for client, pam/nss config should not be used).
<item>Userconf co-manager - extra userinfo for unix users. (works partly).
<item>Adressbook for contacts - (works partly).
</itemize>

<p>LDAPconf is designed to support the frontends independenly. It is also designed with multiple "virtual" services in mind, so all directories are configured as independantly as possible. One conseqence of this is that all ldapconf configuration files is stored outside the openldap configuration directory. Instead of storing the directory (database) configuration inside the slapd.conf file, it will include the configuration files with the include directive in slapd.conf. This makes a more "cleaner" configuration IMHO, and also enable the support for "dropin" configurations, where pre-defined databases may be dropped into ldapconf. This may sound a bit unusual, so comments on this strategy is welcome.
<p>

<sect>Installation
<sect1>General
<p>To use the client mode of ldapconf you need the openldap package.
<p>To use the server mode of ldapconf you need the openldap-server package.
<p>To use the system client mode of ldapconf you need the pam-ldap and nss-ldap packages.
<p>In all cases you need linuxconf installed.
<p>You don't need any other packages for ldapconf to work.
<p>All guides are based on rpm installation of packages, you may of course compile from sources and install by hand, but be aware that default locations for configuration files is based on the rpm versions, so you have to compile with the same options as the rpm or you may reconfigure this in linuxconf after installation of ldapconf. The same goes for the binary locations, they may be reconfigured.
<p>Needed OpenLDAP RPM's are available from the RedHat Contrib Area. OpenLDAP>=1.2.3 recommended.
<p>Linuxconf is available from ftp.solucorp.qc.ca/linuxconf/.
</sect1>
<sect1>Installing ldapconf
<p>Grab the RPM package, and run "rpm -Uvh ldapconf-x.y.z.rpm".
<p>This will install the module in the linuxconf module directory, and enable it.
<p>Also it will install a configuration directory in /etc/ldapconf, where most directory configuration and all form and bind profiles will be stored.
<p>You may disable the module with linuxconf --unsetmod ldapconf, or uninstall it completly with rpm -e ldapconf. Uninstalling will probably zap all your ldapconf configuration files, disabling the module will not.   
</sect1>

<sect1>Installing openldap client
<p>Just install the package with "rpm -Uvh openldap-1.2.x.rpm".
<p>This will install the needed client binaries (in /usr/bin and /usr/sbin), and a openldap configuration directory in /etc/ldap/
</sect1>

<sect1>Installing openldap server
<p>Just install the package with "rpm -Uvh openldap-server-1.2.x.rpm".
<p>This will install the server binaries, and some more configuration files in /etc/ldap. 
</sect1>

</sect>

<sect>Usage
<p>Linuxconf
<p>Ldapconf will currently show up in:
<itemize>
<item>Config->Client->LDAP client
<item>Config->Server->LDAP server
<item>Control->Panel->LDAP control
<item>Status->Misc->LDAP status
</itemize>

<p>The mainmenu, including unstable menus, will show up in Config->Misc->LDAP
<p>Standalone
<p>You may use ldapconf in standalone mode. Start it by typing "ldapconf" at the commandline, and a ldapconf main menu will show up. 
<p>HTML client mode
<p>The client tools may be accessed in HTML mode from ordinary users. 
This tools are available from the "Special links to linuxconf" on the main menu (before you login to linuxconf).

<sect>Concept
<p>The functionality in ldapconf has been divided beetween three different tasks:</p>

<p>
LDAP client
<p>
The client mode is available for ordinary users.
You can configure the default settings, and there are also some small client applications available.
<p>
You need the openldap package to use the ldapconf client mode.

<P>
LDAP server
<P>
This is for running a LDAP directory server. 
You can configure the global server settings.
You can configure one database directory.
<p>
You need the openldap-server package to use the ldapconf server mode.
<P>
LDAP system
<P>
This is when the system uses LDAP to retrive NIS type information or PAM authentication from an LDAP server. 
<p>
Currently this not recomended on production machines.
<p>
You need the ldapns package and maybe openldap-devel to use the ldapconf system mode.
</sect>

<sect>General LDAP info
<p>
Definitions
    <itemize>
    <item>LDAP server - Distributes LDAP directories.
    <item>LDAP client - Access LDAP directories. 
    <item>LDPA system - Using LDAP client to resolve system files.
    </itemize>

<p> 
    The OpenLDAP package: <url url="http://www.openldap.org/" name="OpenLDAP">.
<p>
    The Linux Directory Service Project: <url url="http://www.rage.net/ldap" name="RageNet">

<sect>About LDAPconf
<p>
Homepage <url url="http://www.terminator.net/ldapconf/" name="http://www.terminator.net/ldapconf/">.
<p>
Bugs/comments: Stein Vråle <url url="mailto:stein@terminator.net" name="stein@terminator.net">
<p>
License: GPL
<p>
<verb>
      Copyright (c) 1999 Stein Vråle
      
      This program is free software; you can redistribute it and/or 
      modify it under the terms of the GNU General Public License as 
      published by the Free Software Foundation; either version 2 of 
      the License, or (at your option) any later version.
  
      This program is distributed in the hope that it will be useful,
      but WITHOUT ANY WARRANTY; without even the implied warranty of
      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
      GNU General Public License for more details.
 
      To receive a copy of the GNU General Public License, please write
      to the Free Software Foundation, Inc., 59 Temple Place, Suite 330,
      Boston, MA 02111-1307 USA
</verb>
</article>

---