dani/lemonldap-ng
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
ed08dc0cb0
lemonldap-ng/doc/pages/documentation/1.3/installtarball.html

312 lines
8.6 KiB
HTML
Raw Normal View History

Update doc.pl script to use the current documentation version (#442)
2012-02-25 23:45:20 +01:00
<!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>
Documentation update
2012-03-09 14:01:47 +01:00
Then go to trunk directory:
Update doc.pl script to use the current documentation version (#442)
2012-02-25 23:45:20 +01:00
</p>
<pre class="code">
Documentation update
2012-03-09 14:01:47 +01:00
cd trunk
Update doc.pl script to use the current documentation version (#442)
2012-02-25 23:45:20 +01:00
</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>
Documentation update
2012-03-09 14:01:47 +01:00
<!-- SECTION "Build the tarball from SVN" [389-695] -->
Update doc.pl script to use the current documentation version (#442)
2012-02-25 23:45:20 +01:00
<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>
Documentation update
2012-03-09 14:01:47 +01:00
<!-- SECTION "Extraction" [696-792] -->
Update doc.pl script to use the current documentation version (#442)
2012-02-25 23:45:20 +01:00
<h2><a name="installation" id="installation">Installation</a></h2>
<div class="level2">
<p>
Update doc in trunk for version 1.3
2012-06-18 12:33:45 +02:00
First check and install the <a href="../../documentation/1.3/prereq.html" class="wikilink1" title="documentation:1.3:prereq">prerequisites</a>.
Update doc.pl script to use the current documentation version (#442)
2012-02-25 23:45:20 +01:00
</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>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>
Update doc in trunk for version 1.3
2012-06-18 12:33:45 +02:00
See also <a href="../../documentation/1.3/installdeb.html" class="wikilink1" title="documentation:1.3:installdeb">Debian/Ubuntu installation documentation</a>.
Update doc.pl script to use the current documentation version (#442)
2012-02-25 23:45:20 +01:00
</div></p>
</p>
</div>
Update doc
2012-04-03 06:11:09 +02:00
<!-- SECTION "Installation" [793-2965] -->
Update doc.pl script to use the current documentation version (#442)
2012-02-25 23:45:20 +01:00
<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>
Update doc
2012-04-03 06:11:09 +02:00
<!-- SECTION "Link Apache configuration" [2966-3673] -->
Update doc.pl script to use the current documentation version (#442)
2012-02-25 23:45:20 +01:00
<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>
Update doc
2012-04-03 06:11:09 +02:00
<!-- SECTION "Install cron jobs" [3674-3883] -->
Update doc.pl script to use the current documentation version (#442)
2012-02-25 23:45:20 +01:00
<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 &gt;&gt; /etc/hosts</pre>
<p>
</div></p>
</p>
<p>
Update doc in trunk for version 1.3
2012-06-18 12:33:45 +02:00
Follow the <a href="../../documentation/1.3/start.html#configuration" class="wikilink1" title="documentation:1.3:start">next steps</a>.
Update doc.pl script to use the current documentation version (#442)
2012-02-25 23:45:20 +01:00
</p>
</div>
Update doc
2012-04-03 06:11:09 +02:00
<!-- SECTION "DNS" [3884-] --></div><!-- closes <div class="dokuwiki export">-->
Reference in New Issue Copy Permalink