Home | History | Annotate | Line # | Download | only in ppm
      1 INSTALLATION
      2 ============
      3 
      4 Dependencies
      5 ------------------
      6 ppm is provided along with OpenLDAP sources. By default, it is available into contrib/slapd-modules.
      7  - make sure both OpenLDAP sources and ppm are available for building.
      8  - install cracklib development files if you want to test passwords against cracklib
      9  - install pandoc if you want to build the man page
     10 
     11 
     12 Build
     13 -----
     14 Enter contrib/slapd-modules/ppm directory
     15 
     16 You can optionally customize some variables if you don't want the default ones:
     17 - prefix: prefix of the path where ppm is to be installed (defaults to /usr/local)
     18 - ldap_subdir: OpenLDAP specific subdirectory for modules and configurations (defaults to  openldap )
     19 - moduledir: where the ppm module is to be deployed (defaults to $prefix/$libexecdir/$ldap_subdir)
     20 - etcdir: used to compose default sysconfdir location (defaults to $prefix/etc)
     21 - sysconfdir: where the ppm example policy is to be deployed (defaults to $prefix/$etcdir/$ldap_subdir)
     22 - LDAP_SRC: path to OpenLDAP source directory
     23 - Options in DEFS variable:
     24     CONFIG_FILE: (DEPRECATED) path to a ppm configuration file (see PPM_READ_FILE in ppm.h)
     25         note: ppm configuration now lies into pwdCheckModuleArg password policy attribute
     26               provided example file is only helpful as an example or for testing
     27     CRACKLIB: if defined, link against cracklib
     28     DEBUG: If defined, ppm logs its actions with syslog
     29 
     30 
     31 To build ppm, simply run these commands:
     32 (based upon the default prefix /usr/local of OpenLDAP)
     33 
     34 ```
     35 make clean
     36 make
     37 make test
     38 make doc
     39 make install
     40 ```
     41 
     42 Here is an illustrative example showing how to overload some options:
     43 
     44 ```
     45 make clean
     46 make LDAP_SRC=../../.. prefix=/usr/local libdir=/usr/local/lib
     47 make test LDAP_SRC=../../..
     48 make doc prefix=/usr/local
     49 make install prefix=/usr/local libdir=/usr/local/lib
     50 ```
     51 
     52