1998-08-14 03:34:45 +04:00
|
|
|
PerLDAP installation instructions
|
|
|
|
|
==================================
|
|
|
|
|
|
|
|
|
|
Building this package is fairly straight forward, but requires some
|
|
|
|
|
knowledge about using compilers and compiler tools on your system. If you
|
|
|
|
|
are uncomfortable using these tools, we recommend you get one of the
|
|
|
|
|
prebuilt binary distributions instead.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Prerequisites
|
|
|
|
|
=============
|
|
|
|
|
|
|
|
|
|
In order to build the module, you'll need
|
|
|
|
|
|
|
|
|
|
- Perl, version 5.003 or later. We definitely recommend you to use
|
|
|
|
|
v5.004 or later.
|
|
|
|
|
|
|
|
|
|
- An ANSI-C compiler, e.g. gcc-2.x, or Visual C++ 5.0.
|
|
|
|
|
|
|
|
|
|
- The LDAP client libraries and include files, e.g. the SDK from
|
|
|
|
|
Netscape Communications. See the README file for information on
|
|
|
|
|
retrieving binaries.
|
|
|
|
|
|
|
|
|
|
You can download (or CVS checkout) the Directory SDK source, see further
|
|
|
|
|
information available on
|
|
|
|
|
|
|
|
|
|
http://www.mozilla.org/directory/
|
|
|
|
|
|
1999-01-22 02:52:52 +03:00
|
|
|
and the FAQ at
|
|
|
|
|
|
|
|
|
|
http://www.mozilla.org/directory/faq/perldap-faq.html
|
|
|
|
|
|
|
|
|
|
|
1998-08-14 03:34:45 +04:00
|
|
|
|
|
|
|
|
Building
|
|
|
|
|
========
|
|
|
|
|
|
|
|
|
|
This package uses the normal Perl5 MakeMaker installation system. To
|
|
|
|
|
generate a Makefile appropriate for your platform, run perl on the
|
|
|
|
|
provided Makefile.PL script, e.g.
|
|
|
|
|
|
|
|
|
|
% perl Makefile.PL
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
You might have to use the command `perl5' or `perl-5.004', depending on
|
|
|
|
|
how you installed Perl-5. The script will now ask you a few questions to
|
|
|
|
|
find the necessary library and include files. A typical configuration
|
|
|
|
|
session is
|
|
|
|
|
|
|
|
|
|
data 195% perl5 Makefile.PL
|
|
|
|
|
|
|
|
|
|
PerLDAP - Perl 5 Module for LDAP
|
|
|
|
|
================================
|
|
|
|
|
Directory containing 'include' and 'lib' directory of the Netscape
|
|
|
|
|
LDAP Software Developer Kit (default: /usr): /opt/ldapsdk3
|
|
|
|
|
Using LDAPv3 Developer Kit (default: yes)?
|
|
|
|
|
Include SSL Support (default: yes)?
|
1999-01-22 02:52:52 +03:00
|
|
|
Libraries to link with (default: -L/opt/pkg/ldapsdk3/lib -lldapssl30):
|
|
|
|
|
Checking if your kit is complete...
|
|
|
|
|
Looks good
|
1998-08-14 03:34:45 +04:00
|
|
|
Writing Makefile for Mozilla::LDAP::API
|
|
|
|
|
|
|
|
|
|
|
1999-01-22 02:52:52 +03:00
|
|
|
|
1998-08-14 03:34:45 +04:00
|
|
|
The important question is where your LDAP SDK is installed, in the example
|
|
|
|
|
above the base directory is /opt/ldapsdk3. This directory should have two
|
|
|
|
|
subdirectories, named "lib" and "include". If you installed the SDK in the
|
|
|
|
|
standard /usr hierarchy, use the default value as provided by the install
|
|
|
|
|
script.
|
|
|
|
|
|
|
|
|
|
Assuming you get no errors or warning, proceed with the build and install:
|
|
|
|
|
|
|
|
|
|
% make
|
|
|
|
|
% make install
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
That should be it!
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Automated Configuration and Installs
|
|
|
|
|
====================================
|
|
|
|
|
|
|
|
|
|
The Makefile.PL script also honors a set of environment variables to make
|
|
|
|
|
it possible to do configuration and installs non-interactively. The
|
|
|
|
|
variables are
|
|
|
|
|
|
|
|
|
|
LDAPSDKDIR - Full path to the C SDK base directory
|
1999-01-22 02:52:52 +03:00
|
|
|
LDAPV3ON - Set to "N" to diable LDAP v3 (on by default)
|
|
|
|
|
LDAPSDKSSL - Set to "N" to disable SSL (SSL is default)
|
1998-08-14 03:34:45 +04:00
|
|
|
|
|
|
|
|
|
1999-01-22 02:52:52 +03:00
|
|
|
With these variables set, you will not be asked any of the questions above
|
|
|
|
|
(but it will echo the paramaters). Just run the Makefile.PL script, and
|
|
|
|
|
finish the build, e.g.
|
1998-08-14 03:34:45 +04:00
|
|
|
|
|
|
|
|
% perl5 Makefile.PL
|
|
|
|
|
% make
|
|
|
|
|
% make install
|
