318 lines
9.1 KiB
HTML
318 lines
9.1 KiB
HTML
![]() |
|
||
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
||
|
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||
|
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"
|
||
|
lang="en" dir="ltr">
|
||
|
|
||
|
<head>
|
||
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||
|
<title></title>
|
||
|
<!-- metadata -->
|
||
|
<meta name="generator" content="Offline" />
|
||
|
<meta name="version" content="Offline 0.1" />
|
||
|
<!-- style sheet links -->
|
||
|
<link rel="stylesheet" media="all" type="text/css" href="../../../css/all.css" />
|
||
|
<link rel="stylesheet" media="screen" type="text/css" href="../../../css/screen.css" />
|
||
|
<link rel="stylesheet" media="print" type="text/css" href="../../../css/print.css" />
|
||
|
|
||
|
</head>
|
||
|
<body>
|
||
|
<div class="dokuwiki export">
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
<h1><a name="installation_from_the_tarball" id="installation_from_the_tarball">Installation from the tarball</a></h1>
|
||
|
<div class="level1">
|
||
|
|
||
|
</div>
|
||
|
<!-- SECTION "Installation from the tarball" [1-45] -->
|
||
|
<h2><a name="get_the_tarball" id="get_the_tarball">Get the tarball</a></h2>
|
||
|
<div class="level2">
|
||
|
|
||
|
<p>
|
||
|
|
||
|
Get the tarball from <a href="../../download.html" class="wikilink1" title="download">download page</a>. You can also find on this page the SVN tarball if you want to test latest features.
|
||
|
</p>
|
||
|
|
||
|
<p>
|
||
|
<p><div class="noteimportant">The content of the SVN tarball is not the same as the official tarball. Please see the next chapter to learn how build an official tarball from SVN files.
|
||
|
</div></p>
|
||
|
</p>
|
||
|
|
||
|
</div>
|
||
|
<!-- SECTION "Get the tarball" [46-388] -->
|
||
|
<h2><a name="build_the_tarball_from_svn" id="build_the_tarball_from_svn">Build the tarball from SVN</a></h2>
|
||
|
<div class="level2">
|
||
|
|
||
|
<p>
|
||
|
|
||
|
Either checkout or export the SVN repository, or extract the SVN tarball to get the SVN files on your disk.
|
||
|
</p>
|
||
|
|
||
|
<p>
|
||
|
Then go to build directory:
|
||
|
|
||
|
</p>
|
||
|
<pre class="code">
|
||
|
cd trunk/build/lemonldap-ng
|
||
|
</pre>
|
||
|
|
||
|
<p>
|
||
|
And run the “dist” target:
|
||
|
|
||
|
</p>
|
||
|
<pre class="code">
|
||
|
make dist
|
||
|
</pre>
|
||
|
|
||
|
<p>
|
||
|
The generated tarball is in the current directory.
|
||
|
</p>
|
||
|
|
||
|
</div>
|
||
|
<!-- SECTION "Build the tarball from SVN" [389-714] -->
|
||
|
<h2><a name="extraction" id="extraction">Extraction</a></h2>
|
||
|
<div class="level2">
|
||
|
|
||
|
<p>
|
||
|
|
||
|
Just run the tar command:
|
||
|
|
||
|
</p>
|
||
|
<pre class="code">
|
||
|
tar zxvf lemonldap-ng-*.tar.gz
|
||
|
</pre>
|
||
|
|
||
|
</div>
|
||
|
<!-- SECTION "Extraction" [715-811] -->
|
||
|
<h2><a name="installation" id="installation">Installation</a></h2>
|
||
|
<div class="level2">
|
||
|
|
||
|
<p>
|
||
|
|
||
|
First check and install the <a href="../../documentation/1.2/prereq.html" class="wikilink1" title="documentation:1.2:prereq">prerequisites</a>.
|
||
|
</p>
|
||
|
|
||
|
<p>
|
||
|
For full install:
|
||
|
</p>
|
||
|
<pre class="code">
|
||
|
cd lemonldap-ng-*
|
||
|
make
|
||
|
make configure
|
||
|
make test
|
||
|
sudo make install
|
||
|
</pre>
|
||
|
|
||
|
<p>
|
||
|
You can modify location of default storage configuration file in configure target:
|
||
|
|
||
|
</p>
|
||
|
<pre class="code">
|
||
|
sudo make configure STORAGECONFFILE=/etc/lemonldap-ng/lemonldap-ng.ini
|
||
|
</pre>
|
||
|
|
||
|
<p>
|
||
|
You can choose other Makefile targets:
|
||
|
</p>
|
||
|
<ul>
|
||
|
<li class="level1"><div class="li"> <acronym title="Practical Extraction and Report Language">Perl</acronym> libraries install :</div>
|
||
|
<ul>
|
||
|
<li class="level2"><div class="li"> install_libs (all <acronym title="Practical Extraction and Report Language">Perl</acronym> libraries)</div>
|
||
|
</li>
|
||
|
<li class="level2"><div class="li"> install_portal_libs</div>
|
||
|
</li>
|
||
|
<li class="level2"><div class="li"> install_manager_libs</div>
|
||
|
</li>
|
||
|
<li class="level2"><div class="li"> install_handler_libs</div>
|
||
|
</li>
|
||
|
</ul>
|
||
|
</li>
|
||
|
<li class="level1"><div class="li"> Binaries install :</div>
|
||
|
<ul>
|
||
|
<li class="level2"><div class="li"> install_bin (/usr/local/lemonldap-ng/bin)</div>
|
||
|
</li>
|
||
|
</ul>
|
||
|
</li>
|
||
|
<li class="level1"><div class="li"> Web sites install :</div>
|
||
|
<ul>
|
||
|
<li class="level2"><div class="li"> install_site (all sites including install_doc_site)</div>
|
||
|
</li>
|
||
|
<li class="level2"><div class="li"> install_portal_site (/usr/local/lemonldap-ng/htdocs/portal)</div>
|
||
|
</li>
|
||
|
<li class="level2"><div class="li"> install_manager_site (/usr/local/lemonldap-ng/htdocs/manager)</div>
|
||
|
</li>
|
||
|
<li class="level2"><div class="li"> install_handler_site (/usr/local/lemonldap-ng/handler)</div>
|
||
|
</li>
|
||
|
</ul>
|
||
|
</li>
|
||
|
<li class="level1"><div class="li"> Documentation install :</div>
|
||
|
<ul>
|
||
|
<li class="level2"><div class="li"> install_doc_site (/usr/local/lemonldap-ng/htdocs/doc)</div>
|
||
|
</li>
|
||
|
<li class="level2"><div class="li"> install_examples_site (/usr/local/lemonldap-ng/examples)</div>
|
||
|
</li>
|
||
|
</ul>
|
||
|
</li>
|
||
|
</ul>
|
||
|
|
||
|
<p>
|
||
|
|
||
|
You can also pass parameters to the make install command, with this syntax:
|
||
|
|
||
|
</p>
|
||
|
<pre class="code">
|
||
|
sudo make install PARAM=VALUE PARAM=VALUE ...
|
||
|
</pre>
|
||
|
|
||
|
<p>
|
||
|
Available parameters are:
|
||
|
</p>
|
||
|
<ul>
|
||
|
<li class="level1"><div class="li"> <strong>ERASECONFIG</strong>: set to 0 if you want to keep your configuration files (default: 1)</div>
|
||
|
</li>
|
||
|
<li class="level1"><div class="li"> <strong>DESTDIR</strong>: only for packaging, install the product in a jailroot (default: ””)</div>
|
||
|
</li>
|
||
|
<li class="level1"><div class="li"> <strong>PREFIX</strong>: installation directory (default: /usr/local)</div>
|
||
|
</li>
|
||
|
<li class="level1"><div class="li"> <strong>STORAGECONFFILE</strong>: location of default storage configuration file (default: /usr/local/lemonldap-ng/etc/lemonldap-ng.ini)</div>
|
||
|
</li>
|
||
|
<li class="level1"><div class="li"> <strong>CRONDIR</strong>: Cronfile directory (default: $PREFIX/etc/lemonldap-ng/cron.d)</div>
|
||
|
</li>
|
||
|
<li class="level1"><div class="li"> <strong>APACHEUSER</strong>: user running Apache</div>
|
||
|
</li>
|
||
|
<li class="level1"><div class="li"> <strong>APACHEGROUP</strong>: group running Apache</div>
|
||
|
</li>
|
||
|
<li class="level1"><div class="li"> <strong>DNSDOMAIN</strong>: Main <acronym title="Domain Name System">DNS</acronym> domain (default: example.com) </div>
|
||
|
</li>
|
||
|
<li class="level1"><div class="li"> <strong>LDAPHOST</strong>: <acronym title="Lightweight Directory Access Protocol">LDAP</acronym> server (default: localhost)</div>
|
||
|
</li>
|
||
|
<li class="level1"><div class="li"> <strong>LDAPPORT</strong>: <acronym title="Lightweight Directory Access Protocol">LDAP</acronym> port (default: 389)</div>
|
||
|
</li>
|
||
|
<li class="level1"><div class="li"> <strong>LDAPSUFFIX</strong>: <acronym title="Lightweight Directory Access Protocol">LDAP</acronym> suffix (default: dc=example,dc=com)</div>
|
||
|
</li>
|
||
|
<li class="level1"><div class="li"> <strong>APACHEVERSION</strong>: Apache major version (default: 2)</div>
|
||
|
</li>
|
||
|
<li class="level1"><div class="li"> <strong>VHOSTLISTEN</strong>: how listen parameter is configured for virtual hosts in Apache (default: *:80)</div>
|
||
|
</li>
|
||
|
</ul>
|
||
|
|
||
|
<p>
|
||
|
|
||
|
<p><div class="notetip">
|
||
|
For Debian/Ubuntu, you can use:
|
||
|
|
||
|
</p>
|
||
|
<pre class="code">
|
||
|
make debian-install
|
||
|
</pre>
|
||
|
|
||
|
<p>
|
||
|
|
||
|
or:
|
||
|
|
||
|
</p>
|
||
|
<pre class="code">
|
||
|
make ubuntu-install
|
||
|
</pre>
|
||
|
|
||
|
<p>
|
||
|
|
||
|
See also <a href="../../documentation/1.2/installdeb.html" class="wikilink1" title="documentation:1.2:installdeb">Debian/Ubuntu installation documentation</a>.
|
||
|
|
||
|
</div></p>
|
||
|
</p>
|
||
|
|
||
|
</div>
|
||
|
<!-- SECTION "Installation" [812-3139] -->
|
||
|
<h2><a name="link_apache_configuration" id="link_apache_configuration">Link Apache configuration</a></h2>
|
||
|
<div class="level2">
|
||
|
|
||
|
<p>
|
||
|
|
||
|
By default, Apache configuration files will be installed in <code>/usr/local/lemonldap-ng/etc/</code>. You have to include them in Apache main configuration, for example:
|
||
|
</p>
|
||
|
<pre class="code file apache"><span class="kw1">include</span> /usr/local/lemonldap-ng/etc/portal-apache2.conf
|
||
|
<span class="kw1">include</span> /usr/local/lemonldap-ng/etc/handler-apache2.conf
|
||
|
<span class="kw1">include</span> /usr/local/lemonldap-ng/etc/manager-apache2.conf</pre>
|
||
|
|
||
|
<p>
|
||
|
<p><div class="notetip">
|
||
|
</p>
|
||
|
<ul>
|
||
|
<li class="level1"><div class="li"> You can also use symbolic links in <code>conf.d</code> Apache directory.</div>
|
||
|
</li>
|
||
|
<li class="level1"><div class="li"> If you have run the Debian/Ubuntu install command, just use:</div>
|
||
|
</li>
|
||
|
</ul>
|
||
|
<pre class="code">
|
||
|
a2ensite manager-apache2.conf
|
||
|
a2ensite portal-apache2.conf
|
||
|
</pre>
|
||
|
|
||
|
<p>
|
||
|
|
||
|
|
||
|
</div></p>
|
||
|
</p>
|
||
|
|
||
|
<p>
|
||
|
<p><div class="notewarning">Mod <acronym title="Practical Extraction and Report Language">Perl</acronym> <strong>must</strong> be loaded before <acronym title="LemonLDAP::NG">LL::NG</acronym> Apache configuration.
|
||
|
</div></p>
|
||
|
</p>
|
||
|
|
||
|
</div>
|
||
|
<!-- SECTION "Link Apache configuration" [3140-3847] -->
|
||
|
<h2><a name="install_cron_jobs" id="install_cron_jobs">Install cron jobs</a></h2>
|
||
|
<div class="level2">
|
||
|
|
||
|
<p>
|
||
|
|
||
|
<acronym title="LemonLDAP::NG">LL::NG</acronym> use cron jobs to:
|
||
|
</p>
|
||
|
<ul>
|
||
|
<li class="level1"><div class="li"> purge old sessions</div>
|
||
|
</li>
|
||
|
<li class="level1"><div class="li"> clean Handler cache</div>
|
||
|
</li>
|
||
|
</ul>
|
||
|
|
||
|
<p>
|
||
|
|
||
|
To install them on system:
|
||
|
</p>
|
||
|
<pre class="code">
|
||
|
sudo ln -s /usr/local/lemonldap-ng/etc/cron.d/* /etc/cron.d/
|
||
|
</pre>
|
||
|
|
||
|
</div>
|
||
|
<!-- SECTION "Install cron jobs" [3848-4057] -->
|
||
|
<h2><a name="dns" id="dns">DNS</a></h2>
|
||
|
<div class="level2">
|
||
|
|
||
|
<p>
|
||
|
|
||
|
Configure your <acronym title="Domain Name System">DNS</acronym> server to resolve names with your server <acronym title="Internet Protocol">IP</acronym>.
|
||
|
</p>
|
||
|
|
||
|
<p>
|
||
|
<p><div class="notetip">
|
||
|
For tests with the configured domain, launch the following :
|
||
|
|
||
|
</p>
|
||
|
<pre class="code shell">cat /usr/local/lemonldap-ng/etc/lemonldap-ng/for_etc_hosts >> /etc/hosts</pre>
|
||
|
|
||
|
<p>
|
||
|
|
||
|
|
||
|
</div></p>
|
||
|
</p>
|
||
|
|
||
|
<p>
|
||
|
Follow the <a href="../../documentation/1.2/start.html#configuration" class="wikilink1" title="documentation:1.2:start">next steps</a>.
|
||
|
|
||
|
</p>
|
||
|
|
||
|
</div>
|
||
|
<!-- SECTION "DNS" [4058-] --></div><!-- closes <div class="dokuwiki export">-->
|