Installing the CMFLDAP Product

    You will need Zope version 2.3.0 or higher and a CMF-based site.

    This is a companion product for the LDAPLoginAdapter (see 
    http://www.dataflake.org/software/ldaploginadapter for info) and 
    the LDAPUserManager (http://www.dataflake.org/software/ldapusermanager).
    It is is of no use by itself. Making sure you have those products
    installed and working will save you a lot of grief and me unnecessary
    questions.


    **Installing**

    Unzip / untar the compressed archive in your Zope Products directory.
    You should follow steps like::

        $ cp CMFLDAP-xyz.tgz <zope_root>/lib/python/Products
        $ cd <zope_root>/lib/python/Products
        $ tar zxvf CMFLDAP-xyz.tgz
        <watch files being decompressed>

    After the files have been uncompressed you will need to edit the file
    *cmfldap_conf.py* and then restart your Zope server. The *cmfldap_conf.py*
    configuration file will point the product at the LDAPUserManager instance
    you wish to use. Go to the first line that does not start with a hash (#)
    character. Replace /acl_manager with the path to your LDAPUserManager
    instance.

    When the site has been restarted you need to go into the management
    interface and navigate into your CMF instance. In the CMF root instantiate
    an External Method by selecting *External Method* from the dropdown list
    on the top right and fill in the following values::

      Id: Any id that is not yet taken
      Title: This is an optional field
      Module Name: CMFLDAP.Move2LDAP
      Function Name: Move2LDAP

    After hitting the *Add* button you will be back in the CMF site's root
    management view. Click on the external method you just created to see
    its management view.

    This method is run by selecting the "Test" tab at the top. It will 
    return a small log of modifications. This script can be re-run as
    often as you like to e.g. reinstall deleted components.

    See README.txt for any other dependencies and requirements.


    **Upgrading**
 
      If you upgrade this product you will need to re-run the external 
      method as described above.