Upgrade from 0.9.4 to 1.0

What's new

LemonLDAP::NG 1.0 come with some brand new features: All these changes require to take a look at following paragraphs if you want to migrate your LemonLDAP::NG 0.9.4 installation.

Apache configuration

Now LemonLDAP::NG is shipped with 3 Apache configuration files: Note: If you are still using Apache 1, those files are named portal-apache.conf, *manager-apache.conf*, handler-apache.conf.

With LemonLDAP::NG, you should only have on file (apache2.conf). So you need to report all your Apache customization in those 3 files, and include them in the main Apache configuration file (httpd.conf).

LemonLDAP::NG configuration files

LemonLDAP::NG 0.9.4 used local files for some settings: Those file are not used anymore, and merged into lemonldap-ng.ini.

There is a script in the bin/ directory called lmMigrateConfFiles2ini designed to parse old configuration files and copy parameters in the new file.

Script options: Here is how you can use it, if you installed LemonLDAP::NG from the tarball in the /usr/local/lemonldap-ng directory:
$ sudo /usr/local/lemonldap-ng/bin/lmMigrateConfFiles2ini -d /usr/local/lemonldap-ng/etc -v -p


Remove the -p options if you want to delete old files.

Customized scripts parameters



Before 1.0, we used to override some configuration parameters by editing perl scripts (like portal/index.pl) and setting values like this :

my $portal = Lemonldap::NG::Portal::SharedConf->new( {
    portal => 'auth.example.com',
    cookieName => 'lemonldap',
    ldapPort => '390',
    …
} );

The new lemonldap-ng.ini file should be now used to do this, as perl scripts are program files that are erased on software updates. You have to know too that all configuration parameters are now available in Manager interface.

If you still need to customize those program files, please prefer to copy them:
# cp portal/index.pl portal/indexcustom.pl


And declare your custom file in Apache configuration
DirectoryIndex indexcustom.pl


This will prevent your local modifications to be dropped when you will update your LemonLDAP::NG version.

Liberty Alliance portal



Liberty Alliance portal is no more installed by default. Indeed, LemonLDAP::NG has now SAML2 authentication backend!

If you still want the Liberty Alliance portal, use this in install command:
$ sudo make install WITHLA=1