LDAPAccountManager/lam/INSTALL

69 lines
2.1 KiB
Plaintext

Installation Instructions for LAM
---------------------------------
1. Requirements
- Apache webserver (SSL optional) with PHP module (PHP with
ldap, gettext, xml and optional mcrypt)
- some LAM plugins may require additional PHP extensions (you will get a
note on the login page if something is missing)
- Perl (optional, needed only for lamdaemon)
- OpenLDAP (>2.0)
- A web browser :-)
MHash is only needed if you use PHP < 4.3 and if you want to use SHA or SSHA
for password hashes.
MCrypt will be used to store your LDAP password encrypted in the session file.
Getting mcrypt and mhash for Suse/RedHat:
Either you compile PHP4 yourself or you use some unofficial packages:
- Suse: ftp://ftp.suse.com/pub/people/poeml/mod_php4
- RedHat: http://ftp.horde.org/pub/RPMS
See docs/README.schema.txt for information about used LDAP schema files.
2. Installation
1. Extract package with:
tar xzf ldap-account-manager-<version>.tar.gz
2a. Copy the files into the html-file scope of the webserver. For example
/apache/htdocs.
Set appropriate file permissions:
- lam/sess: write permission for apache user
- lam/tmp: write permission for apache user
- lam/config (with subdirectories): write permission for apache user
- lam/lib: lamdaemon.pl must be set executable (See also
docs/readme.lamdeamon.txt)
2b. You can also use the included configure script to install LAM. See
"./configure --help" for a list of install options.
3. Configure config.cfg and create a configuration profile.
Copy config.cfg_sample to config.cfg and set the master password and default
profile.
Open the index.html in your web browser:
- Follow the link "Configuration Login" from the start page.
(The default password to edit the options is "lam")
- Select the default lam profile or create a new profile.
- Change the settings to fit your environment.
3. Setting up PHP
LAM runs with PHP4 or PHP5.
Needed changes in your php.ini:
* memory_limit = 64M