lemonldap-ng/debian/lemonldap-ng.README.Debian

102 lines
2.3 KiB
Plaintext

FIRST CONFIGURATION STEPS
1 - Change default DNS domain
-----------------------------
By default, DNS domain is example.com. You can change using dpkg-reconfigure or
with a quick 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
2 - Enable LL::NG sites
-----------------------
2.1 - Apache
Enable installed components:
# Portal
a2ensite portal-apache2.conf
# Manager
a2ensite manager-apache2.conf
# Handler
a2ensite handler-apache2.conf
a2ensite test-apache2.conf
customize them and enable mod_perl if not already loaded:
a2enmod perl
Then restart Apache:
apache2ctl configtest
apache2ctl restart
2.2 - Nginx
Enable installed components:
cd /etc/nginx/sites-enabled
# Portal
ln -s ../sites-available/portal-nginx.conf
# Manager
ln -s ../sites-available/manager-nginx.conf
# Handler
# Warning: if no site is protected (see example files for this), the
# $lmremote_user variable will not be set. So you can't load this file since
# it includes /etc/lemonldap/nginx-lmlog.conf that requires at least one
# protected virtual host.
ln -s ../sites-available/handler-nginx.conf
# Test site
ln -s ../site-available/test-nginx.conf
Customize them, then reload nginx
nginx -s reload
3 - Check your DNS
------------------
Be sure that your browser can reach (adapt it with your domain):
- auth.example.com : Authentication portal
- manager.example.com : Configuration interface
4 - Connect to the manager
--------------------------
Go to http://manager.example.com/, you'll be redirected to the portal. Then
enjoy!
5 - Default accounts
--------------------
By default, LemonLDAP::NG use "Demo" authentication backend, so you can use the
following accounts:
Login Password Role
rtyler rtyler user
msmith msmith user
dwho dwho administrator
6 - Base configuration file
---------------------------
Configuration is managed by the Manager except some basic parameters
such as storage type configuration. These parameters are defined
in /etc/lemonldap-ng/lemonldap-ng.ini file.
This file can also be used to override the global configuration locally
6 - See more
------------
https://lemonldap-ng.org/