documentation:2.1:installdeb

Installation on Debian/Ubuntu with packages

LemonLDAP::NG provides these packages:

  • lemonldap-ng: metapackage, contains no file but dependencies on other packages
  • lemonldap-ng-doc: contains HTML documentation and project docs (README, etc.)
  • lemonldap-ng-fastcgi-server: LL::NG FastCGI server (for Nginx)
  • lemonldap-ng-handler: Handler files
  • liblemonldap-ng-common-perl: configuration and common files
  • liblemonldap-ng-handler-perl: Handler common libraries
  • liblemonldap-ng-manager-perl: Manager files
  • liblemonldap-ng-portal-perl: Portal files

If you run Debian testing or unstable, the packages are directly installable:

apt-cache search lemonldap-ng
Packages from Debian repository may not be up to date. Prefer then the other solutions (see below).

You can add this repository to have recent packages.

First, make sure your system can install packages from HTTPS repositories:

apt install apt-transport-https

You will need to trust the following GPG key : rpm-gpg-key-ow2

wget -O - https://lemonldap-ng.org/_media/rpm-gpg-key-ow2 | apt-key add -

Then, add the official LL::NG repository

vi /etc/apt/sources.list.d/lemonldap-ng.list
# LemonLDAP::NG repository
deb     https://lemonldap-ng.org/deb stable main
deb-src https://lemonldap-ng.org/deb stable main
  • Use the oldstable repository to get packages from previous major version
  • Use the testing repository to get packages from next major version
  • Use the 2.1 repository to avoid upgrade to next major version

Finally update your APT cache:

apt update

Packages are available on the Download page.

By default packages will require Nginx. If you want to use Apache2, install it first with mod_perl:
apt install apache2 libapache2-mod-perl2 libapache2-mod-fcgid
apt install lemonldap-ng

Before installing the packages, install dependencies.

Then:

dpkg -i liblemonldap-ng-* lemonldap-ng*

By default, DNS domain is example.com. You can change it quick with a sed command. For example, we change it to ow2.org:

sed -i 's/example\.com/ow2.org/g' /etc/lemonldap-ng/* /var/lib/lemonldap-ng/conf/lmConf-1.json

If you upgraded LL::NG, check all upgrade notes.

Configure your DNS server to resolve names with your server IP:

  • auth.<your domain>: main portal, must be public
  • manager.<your domain>: manager, only for adminsitrators
  • test1.<your domain>, test2.<your domain>: sample applications

Follow the next steps

  • Configuration is in /etc/lemonldap-ng
  • LemonLDAP::NG configuration (edited by the Manager) is in /var/lib/lemonldap-ng/conf/
  • All Perl modules are in the VENDOR perl directory (/usr/share/perl5/)
  • All Perl scripts/pages are in /var/lib/lemonldap-ng/
  • All lemonldap-ng tools are in /usr/share/lemonldap-ng/bin/
  • All static content (examples, CSS, images, etc.) is in /usr/share/lemonldap-ng/
  • Apache configuration files are in /etc/lemonldap-ng and linked in /etc/apache2/sites-available and /etc/nginx/sites-available

You can also get the LemonLDAP::NG archive and make the package yourself:

tar xzf lemonldap-ng-*.tar.gz
cd lemonldap-ng-*
make debian-packages