summaryrefslogtreecommitdiffstats
path: root/INSTALL.txt
blob: a361c0337d79e5ddac9ca6233556d727fa664c51 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
Installing the LDAPLoginAdapter Product

    You will need Zope version 2.3.0 or higher!

    If you are looking for a similar solution for a pre-2.3.0-site
    see http://sourceforge.net/projects/zldapadapter/ for the
    LDAPAdapter. The LDAPAdapter, written by Ross Lazarus and Soren Roug,
    formed the basis for the LDAPLoginAdapter.

    This product does not require any special handling after unzipping
    and untarring it in the Zope Products directory. You should do 
    something like::

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

    That's all. Do not forget to restart Zope afterwards.


    **Upgraders beware**

    In order to avoid problems everyone who upgrades from a prior 
    version of the LDAPLoginAdapter should delete and recreate any
    LDAPLoginAdapter instance they have!

    
    **Important Hint**

    Depending on your choice of Zope install (e.g. compiled from source
    or binary version) you need to make sure that the python-ldap 
    module (see README.txt) can be found by Zope.

    The first step after compiling the python-ldap module is to find 
    out if it works correctly by firing up your python interpreter 
    and typing "import ldap". Then hit return. If no error message shows 
    up the module is compiled and installed correctly.

    If after correctly installing and compiling the python-ldap 
    module Zope still complains "ImportError: No module named ldap"
    you need to find the module file (its name is "ldapmodule.so") and 
    manually copy it into the LDAPLoginAdapter folder in your Zope 
    Products folder. This will be the case with all those Zope installs 
    that contain their own python binary, like the Linux binary install.

    If you for some reason decide to run Zope on a certain OS from Redmond
    you might have difficulties getting python-ldap in a precompiled 
    version. Barry Pederson found the following website which might help:
    http://www.it.uq.edu.au/personal/leonard/dc-prj/ldapmodule/
    Barry also put all needed components (a LDAP DLL from the University
    of Michigan LDAP distribution and precompiled python-ldap modules) up
    in his member area on zope.org at:
    
    http://www.zope.org/Members/barryp/win32_ldap


    See README.txt for any other dependencies and requirements.