Chapter 1. Installation
Prev |  | Next

## Chapter 1. Installation

## New installation

### Requirements

LAM has the following requirements to run:

- Apache webserver (SSL recommended) with PHP module (PHP 5 (>= 5.2.4) 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 recent web browser that supports CSS2 and JavaScript, at minimum:

  - Firefox 3

  - Internet Explorer 8 (compatibility mode turned off)

  - Opera 10

MCrypt will be used to store your LDAP password encrypted in the session file.

See LDAP schema fles for information about used LDAP schema files.

### Prepackaged releases

LAM is available as prepackaged version for various platforms.

#### Debian

LAM is part of the official Debian repository. New releases are uploaded to unstable and will be available automatically in testing and the stable releases. You can run``

apt-get install ldap-account-manager

to install LAM on your server. Additionally, you may download the latest LAM Debian packages from the LAM homepage or the Debian package homepage.

Installation of the latest packages on Debian Lenny

1. apt-get install javascript-common

2. Download the jquery and jquery-ui packages from here:

   http://packages.debian.org/squeeze/all/libjs-jquery/download

   http://packages.debian.org/squeeze/all/libjs-jquery-ui/download

3. Install first jquery and then jquery-ui:

   dpkg -i libjs-jquery_*.deb

   dpkg -i libjs-jquery-ui_*.deb

4. Install php-fpdf 1.6.dfsg-1 from here:

   http://packages.debian.org/stable/all/php-fpdf/download

5. Install the LAM package

   dpkg -i ldap-account-manager_*.deb

6. Install the lamdaemon package (optional)

   dpkg -i ldap-account-manager-lamdaemon_*.deb

#### Suse/Fedora

| There are RPM packages available on the LAM homepage. The packages can be installed with these commands: rpm -e ldap-account-manager ldap-account-manager-lamdaemon (if an older version is installed) rpm -i <path to LAM package>

#### Other RPM based distributions

The RPM packages for Suse/Fedora are very generic and should be installable on other RPM-based distributions, too. The Fedora packages use apache:apache as file owner and the Suse ones use wwwrun:www.

#### FreeBSD

| LAM is part of the official FreeBSD ports tree. For more details see these pages: FreeBSD-CVS: http://www.freebsd.org/cgi/cvsweb.cgi/ports/sysutils/ldap-account-manager FreshPorts: http://www.freshports.org/sysutils/ldap-account-manager

### Installing the tar.gz

#### Extract the archive

Please extract the archive with the following command:

tar xzf ldap-account-manager-<version>.tar.gz

#### Install the files

##### Manual copy

Copy the files into the html-file scope of the web server. For example /apache/htdocs.

Then set the 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

##### With configure script

Instead of manually copying files you can also use the included configure script to install LAM. Just run these commands in the extracted directory:

- ./configure

- make install

Options for "./configure":

- --with-httpd-user=USER USER is the name of your Apache user account (default httpd)

- --with-httpd-group=GROUP GROUP is the name of your Apache group (default httpd)

- --with-web-root=DIRECTORY DIRECTORY is the name where LAM should be installed (default /usr/local/lam)

#### Configuration files

Copy config/config.cfg_sample to config/config.cfg and config/lam.conf_sample to config/lam.conf. Open the index.html in your web browser:

- Follow the link "LAM configuration" from the start page to configure LAM.

- Select "Edit general settings" to setup global settings and to change the master configuration password (default is "lam").

- Select "Edit server profiles" to setup your server profiles. There should be the lam profile which you just copied from the sample file. The default password is "lam". Now change the settings to fit for your environment.

### System configuration

#### PHP

LAM runs with PHP5 (>= 5.2.4). Needed changes in your php.ini:

memory_limit = 64M

If you run PHP with activated Suhosin extension please check your logs for alerts. E.g. LAM requires that "suhosin.post.max_name_length" is increased.

#### Locales for non-English translation

If you want to use a translated version of LAM be sure to install the needed locales. The following table shows the needed locales for the different languages.

Table 1.1. Locales

Language | Locale
Catalan | ca_ES.utf8
Chinese (Simplified) | zh_CN.utf8
Chinese (Traditional) | zh_TW.utf8
Czech | cs_CZ.utf8
Dutch | nl_NL.utf8
English | no extra locale needed
French | fr_FR.utf8
German | de_DE.utf8
Hungarian | hu_HU.utf8
Italian | it_IT.utf8
Japanese | ja_JP.utf8
Polish | pl_PL.utf8
Portuguese | pt_BR.utf8
Russian | ru_RU.utf8
Spanish | es_ES.utf8

You can get a list of all installed locales on your system by executing:

locale -a

Debian users can add locales with "dpkg-reconfigure locales".

Prev |  | Next
Architecture | Home | Upgrading LAM or migrate from LAM to LAM Pro