led - LDAP editor

Copyright (c) 2003-2010, Larry Lile.  All rights reserved.
This package is free software; you can redistribute it and/or
modify it under the terms of the BSD software license.

After unpacking the distribution you only need to configure
make and install Led.  The configuration step will automatically
check that your Perl installation has access to the required
modules.

Before continuing you may wish to open led in your favorite
editor and review the schemas being used in the various maps.
Most are based on RFC 2307 but different installations have
different needs, please pay particular attention to the
schema attribute of each map.  Each value of the schema will
have an associated attribute with the required values for
that attribute in the target entry.  Some of these values
are synthetic but the intended value should be readily
apparent.

Led should work with any version of Net::LDAP, I have only
had success with Led and GSSAPI using perl-ldap-0.2401 and
perl-cyrus-sasl-0.02.  I am working to resolve these problems.
These versions of Net::LDAP and Authen::SASL::Cyrus seem to
be hard to find on the Net these days, so you will find
them in the modules directory in the release.

If you are using shadow passwords at your site you must
invoke the --shadow option of Configure to get the proper
passwd and shadow maps.  Otherwise you will only have
the password map.

*****
*
* If you have created any user defined maps in ~/.led/maps you
* may encounter some slight problems.  The user defined map file
* syntax has changed rdn, filter and scope have been combined
* into a URI like format in versions 1.95 and later.
*
* You will need to remove rdn, filter, scope and combine them
* into base as follows:
*
* dn: group
* filter: objectClass=posixGroup
* scope: sub
* rdn: ou=Group
* ...
*
* would simply become
*
* dn: group
* base: ou=Group,??(objectClass=posixGroup)
* ...
*
* Please see the full led documentation for complete details
* on the format and options for base.
*
*****

o Step 1 - Configuring Led

  Configure has a few options to allow you to customize Led

    > perl Configure -h
    Usage: perl Configure [-h]
	-h		  Display this message
	--prefix	  Install prefix
	--sysconfdir	  Read-only single-machine data [PREFIX/etc]
	--generic	* Include generic ldap maps (rootDSE, aci)
	--rfc2307	* Include rfc2307 maps (passwd, group, ...)
	--shadow	  Include support for shadow passwords
	--iPlanet	* Include iPlanet Directory Server maps (schema, config, ...)

	* Included by default


  Execute Configure using the Perl installation you intend Led
  to use and any options specific to your site.

    > perl Configure 

    Checking for REQUIRED modules

    POSIX ........................ok
    Net::LDAP ....................ok
    Digest::MD5 ..................ok
    URI ..........................ok
    URI::ldap ....................ok

    Checking for OPTIONAL modules

    Authen::SASL .................ok
    Authen::SASL::Cyrus ..........ok

    Writing Makefile

o Step 2 - Build and install Led

  make
  make install

You should now, as a safety measure, make at least one modification
to each map with the '-n' option invoked.  Verify that Led is not
making changes to your LDAP database that you do not intend.

Please note Led will remove tabs from some attribute values to 
avoid unneccesary Base64 encoding LDIFs.

$Id: INSTALL,v 1.9 2010/05/26 19:53:00 lile Exp $
