Installation on Debian/Ubuntu with packages
Organization
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
Get the packages
Official repository
If you run Debian stable, testing or unstable, the packages are directly installable:
apt-get install lemonldap-ng
LLNG Ubuntu packages are not in the "universe" but in the "multiverse". This means they are not security-maintained. If you use them, you should follow our security advisories on lemonldap-ng-users@ow2.org.
LL::NG repository
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.0
repository to avoid upgrade to next major version
Finally update your APT cache:
apt update
Manual download
Install packages
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
With apt
With dpkg
Before installing the packages, install dependencies.
Then:
dpkg -i liblemonldap-ng-* lemonldap-ng*
First configuration steps
Change default DNS domain
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
Upgrade
DNS
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
File location
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
Build your packages
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