Installation on Red Hat/CentOS

LemonLDAP::NG provides packages for Red Hat/Centos 7:

• lemonldap-ng: metapackage, contains no file but dependencies on other packages
• lemonldap-ng-doc: contains HTML documentation and project docs (README, etc.)
• lemonldap-ng-fr-doc: French translation for documentation
• lemonldap-ng-conf: contains default configuration (DNS domain: example.com)
• lemonldap-ng-test: contains sample CGI test page
• lemonldap-ng-handler: contains Apache Handler implementation (agent)
• lemonldap-ng-manager: contains administration interface and session explorer
• lemonldap-ng-portal: contains authentication portal and menu
• lemonldap-ng-fastcgi-server: FastCGI server needed to use Nginx
• perl-Lemonldap-NG-Common: CPAN - Shared modules
• perl-Lemonldap-NG-Handler: CPAN - Handler modules
• perl-Lemonldap-NG-Manager: CPAN - Manager modules
• perl-Lemonldap-NG-Portal: CPAN - Portal modules

You can add this YUM repository to get recent packages:

vi /etc/yum.repos.d/lemonldap-ng.repo

[lemonldap-ng]
name=LemonLDAP::NG packages
baseurl=https://lemonldap-ng.org/redhat/stable/$releasever/noarch
enabled=1
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-OW2

You may also need some extras packages, available here:

[lemonldap-ng-extras]
name=LemonLDAP::NG extra packages
baseurl=https://lemonldap-ng.org/redhat/extras/$releasever
enabled=1
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-OW2

Run this to update packages cache:

yum update

RPMs are available on the Download page.

The GPG key can be downloaded here: rpm-gpg-key-ow2

Install it to trust RPMs:

rpm --import rpm-gpg-key-ow2

If the packages are stored in a yum repository:

yum install lemonldap-ng

You can also use yum on local RPMs file:

yum localinstall lemonldap-ng-* perl-Lemonldap-NG-*

Before installing the packages, install all dependencies.

You have then to install all the downloaded packages:

rpm -Uvh lemonldap-ng-* perl-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.js /var/lib/lemonldap-ng/test/index.pl

To allow the manager to reload the configuration, register the reload virtual host name in the hosts of the server:

echo "127.0.0.1 reload.example.com" >> /etc/hosts

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

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

cat /etc/lemonldap-ng/for_etc_hosts >> /etc/hosts

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
• All Perl scripts/pages are in /var/lib/lemonldap-ng/
• All static content (examples, CSS, images, etc.) is in /usr/share/lemonldap-ng/

If you need it, you can rebuild RPMs:

• Install rpm-build package
• Install all build dependencies (see BuildRequires in lemonldap-ng.spec)
• Put LemonLDAP::NG tarball in %_topdir/SOURCES
• Edit ~/.rpmmacros and set your build parameters:

%_topdir /home/user/build
%dist .el7
%rhel 7

• Go to %_topdir
• Build:

rpmbuild -ta SOURCES/lemonldap-ng-VERSION.tar.gz