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" >
2015-06-08 16:57:58 +02:00
< h1 class = "sectionedit1" id = "installation_from_the_tarball" > Installation from the tarball< / h1 >
2012-02-25 23:45:20 +01:00
< div class = "level1" >
< / div >
2015-06-08 16:57:58 +02:00
<!-- EDIT1 SECTION "Installation from the tarball" [1 - 45] -->
< h2 class = "sectionedit2" id = "get_the_tarball" > Get the tarball< / h2 >
2012-02-25 23:45:20 +01:00
< 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 >
2015-06-08 16:57:58 +02:00
<!-- EDIT2 SECTION "Get the tarball" [46 - 388] -->
< h2 class = "sectionedit3" id = "build_the_tarball_from_svn" > Build the tarball from SVN< / h2 >
2012-02-25 23:45:20 +01:00
< 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 >
2012-03-09 14:01:47 +01:00
Then go to trunk directory:
2012-02-25 23:45:20 +01:00
< / p >
2015-06-08 16:57:58 +02:00
< pre class = "code" > cd trunk< / pre >
2012-02-25 23:45:20 +01:00
< p >
And run the “dist” target:
< / p >
2015-06-08 16:57:58 +02:00
< pre class = "code" > make dist< / pre >
2012-02-25 23:45:20 +01:00
< p >
The generated tarball is in the current directory.
< / p >
< / div >
2015-06-08 16:57:58 +02:00
<!-- EDIT3 SECTION "Build the tarball from SVN" [389 - 695] -->
< h2 class = "sectionedit4" id = "extraction" > Extraction< / h2 >
2012-02-25 23:45:20 +01:00
< div class = "level2" >
< p >
Just run the tar command:
< / p >
2015-06-08 16:57:58 +02:00
< pre class = "code" > tar zxvf lemonldap-ng-*.tar.gz< / pre >
2012-02-25 23:45:20 +01:00
< / div >
2015-06-08 16:57:58 +02:00
<!-- EDIT4 SECTION "Extraction" [696 - 792] -->
< h2 class = "sectionedit5" id = "installation" > Installation< / h2 >
2012-02-25 23:45:20 +01:00
< div class = "level2" >
< p >
2015-12-18 10:46:34 +01:00
First check and install the < a href = "../../documentation/1.9/prereq.html" class = "wikilink1" title = "documentation:1.9:prereq" > prerequisites< / a > .
2012-02-25 23:45:20 +01:00
< / p >
< p >
For full install:
< / p >
2015-06-08 16:57:58 +02:00
< pre class = "code" > cd lemonldap-ng-*
2012-02-25 23:45:20 +01:00
make
make configure
make test
2015-06-08 16:57:58 +02:00
sudo make install< / pre >
2012-02-25 23:45:20 +01:00
2014-01-22 17:28:39 +01:00
< p >
< p > < div class = "notetip" >
2014-05-22 12:51:39 +02:00
You can also build and install French documentation :
2014-01-22 17:28:39 +01:00
< / p >
2015-06-08 16:57:58 +02:00
< pre class = "code" > make fr-doc
make install_fr_doc_site< / pre >
2014-01-22 17:28:39 +01:00
< 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 >
2012-02-25 23:45:20 +01:00
< p >
You can modify location of default storage configuration file in configure target:
< / p >
2015-06-08 16:57:58 +02:00
< pre class = "code" > sudo make configure STORAGECONFFILE=/etc/lemonldap-ng/lemonldap-ng.ini< / pre >
2012-02-25 23:45:20 +01:00
< p >
You can choose other Makefile targets:
< / p >
< ul >
2015-06-08 16:57:58 +02:00
< li class = "level1" > < div class = "li" > Perl libraries install :< / div >
2012-02-25 23:45:20 +01:00
< ul >
2015-06-08 16:57:58 +02:00
< li class = "level2" > < div class = "li" > install_libs (all Perl libraries)< / div >
2012-02-25 23:45:20 +01:00
< / 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 >
2015-06-08 16:57:58 +02:00
< pre class = "code" > sudo make install PARAM=VALUE PARAM=VALUE ...< / pre >
2012-02-25 23:45:20 +01:00
< 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 >
2015-06-08 16:57:58 +02:00
< li class = "level1" > < div class = "li" > < strong > DESTDIR< / strong > : only for packaging, install the product in a jailroot (default: “”)< / div >
2012-02-25 23:45:20 +01:00
< / 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 >
2015-06-08 16:57:58 +02:00
< li class = "level1" > < div class = "li" > < strong > DNSDOMAIN< / strong > : Main < abbr title = "Domain Name System" > DNS< / abbr > domain (default: example.com) < / div >
2012-02-25 23:45:20 +01:00
< / 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 >
2015-06-08 16:57:58 +02:00
< pre class = "code" > make debian-install< / pre >
2012-02-25 23:45:20 +01:00
< p >
or:
< / p >
2015-06-08 16:57:58 +02:00
< pre class = "code" > make ubuntu-install< / pre >
2012-02-25 23:45:20 +01:00
< p >
2015-12-18 10:46:34 +01:00
See also < a href = "../../documentation/1.9/installdeb.html" class = "wikilink1" title = "documentation:1.9:installdeb" > Debian/Ubuntu installation documentation< / a > .
2012-02-25 23:45:20 +01:00
< / div > < / p >
< / p >
< / div >
2015-06-08 16:57:58 +02:00
<!-- EDIT5 SECTION "Installation" [793 - 3182] -->
< h2 class = "sectionedit6" id = "link_apache_configuration" > Link Apache configuration< / h2 >
2012-02-25 23:45:20 +01:00
< 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
2013-01-05 12:56:59 +01:00
< 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 >
2012-02-25 23:45:20 +01:00
< 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 >
2015-06-08 16:57:58 +02:00
< pre class = "code" > a2ensite manager-apache2.conf
2012-02-25 23:45:20 +01:00
a2ensite portal-apache2.conf
2013-01-05 12:56:59 +01:00
a2ensite handler-apache2.conf
2015-06-08 16:57:58 +02:00
a2ensite test-apache2.conf< / pre >
2012-02-25 23:45:20 +01:00
< p >
< / div > < / p >
< / p >
< p >
2015-06-08 16:57:58 +02:00
< p > < div class = "notewarning" > Mod Perl < strong > must< / strong > be loaded before < abbr title = "LemonLDAP::NG" > LL::NG< / abbr > Apache configuration.
2012-02-25 23:45:20 +01:00
< / div > < / p >
< / p >
< / div >
2015-06-08 16:57:58 +02:00
<!-- EDIT6 SECTION "Link Apache configuration" [3183 - 4001] -->
< h2 class = "sectionedit7" id = "install_cron_jobs" > Install cron jobs< / h2 >
2012-02-25 23:45:20 +01:00
< div class = "level2" >
< p >
2015-06-08 16:57:58 +02:00
< abbr title = "LemonLDAP::NG" > LL::NG< / abbr > use cron jobs to:
2012-02-25 23:45:20 +01:00
< / 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 >
2015-06-08 16:57:58 +02:00
< pre class = "code" > sudo ln -s /usr/local/lemonldap-ng/etc/cron.d/* /etc/cron.d/< / pre >
2012-02-25 23:45:20 +01:00
< / div >
2015-06-08 16:57:58 +02:00
<!-- EDIT7 SECTION "Install cron jobs" [4002 - 4211] -->
< h2 class = "sectionedit8" id = "dns" > DNS< / h2 >
2012-02-25 23:45:20 +01:00
< div class = "level2" >
< p >
2015-06-08 16:57:58 +02:00
Configure your < abbr title = "Domain Name System" > DNS< / abbr > server to resolve names with your server < abbr title = "Internet Protocol" > IP< / abbr > .
2012-02-25 23:45:20 +01:00
< / 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 >
2015-12-18 10:46:34 +01:00
Follow the < a href = "../../documentation/1.9/start.html#configuration" class = "wikilink1" title = "documentation:1.9:start" > next steps< / a > .
2012-02-25 23:45:20 +01:00
< / p >
< / div >
2015-06-08 16:57:58 +02:00
< / div > <!-- closes <div class="dokuwiki export"> -->