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_on_debianubuntu_with_packages" > Installation on Debian/Ubuntu with packages< / h1 >
2012-02-25 23:45:20 +01:00
< div class = "level1" >
< / div >
2015-06-08 16:57:58 +02:00
<!-- EDIT1 SECTION "Installation on Debian/Ubuntu with packages" [1 - 59] -->
< h2 class = "sectionedit2" id = "organization" > Organization< / h2 >
2012-02-25 23:45:20 +01:00
< div class = "level2" >
< p >
LemonLDAP::NG provides these packages:
< / p >
< ul >
< li class = "level1" > < div class = "li" > lemonldap-ng: meta-package, contains no file but dependencies on other packages< / div >
< / li >
2015-06-08 16:57:58 +02:00
< li class = "level1" > < div class = "li" > lemonldap-ng-doc: contains < abbr title = "HyperText Markup Language" > HTML< / abbr > documentation and project docs (README, etc.)< / div >
2012-02-25 23:45:20 +01:00
< / li >
2016-02-27 19:22:01 +01:00
< li class = "level1" > < div class = "li" > lemonldap-ng-fastcgi-server: < abbr title = "LemonLDAP::NG" > LL::NG< / abbr > FastCGI server (for Nginx)< / div >
< / li >
2015-06-08 16:57:58 +02:00
< li class = "level1" > < div class = "li" > lemonldap-ng-fr-doc: French translation for < abbr title = "HyperText Markup Language" > HTML< / abbr > documentation< / div >
2014-05-22 12:51:39 +02:00
< / li >
2013-10-28 21:42:57 +01:00
< li class = "level1" > < div class = "li" > liblemonldap-ng-common-perl: configuration and common files< / div >
2012-02-25 23:45:20 +01:00
< / li >
< li class = "level1" > < div class = "li" > liblemonldap-ng-handler-perl: Handler files< / div >
< / li >
< li class = "level1" > < div class = "li" > liblemonldap-ng-manager-perl: Manager files< / div >
< / li >
< li class = "level1" > < div class = "li" > liblemonldap-ng-portal-perl: Portal files< / div >
< / li >
< / ul >
< / div >
2016-02-27 19:22:01 +01:00
<!-- EDIT2 SECTION "Organization" [60 - 631] -->
2015-06-08 16:57:58 +02:00
< h2 class = "sectionedit3" id = "get_the_packages" > Get the packages< / h2 >
2012-02-25 23:45:20 +01:00
< div class = "level2" >
< / div >
2016-02-27 19:22:01 +01:00
<!-- EDIT3 SECTION "Get the packages" [632 - 661] -->
2015-06-08 16:57:58 +02:00
< h3 class = "sectionedit4" id = "official_repository" > Official repository< / h3 >
2012-02-25 23:45:20 +01:00
< div class = "level3" >
< p >
If you run Debian testing or unstable, the packages are directly installable:
< / p >
2015-06-08 16:57:58 +02:00
< pre class = "code" > apt-cache search lemonldap-ng< / pre >
2012-02-25 23:45:20 +01:00
< p >
< p > < div class = "noteimportant" > Packages from < a href = "http://packages.debian.org/search?keywords=lemonldap-ng" class = "urlextern" title = "http://packages.debian.org/search?keywords=lemonldap-ng" rel = "nofollow" > Debian repository< / a > may not be up to date. Prefer then the other solutions (see below).
< / div > < / p >
< / p >
< / div >
2016-02-27 19:22:01 +01:00
<!-- EDIT4 SECTION "Official repository" [662 - 1000] -->
2015-06-08 16:57:58 +02:00
< h3 class = "sectionedit5" id = "llng_repository" > LL::NG repository< / h3 >
2012-02-25 23:45:20 +01:00
< div class = "level3" >
< p >
You can add this repository to have recent packages:
< / p >
2015-06-08 16:57:58 +02:00
< pre class = "code" > vi /etc/apt/sources.list.d/lemonldap-ng.list< / pre >
< pre class = "file" > # LemonLDAP::NG repository
2015-12-18 10:46:34 +01:00
deb http://lemonldap-ng.org/deb stable main
deb-src http://lemonldap-ng.org/deb stable main< / pre >
2014-12-19 10:03:15 +01:00
2012-02-25 23:45:20 +01:00
< p >
Run this to update packages cache:
< / p >
2015-06-08 16:57:58 +02:00
< pre class = "code" > apt-get update< / pre >
2012-02-25 23:45:20 +01:00
< / div >
2016-02-27 19:22:01 +01:00
<!-- EDIT5 SECTION "LL::NG repository" [1001 - 1348] -->
2015-06-08 16:57:58 +02:00
< h3 class = "sectionedit6" id = "manual_download" > Manual download< / h3 >
2012-02-25 23:45:20 +01:00
< div class = "level3" >
< p >
Packages are available on the < a href = "../../download.html" class = "wikilink1" title = "download" > Download page< / a > .
< / p >
< / div >
2016-02-27 19:22:01 +01:00
<!-- EDIT6 SECTION "Manual download" [1349 - 1435] -->
2015-06-08 16:57:58 +02:00
< h2 class = "sectionedit7" id = "package_gpg_signature" > Package GPG signature< / h2 >
2012-06-17 16:24:34 +02:00
< div class = "level2" >
< p >
2015-06-08 16:57:58 +02:00
The GPG key can be downloaded here: < a href = "../media/rpm-gpg-key-ow2" class = "media mediafile mf_" title = "rpm-gpg-key-ow2 (1.7 KB)" > rpm-gpg-key-ow2< / a >
2012-06-17 16:24:34 +02:00
< / p >
< p >
Install it to trust packages:
< / p >
2015-06-08 16:57:58 +02:00
< pre class = "code" > apt-key add rpm-gpg-key-ow2< / pre >
2012-06-17 16:24:34 +02:00
< / div >
2016-02-27 19:22:01 +01:00
<!-- EDIT7 SECTION "Package GPG signature" [1436 - 1604] -->
2015-06-08 16:57:58 +02:00
< h2 class = "sectionedit8" id = "install_packages" > Install packages< / h2 >
2012-02-25 23:45:20 +01:00
< div class = "level2" >
< / div >
2016-02-27 19:22:01 +01:00
<!-- EDIT8 SECTION "Install packages" [1605 - 1634] -->
2015-06-08 16:57:58 +02:00
< h3 class = "sectionedit9" id = "with_aptitude" > With aptitude< / h3 >
2012-02-25 23:45:20 +01:00
< div class = "level3" >
2015-06-08 16:57:58 +02:00
< pre class = "code" > aptitude install lemonldap-ng< / pre >
2012-02-25 23:45:20 +01:00
< / div >
2016-02-27 19:22:01 +01:00
<!-- EDIT9 SECTION "With aptitude" [1635 - 1705] -->
2015-06-08 16:57:58 +02:00
< h3 class = "sectionedit10" id = "with_dpkg" > With dpkg< / h3 >
2012-02-25 23:45:20 +01:00
< div class = "level3" >
< p >
2016-03-22 12:19:17 +01:00
Before installing the packages, install < a href = "../../documentation/2.0/prereq.html" class = "wikilink1" title = "documentation:2.0:prereq" > dependencies< / a > .
2012-02-25 23:45:20 +01:00
< / p >
< p >
Then:
< / p >
2015-06-08 16:57:58 +02:00
< pre class = "code" > dpkg -i liblemonldap-ng-* lemonldap-ng*< / pre >
2012-02-25 23:45:20 +01:00
< / div >
2016-02-27 19:22:01 +01:00
<!-- EDIT10 SECTION "With dpkg" [1706 - 1854] -->
2015-06-08 16:57:58 +02:00
< h2 class = "sectionedit11" id = "first_configuration_steps" > First configuration steps< / h2 >
2012-02-25 23:45:20 +01:00
< div class = "level2" >
< / div >
2016-02-27 19:22:01 +01:00
<!-- EDIT11 SECTION "First configuration steps" [1855 - 1893] -->
2015-06-08 16:57:58 +02:00
< h3 class = "sectionedit12" id = "change_default_dns_domain" > Change default DNS domain< / h3 >
2012-02-25 23:45:20 +01:00
< div class = "level3" >
< p >
2015-06-08 16:57:58 +02:00
By default, < abbr title = "Domain Name System" > DNS< / abbr > domain is < code > example.com< / code > . You can change it quick with a sed command. For example, we change it to < code > ow2.org< / code > :
2012-02-25 23:45:20 +01:00
< / p >
2016-03-22 12:19:17 +01:00
< pre class = "code shell" > sed -i 's/example\.com/ow2.org/g' /etc/lemonldap-ng/* /var/lib/lemonldap-ng/conf/lmConf-1.js /var/lib/lemonldap-ng/test/index.pl< / pre >
2012-02-25 23:45:20 +01:00
< / div >
2016-03-22 12:19:17 +01:00
<!-- EDIT12 SECTION "Change default DNS domain" [1894 - 2211] -->
2016-02-27 19:22:01 +01:00
< h3 class = "sectionedit13" id = "reload_virtual_host" > Reload virtual host< / h3 >
2012-06-18 11:25:41 +02:00
< div class = "level3" >
< p >
To allow the manager to reload the configuration, register the reload virtual host name in the hosts of the server:
< / p >
< pre class = "code shell" > echo " 127.0.0.1 reload.example.com" > > /etc/hosts< / pre >
< p >
< p > < div class = "notetip" > Adapt the reload virtual host name to the domain you configured.
< / div > < / p >
< / p >
< / div >
2016-03-22 12:19:17 +01:00
<!-- EDIT13 SECTION "Reload virtual host" [2212 - 2513] -->
2016-02-27 19:22:01 +01:00
< h3 class = "sectionedit14" id = "upgrade" > Upgrade< / h3 >
2012-02-25 23:45:20 +01:00
< div class = "level3" >
< p >
2016-03-22 12:19:17 +01:00
If you upgraded < abbr title = "LemonLDAP::NG" > LL::NG< / abbr > , check all < a href = "../../documentation/2.0/upgrade.html" class = "wikilink1" title = "documentation:2.0:upgrade" > upgrade notes< / a > .
2012-02-25 23:45:20 +01:00
< / p >
< / div >
2016-03-22 12:19:17 +01:00
<!-- EDIT14 SECTION "Upgrade" [2514 - 2594] -->
2016-02-27 19:22:01 +01:00
< h3 class = "sectionedit15" id = "dns" > DNS< / h3 >
2012-02-25 23:45:20 +01:00
< div class = "level3" >
< 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 < code > example.com< / code > , launch the following :
< / p >
< pre class = "code shell" > cat /etc/lemonldap-ng/for_etc_hosts > > /etc/hosts< / pre >
< p >
< / div > < / p >
< / p >
< p >
2016-03-22 12:19:17 +01:00
Follow the < a href = "../../documentation/2.0/start.html#configuration" class = "wikilink1" title = "documentation:2.0:start" > next steps< / a >
2012-02-25 23:45:20 +01:00
< / p >
< / div >
2016-03-22 12:19:17 +01:00
<!-- EDIT15 SECTION "DNS" [2595 - 2867] -->
2016-02-27 19:22:01 +01:00
< h2 class = "sectionedit16" id = "file_location" > File location< / h2 >
2012-02-25 23:45:20 +01:00
< div class = "level2" >
< ul >
< li class = "level1" > < div class = "li" > Configuration is in /etc/lemonldap-ng< / div >
< / li >
< li class = "level1" > < div class = "li" > LemonLDAP::NG configuration (edited by the Manager) is in /var/lib/lemonldap-ng/conf/< / div >
< / li >
2015-06-08 16:57:58 +02:00
< li class = "level1" > < div class = "li" > All Perl modules are in the VENDOR perl directory (/usr/share/perl5/)< / div >
2012-02-25 23:45:20 +01:00
< / li >
2015-06-08 16:57:58 +02:00
< li class = "level1" > < div class = "li" > All Perl scripts/pages are in /var/lib/lemonldap-ng/< / div >
2012-02-25 23:45:20 +01:00
< / li >
< li class = "level1" > < div class = "li" > All lemonldap-ng tools are in /usr/share/lemonldap-ng/bin/< / div >
< / li >
2015-06-08 16:57:58 +02:00
< li class = "level1" > < div class = "li" > All static content (examples, < abbr title = "Cascading Style Sheets" > CSS< / abbr > , images, etc.) is in /usr/share/lemonldap-ng/< / div >
2012-02-25 23:45:20 +01:00
< / li >
< li class = "level1" > < div class = "li" > Apache configuration files are in /etc/lemonldap-ng and linked in /etc/apache2/sites-available< / div >
< / li >
< / ul >
< / div >
2016-03-22 12:19:17 +01:00
<!-- EDIT16 SECTION "File location" [2868 - 3404] -->
2016-02-27 19:22:01 +01:00
< h2 class = "sectionedit17" id = "build_your_packages" > Build your packages< / h2 >
2012-02-25 23:45:20 +01:00
< div class = "level2" >
< p >
You can also get the < a href = "../../download.html" class = "wikilink1" title = "download" > LemonLDAP::NG archive< / a > and make the package yourself:
< / p >
2015-06-08 16:57:58 +02:00
< pre class = "code" > tar xzf lemonldap-ng-*.tar.gz
2012-02-25 23:45:20 +01:00
cd lemonldap-ng-*
2015-06-08 16:57:58 +02:00
make debian-packages< / pre >
2012-02-25 23:45:20 +01:00
< / div >
2015-06-08 16:57:58 +02:00
< / div > <!-- closes <div class="dokuwiki export"> -->