<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr">
<head>
<meta name="generator" content=
"HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org" />
<title>Lemonldap::NG documentation:
3.4-Upgrade-from-0.9.4-to-1.0.html</title>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
<style type="text/css">
/*<![CDATA[*/
body{
background: #ddd;
font-family: sans-serif;
font-size: 11pt;
padding: 0 50px;
}
div.main-content{
padding: 10px;
background: #fff;
border: 2px #ccc solid;
}
a{
text-decoration: none;
}
p.footer{
text-align: center;
margin: 5px 0 0 0;
}
.heading-1{
text-align: center;
color: orange;
font-variant: small-caps;
font-size: 20pt;
}
.heading-1-1{
color: orange;
font-size: 14pt;
border-bottom: 2px #ccc solid;
}
pre{
background: #eee;
border: 2px #ccc solid;
padding: 5px;
border-left: 10px #ccc solid;
}
ul.star li{
list-style-type: square;
}
/*]]>*/
</style>
</head>
<body>
<div class="main-content">
<h2 class="heading-1"><span id="HUpgradefrom094to10">Upgrade from 0.9.4 to
1.0</span></h2>
<p class="paragraph"></p>
<ul>
<li><a href="#HWhat27snew">What's new</a></li>
<li><a href="#HApacheconfiguration">Apache configuration</a></li>
<li><a href="#HLemonLDAP3A3ANGconfigurationfiles">LemonLDAP::NG
configuration files</a></li>
<li><a href="#HCustomizedscriptsparameters">Customized scripts
parameters</a></li>
<li><a href="#HLibertyAllianceportal">Liberty Alliance portal</a></li>
</ul>
<h3 class="heading-1-1"><span id="HWhat27snew">What's new</span></h3>
<p class="paragraph"></p>LemonLDAP::NG 1.0 come with some brand new
features:
<ul class="star">
<li>More authentication backends (DBI, proxy, SAML, ...)</li>
<li>Manager with Ajax</li>
<li>Unified configuration in a central ini file</li>
<li>Split Apache configuration for Portal/Manager/Handler</li>
<li>...</li>
</ul>All these changes require to take a look at following paragraphs if
you want to migrate your LemonLDAP::NG 0.9.4 installation.
<h3 class="heading-1-1"><span id="HApacheconfiguration">Apache
configuration</span></h3>
<p class="paragraph"></p>Now LemonLDAP::NG is shipped with 3 Apache
configuration files:
<ul class="star">
<li><strong class="strong">portal-apache2.conf</strong>: portal virtual
host</li>
<li><strong class="strong">manager-apache2.conf</strong>: manager
virtual host</li>
<li><strong class="strong">handler-apache2.conf</strong>: handler
declaration and protected application virtual hosts</li>
</ul><strong class="strong">Note</strong>: If you are still using Apache
1, those files are named <strong class=
"strong">portal-apache.conf</strong>, *manager-apache.conf*,
<strong class="strong">handler-apache.conf</strong>.
<p class="paragraph"></p>With LemonLDAP::NG, you should only have on file
(<strong class="strong">apache2.conf</strong>). So you need to report all
your Apache customization in those 3 files, and include them in the main
Apache configuration file (<strong class="strong">httpd.conf</strong>).
<h3 class="heading-1-1"><span id=
"HLemonLDAP3A3ANGconfigurationfiles">LemonLDAP::NG configuration
files</span></h3>
<p class="paragraph"></p>LemonLDAP::NG 0.9.4 used local files for some
settings:
<ul class="star">
<li><strong class="strong">apply.conf</strong>: URI used by Manager to
apply changes</li>
<li><strong class="strong">storage.cong</strong>: Configuration location
and Cache settings</li>
<li><strong class="strong">apps-list.xml</strong>: Application menu</li>
</ul>Those file are not used anymore, and merged into <strong class=
"strong">lemonldap-ng.ini</strong>.
<p class="paragraph"></p>There is a script in the bin/ directory called
<strong class="strong">lmMigrateConfFiles2ini</strong> designed to parse
old configuration files and copy parameters in the new file.
<p class="paragraph"></p>Script options:
<ul class="star">
<li><strong class="strong">--dir,-d</strong>: path to main configuration
directory (default: /etc/lemonldap-ng)</li>
<li><strong class="strong">--storage,-s</strong>: path to storage.conf
(if not stored in conf dir)</li>
<li><strong class="strong">--apply,-a</strong>: path to apply.conf (if
not stored in conf dir)</li>
<li><strong class="strong">--menuxml,-m</strong>: path to apps-list.xml
(if not stored in conf dir)</li>
<li><strong class="strong">--ini,-i</strong>: path to lemonldap-ng.ini
(if not stored in conf dir)</li>
<li><strong class="strong">--preserve,-p</strong>: do not erase old
files after import</li>
<li><strong class="strong">--help,-h</strong>: show this message</li>
<li><strong class="strong">--verbose,-v</strong>: let me tell you my
life</li>
</ul>Here is how you can use it, if you installed LemonLDAP::NG from the
tarball in the /usr/local/lemonldap-ng directory:
<div class="code">
<pre>
$ sudo /usr/local/lemonldap-ng/bin/lmMigrateConfFiles2ini -d /usr/local/lemonldap-ng/etc -v -p
</pre>
</div><br />
<br />
Remove the <strong class="strong">-p</strong> options if you want to
delete old files.
<h3 class="heading-1-1"><span id="HCustomizedscriptsparameters">Customized
scripts parameters</span></h3><br />
<br />
Before 1.0, we used to override some configuration parameters by editing
perl scripts (like <strong class="strong">portal/index.pl</strong>) and
setting values like this :<br />
<br />
<div class="code">
<pre>
my $portal = Lemonldap::NG::Portal::SharedConf-><span class=
"java-keyword">new</span>( {
portal => 'auth.example.com',
cookieName => 'lemonldap',
ldapPort => '390',
…
} );
</pre>
</div>
<p class="paragraph"></p>The new <strong class=
"strong">lemonldap-ng.ini</strong> 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.
<p class="paragraph"></p>If you still need to customize those program
files, please prefer to copy them:
<div class="code">
<pre>
# cp portal/index.pl portal/indexcustom.pl
</pre>
</div><br />
<br />
And declare your custom file in Apache configuration
<div class="code">
<pre>
DirectoryIndex indexcustom.pl
</pre>
</div><br />
<br />
This will prevent your local modifications to be dropped when you will
update your LemonLDAP::NG version.
<h3 class="heading-1-1"><span id="HLibertyAllianceportal">Liberty Alliance
portal</span></h3><br />
<br />
Liberty Alliance portal is no more installed by default. Indeed,
LemonLDAP::NG has now SAML2 authentication backend!<br />
<br />
If you still want the Liberty Alliance portal, use this in install
command:
<div class="code">
<pre>
$ sudo make install WITHLA=1
</pre>
</div>
</div>
<p class="footer"><a href="index.html">Index</a></p>
</body>
</html>
