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
|
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter1.Installation</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="LDAP Account Manager - Manual"><link rel="up" href="index.html" title="LDAP Account Manager - Manual"><link rel="prev" href="pr02.html" title="Architecture"><link rel="next" href="ch01s02.html" title="Upgrading LAM or migrate from LAM to LAM Pro"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter1.Installation</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="pr02.html">Prev</a></td><th width="60%" align="center"></th><td width="20%" align="right"><a accesskey="n" href="ch01s02.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter1.Installation"><div class="titlepage"><div><div><h2 class="title"><a name="a_installation"></a>Chapter1.Installation</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="ch01.html#a_install">New installation</a></span></dt><dd><dl><dt><span class="section"><a href="ch01.html#idp3332416">Requirements</a></span></dt><dt><span class="section"><a href="ch01.html#idp4344032">Prepackaged releases</a></span></dt><dt><span class="section"><a href="ch01.html#idp5297248">Installing the tar.gz</a></span></dt><dt><span class="section"><a href="ch01.html#idp5317952">System configuration</a></span></dt></dl></dd><dt><span class="section"><a href="ch01s02.html">Upgrading LAM or migrate from LAM to LAM Pro</a></span></dt><dd><dl><dt><span class="section"><a href="ch01s02.html#idp5346000">Migrating configuration files</a></span></dt><dt><span class="section"><a href="ch01s02.html#a_versUpgrade">Version specific upgrade instructions</a></span></dt></dl></dd><dt><span class="section"><a href="ch01s03.html">Uninstalltion of LAM (Pro)</a></span></dt></dl></div><div class="section" title="New installation"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="a_install"></a>New installation</h2></div></div></div><div class="section" title="Requirements"><div class="titlepage"><div><div><h3 class="title"><a name="idp3332416"></a>Requirements</h3></div></div></div><p>LAM has the following requirements to run:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Apache webserver (SSL recommended) with PHP module (PHP 5
(>= 5.2.4) with ldap, gettext, xml and optional mcrypt)</p></li><li class="listitem"><p>Some LAM plugins may require additional PHP extensions (you
will get a note on the login page if something is missing)</p></li><li class="listitem"><p>Perl (optional, needed only for lamdaemon)</p></li><li class="listitem"><p>OpenLDAP (>2.0)</p></li><li class="listitem"><p>A recent web browser that supports CSS2 and JavaScript, at
minimum:</p><div class="itemizedlist"><ul class="itemizedlist" type="circle"><li class="listitem"><p>Firefox 3</p></li><li class="listitem"><p>Internet Explorer 8 <span class="bold"><strong>(compatibility mode turned
off)</strong></span></p></li><li class="listitem"><p>Opera 10</p></li></ul></div></li></ul></div><p>MCrypt will be used to store your LDAP password encrypted in the
session file.</p><p>See <a class="link" href="apa.html" title="AppendixA.LDAP schema files">LDAP schema fles</a> for
information about used LDAP schema files.</p></div><div class="section" title="Prepackaged releases"><div class="titlepage"><div><div><h3 class="title"><a name="idp4344032"></a>Prepackaged releases</h3></div></div></div><p>LAM is available as prepackaged version for various
platforms.</p><div class="section" title="Debian"><div class="titlepage"><div><div><h4 class="title"><a name="idp2199200"></a>Debian</h4></div></div></div><div class="noborder"><table border="0"><colgroup><col><col></colgroup><tbody><tr><td><span class="inlinemediaobject"><img src="images/debian.png"></span></td><td>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<code class="literal"> </code><p><span class="bold"><strong>apt-get
install ldap-account-manager</strong></span></p>to install LAM
on your server. Additionally, you may download the latest
LAM Debian packages from the <a class="ulink" href="http://www.ldap-account-manager.org/" target="_top">LAM
homepage</a> or the <a class="ulink" href="http://packages.debian.org/search?keywords=ldap-account-manager" target="_top">Debian
package homepage</a>.<p><span class="bold"><strong>Installation of the latest packages on Debian
Lenny</strong></span></p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>apt-get install javascript-common</p></li><li class="listitem"><p>Download the jquery and jquery-ui packages from
here:</p><p><a class="ulink" href="http://packages.debian.org/squeeze/all/libjs-jquery/download" target="_top">http://packages.debian.org/squeeze/all/libjs-jquery/download</a></p><p><a class="ulink" href="http://packages.debian.org/squeeze/all/libjs-jquery-ui/download" target="_top">http://packages.debian.org/squeeze/all/libjs-jquery-ui/download</a></p></li><li class="listitem"><p>Install first jquery and then jquery-ui:</p><p>dpkg -i libjs-jquery_*.deb</p><p>dpkg -i libjs-jquery-ui_*.deb</p></li><li class="listitem"><p>Install php-fpdf 1.6.dfsg-1 from here:</p><p><a class="ulink" href="http://packages.debian.org/stable/all/php-fpdf/download" target="_top">http://packages.debian.org/stable/all/php-fpdf/download</a></p></li><li class="listitem"><p>Install the LAM package</p><p>dpkg -i ldap-account-manager_*.deb</p></li><li class="listitem"><p>Install the lamdaemon package (optional)</p><p>dpkg -i
ldap-account-manager-lamdaemon_*.deb</p></li></ol></div></td></tr></tbody></table></div></div><div class="section" title="Suse/Fedora"><div class="titlepage"><div><div><h4 class="title"><a name="idp5281392"></a>Suse/Fedora</h4></div></div></div><div class="informaltable"><table border="0"><colgroup><col><col></colgroup><tbody><tr><td><span class="inlinemediaobject"><img src="images/suse.png"></span><p></p><span class="inlinemediaobject"><img src="images/fedora.png"></span></td><td>There are RPM packages available on the <a class="ulink" href="http://www.ldap-account-manager.org/" target="_top">LAM
homepage</a>. The packages can be installed with these
commands:<p><span class="bold"><strong>rpm -e
ldap-account-manager
ldap-account-manager-lamdaemon</strong></span> (if an older
version is installed)</p><p><span class="bold"><strong>rpm
-i <path to LAM package></strong></span></p></td></tr></tbody></table></div></div><div class="section" title="Other RPM based distributions"><div class="titlepage"><div><div><h4 class="title"><a name="idp5289456"></a>Other RPM based distributions</h4></div></div></div><p>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.</p></div><div class="section" title="FreeBSD"><div class="titlepage"><div><div><h4 class="title"><a name="idp5290848"></a>FreeBSD</h4></div></div></div><div class="informaltable"><table border="0"><colgroup><col><col></colgroup><tbody><tr><td><span class="inlinemediaobject"><img src="images/freebsd.png"></span></td><td>LAM is part of the official FreeBSD ports tree. For
more details see these pages:<p>FreeBSD-CVS: <a class="ulink" href="http://www.freebsd.org/cgi/cvsweb.cgi/ports/sysutils/ldap-account-manager" target="_top">http://www.freebsd.org/cgi/cvsweb.cgi/ports/sysutils/ldap-account-manager</a></p><p>FreshPorts:
<a class="ulink" href="http://www.freshports.org/sysutils/ldap-account-manager" target="_top">http://www.freshports.org/sysutils/ldap-account-manager</a></p></td></tr></tbody></table></div></div></div><div class="section" title="Installing the tar.gz"><div class="titlepage"><div><div><h3 class="title"><a name="idp5297248"></a>Installing the tar.gz</h3></div></div></div><div class="section" title="Extract the archive"><div class="titlepage"><div><div><h4 class="title"><a name="idp5297888"></a>Extract the archive</h4></div></div></div><p>Please extract the archive with the following command:</p><p>tar xzf ldap-account-manager-<version>.tar.gz</p></div><div class="section" title="Install the files"><div class="titlepage"><div><div><h4 class="title"><a name="idp5299424"></a>Install the files</h4></div></div></div><div class="section" title="Manual copy"><div class="titlepage"><div><div><h5 class="title"><a name="idp5300064"></a>Manual copy</h5></div></div></div><p>Copy the files into the html-file scope of the web server.
For example /apache/htdocs.</p><p>Then set the appropriate file permissions:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>lam/sess: write permission for apache user</p></li><li class="listitem"><p>lam/tmp: write permission for apache user</p></li><li class="listitem"><p>lam/config (with subdirectories): write permission for
apache user</p></li><li class="listitem"><p>lam/lib: lamdaemon.pl must be set executable</p></li></ul></div></div><div class="section" title="With configure script"><div class="titlepage"><div><div><h5 class="title"><a name="idp5305264"></a>With configure script</h5></div></div></div><p>Instead of manually copying files you can also use the
included configure script to install LAM. Just run these commands
in the extracted directory:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>./configure</p></li><li class="listitem"><p>make install</p></li></ul></div><p>Options for "./configure":</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>--with-httpd-user=USER USER is the name of your Apache
user account (default httpd)</p></li><li class="listitem"><p>--with-httpd-group=GROUP GROUP is the name of your
Apache group (default httpd)</p></li><li class="listitem"><p>--with-web-root=DIRECTORY DIRECTORY is the name where
LAM should be installed (default /usr/local/lam)</p></li></ul></div></div></div><div class="section" title="Configuration files"><div class="titlepage"><div><div><h4 class="title"><a name="idp5312080"></a>Configuration files</h4></div></div></div><p>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:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Follow the link "LAM configuration" from the start page to
<a class="link" href="ch02.html" title="Chapter2.Configuration">configure LAM</a>.</p></li><li class="listitem"><p>Select "Edit general settings" to setup global settings
and to change the <a class="link" href="apb.html#a_configPasswords" title="LAM configuration passwords">master
configuration password</a> (default is "lam").</p></li><li class="listitem"><p>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.</p></li></ul></div></div></div><div class="section" title="System configuration"><div class="titlepage"><div><div><h3 class="title"><a name="idp5317952"></a>System configuration</h3></div></div></div><div class="section" title="PHP"><div class="titlepage"><div><div><h4 class="title"><a name="idp5318592"></a>PHP</h4></div></div></div><p>LAM runs with PHP5 (>= 5.2.4). Needed changes in your
php.ini:</p><p>memory_limit = 64M</p><p>If you run PHP with activated <a class="ulink" href="http://www.hardened-php.net/suhosin/index.html" target="_top">Suhosin</a>
extension please check your logs for alerts. E.g. LAM requires that
"suhosin.post.max_name_length" and
"suhosin.request.max_varname_length" are increased (e.g. to
256).</p></div><div class="section" title="Locales for non-English translation"><div class="titlepage"><div><div><h4 class="title"><a name="idp5321568"></a>Locales for non-English translation</h4></div></div></div><p>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.</p><div class="table"><a name="idp5322784"></a><p class="title"><b>Table1.1.Locales</b></p><div class="table-contents"><table summary="Locales" border="1"><colgroup><col><col></colgroup><tbody><tr><td><span class="bold"><strong>Language</strong></span></td><td><span class="bold"><strong>Locale</strong></span></td></tr><tr><td>Catalan</td><td>ca_ES.utf8</td></tr><tr><td>Chinese (Simplified)</td><td>zh_CN.utf8</td></tr><tr><td>Chinese (Traditional)</td><td>zh_TW.utf8</td></tr><tr><td>Czech</td><td>cs_CZ.utf8</td></tr><tr><td>Dutch</td><td>nl_NL.utf8</td></tr><tr><td>English</td><td>no extra locale needed</td></tr><tr><td>French</td><td>fr_FR.utf8</td></tr><tr><td>German</td><td>de_DE.utf8</td></tr><tr><td>Hungarian</td><td>hu_HU.utf8</td></tr><tr><td>Italian</td><td>it_IT.utf8</td></tr><tr><td>Japanese</td><td>ja_JP.utf8</td></tr><tr><td>Polish</td><td>pl_PL.utf8</td></tr><tr><td>Portuguese</td><td>pt_BR.utf8</td></tr><tr><td>Russian</td><td>ru_RU.utf8</td></tr><tr><td>Spanish</td><td>es_ES.utf8</td></tr></tbody></table></div></div><br class="table-break"><p>You can get a list of all installed locales on your system by
executing:</p><p>locale -a</p><p>Debian users can add locales with "dpkg-reconfigure
locales".</p></div></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="pr02.html">Prev</a></td><td width="20%" align="center"></td><td width="40%" align="right"><a accesskey="n" href="ch01s02.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Architecture</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">Upgrading LAM or migrate from LAM to LAM Pro</td></tr></table></div></body></html>
|
