283 lines
8.7 KiB
HTML
283 lines
8.7 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 class="sectionedit1" id="installation_from_the_tarball">Installation from the tarball</h1>
|
|
<div class="level1">
|
|
|
|
</div>
|
|
<!-- EDIT1 SECTION "Installation from the tarball" [1-45] -->
|
|
<h2 class="sectionedit2" id="get_the_tarball">Get the tarball</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>
|
|
<!-- EDIT2 SECTION "Get the tarball" [46-388] -->
|
|
<h2 class="sectionedit3" id="build_the_tarball_from_svn">Build the tarball from SVN</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 trunk directory:
|
|
</p>
|
|
<pre class="code">cd trunk</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>
|
|
<!-- EDIT3 SECTION "Build the tarball from SVN" [389-695] -->
|
|
<h2 class="sectionedit4" id="extraction">Extraction</h2>
|
|
<div class="level2">
|
|
|
|
<p>
|
|
Just run the tar command:
|
|
</p>
|
|
<pre class="code">tar zxvf lemonldap-ng-*.tar.gz</pre>
|
|
|
|
</div>
|
|
<!-- EDIT4 SECTION "Extraction" [696-792] -->
|
|
<h2 class="sectionedit5" id="installation">Installation</h2>
|
|
<div class="level2">
|
|
|
|
<p>
|
|
First check and install the <a href="../../documentation/1.9/prereq.html" class="wikilink1" title="documentation:1.9: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>
|
|
<p><div class="notetip">
|
|
You can also build and install French documentation :
|
|
</p>
|
|
<pre class="code">make fr-doc
|
|
make install_fr_doc_site</pre>
|
|
|
|
<p>
|
|
Note that you need to have the <a href="http://www.omegat.org/" class="urlextern" title="http://www.omegat.org/" rel="nofollow">OmegaT</a> tool to generate the doc.
|
|
|
|
</div></p>
|
|
</p>
|
|
|
|
<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"> Perl libraries install :</div>
|
|
<ul>
|
|
<li class="level2"><div class="li"> install_libs (all Perl 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 <abbr title="Domain Name System">DNS</abbr> domain (default: example.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.9/installdeb.html" class="wikilink1" title="documentation:1.9:installdeb">Debian/Ubuntu installation documentation</a>.
|
|
|
|
</div></p>
|
|
</p>
|
|
|
|
</div>
|
|
<!-- EDIT5 SECTION "Installation" [793-3182] -->
|
|
<h2 class="sectionedit6" id="link_apache_configuration">Link Apache configuration</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
|
|
<span class="kw1">include</span> /usr/local/lemonldap-ng/etc/test-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
|
|
a2ensite handler-apache2.conf
|
|
a2ensite test-apache2.conf</pre>
|
|
|
|
<p>
|
|
|
|
</div></p>
|
|
</p>
|
|
|
|
<p>
|
|
<p><div class="notewarning">Mod Perl <strong>must</strong> be loaded before <abbr title="LemonLDAP::NG">LL::NG</abbr> Apache configuration.
|
|
</div></p>
|
|
</p>
|
|
|
|
</div>
|
|
<!-- EDIT6 SECTION "Link Apache configuration" [3183-4001] -->
|
|
<h2 class="sectionedit7" id="install_cron_jobs">Install cron jobs</h2>
|
|
<div class="level2">
|
|
|
|
<p>
|
|
<abbr title="LemonLDAP::NG">LL::NG</abbr> 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>
|
|
<!-- EDIT7 SECTION "Install cron jobs" [4002-4211] -->
|
|
<h2 class="sectionedit8" id="dns">DNS</h2>
|
|
<div class="level2">
|
|
|
|
<p>
|
|
Configure your <abbr title="Domain Name System">DNS</abbr> server to resolve names with your server <abbr title="Internet Protocol">IP</abbr>.
|
|
</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.9/start.html#configuration" class="wikilink1" title="documentation:1.9:start">next steps</a>.
|
|
</p>
|
|
|
|
</div>
|
|
</div><!-- closes <div class="dokuwiki export">--> |