See <ahref="../../documentation/1.2/prereq.html#yum"class="wikilink1"title="documentation:1.2:prereq">prerequisites and dependencies</a> chapter for more.
Before installing the packages, install all <ahref="../../documentation/1.2/prereq.html"class="wikilink1"title="documentation:1.2:prereq">dependencies</a>.
</p>
<p>
You have then to install all the downloaded packages:
</p>
<preclass="code">
rpm -Uvh lemonldap-ng-* perl-Lemonldap-NG-*
</pre>
<p>
<p><divclass="notetip">
You can choose to install only one component by choosing the package <code>lemonldap-ng-portal</code>, <code>lemonldap-ng-handler</code> or <code>lemonldap-ng-manager</code>.
<h3><aname="change_default_dns_domain"id="change_default_dns_domain">Change default DNS domain</a></h3>
<divclass="level3">
<p>
By default, <acronymtitle="Domain Name System">DNS</acronym> domain is <code>example.com</code>. You can change it quick with a sed command. For example, we change it to <code>ow2.org</code>:
If <acronymtitle="LemonLDAP::NG">LL::NG</acronym> is the only software installed in Apache, the virtual host feature may not have already been activated.
</p>
<p>
To do it, uncomment the <code>NameVirtualHost</code> line in <code>/etc/httpd/conf.d/z-lemonldap-ng-handler.conf</code>:
If you upgraded <acronymtitle="LemonLDAP::NG">LL::NG</acronym>, check all <ahref="../../documentation/1.2/upgrade.html"class="wikilink1"title="documentation:1.2:upgrade">upgrade notes</a>.
</p>
<p>
For apache configuration, you may have to remove the old symbolic link, if not done by the RPM:
The upgrade process will also have migrate old configuration files into <code>/etc/lemonldap-ng/lemonldap-ng.ini</code>. This includes the application list which is now set in the <code>applicationList</code> parameter from <code>[portal]</code> section, for example:
<spanclass="re1">applicationList</span><spanclass="sy0">=</span><spanclass="re2"><spanclass="br0">{</span> 'Menu' <spanclass="sy0">=</span>><spanclass="br0">{</span> type <spanclass="sy0">=</span>> 'category', 'Example' <spanclass="sy0">=</span>><spanclass="br0">{</span> type <spanclass="sy0">=</span>> 'category', 'test1' <spanclass="sy0">=</span>><spanclass="br0">{</span> type <spanclass="sy0">=</span>> 'application', options <spanclass="sy0">=</span>><spanclass="br0">{</span> name <spanclass="sy0">=</span>> 'Application Test <spanclass="nu0">1</span>', uri <spanclass="sy0">=</span>> 'http://test1.example.com/', description <spanclass="sy0">=</span>> 'A simple application displaying authenticated user', logo <spanclass="sy0">=</span>> 'wheels.png', display <spanclass="sy0">=</span>> 'auto', <spanclass="br0">}</span>, <spanclass="br0">}</span>,'test2' <spanclass="sy0">=</span>><spanclass="br0">{</span> type <spanclass="sy0">=</span>> 'application', options <spanclass="sy0">=</span>><spanclass="br0">{</span> name <spanclass="sy0">=</span>> 'Application Test <spanclass="nu0">2</span>', uri <spanclass="sy0">=</span>> 'http://test2.example.com/', description <spanclass="sy0">=</span>> 'The same simple application displaying authenticated user', logo <spanclass="sy0">=</span>> 'wheels.png', display <spanclass="sy0">=</span>> 'auto', <spanclass="br0">}</span>, <spanclass="br0">}</span>, <spanclass="br0">}</span>,'Administration' <spanclass="sy0">=</span>><spanclass="br0">{</span> type <spanclass="sy0">=</span>> 'category', 'manager' <spanclass="sy0">=</span>><spanclass="br0">{</span> type <spanclass="sy0">=</span>> 'application', options <spanclass="sy0">=</span>><spanclass="br0">{</span> name <spanclass="sy0">=</span>> 'WebSSO Manager', uri <spanclass="sy0">=</span>> 'http://manager.example.com/', description <spanclass="sy0">=</span>> 'Configure LemonLDAP::NG WebSSO', logo <spanclass="sy0">=</span>> 'tools.png', display <spanclass="sy0">=</span>> 'on', <spanclass="br0">}</span>, <spanclass="br0">}</span>,'sessions' <spanclass="sy0">=</span>><spanclass="br0">{</span> type <spanclass="sy0">=</span>> 'application', options <spanclass="sy0">=</span>><spanclass="br0">{</span> name <spanclass="sy0">=</span>> 'Sessions explorer', uri <spanclass="sy0">=</span>> 'http://manager.example.com/sessions.pl', description <spanclass="sy0">=</span>> 'Explore WebSSO sessions', logo <spanclass="sy0">=</span>> 'tools.png', display <spanclass="sy0">=</span>> 'on', <spanclass="br0">}</span>, <spanclass="br0">}</span>, <spanclass="br0">}</span>,'Documentation' <spanclass="sy0">=</span>><spanclass="br0">{</span> type <spanclass="sy0">=</span>> 'category', 'localdoc' <spanclass="sy0">=</span>><spanclass="br0">{</span> type <spanclass="sy0">=</span>> 'application', options <spanclass="sy0">=</span>><spanclass="br0">{</span> name <spanclass="sy0">=</span>> 'Local documentation', uri <spanclass="sy0">=</span>> 'http://manager.example.com/doc/', description <spanclass="sy0">=</span>> 'Documentation supplied with LemonLDAP::NG', logo <spanclass="sy0">=</span>> 'docs.png', display <spanclass="sy0">=</span>> 'on', <spanclass="br0">}</span>, <spanclass="br0">}</span>,'officialwebsite' <spanclass="sy0">=</span>><spanclass="br0">{</span> type <spanclass="sy0">=</span>> 'application', options <spanclass="sy0">=</span>><spanclass="br0">{</span> name <spanclass="sy0">=</span>> 'Offical Website', uri <spanclass="sy0">=</span>> 'http://wiki.lemonldap.objectweb.org/xwiki/bin/view/NG/Presentation', description <spanclass="sy0">=</span>> 'Official LemonLDAP::NG Website', logo <spanclass="sy0">=</span>> 'web.png', display <spanclass="sy0">=</span>> 'o
<p>
<p><divclass="noteimportant">You should now use the Manager to configure all <ahref="../../documentation/1.2/portalmenu.html#categories_and_applications"class="wikilink1"title="documentation:1.2:portalmenu">applications and categories</a>, and then comment or remove the <code>applicationList</code> parameter from <code>/etc/lemonldap-ng/lemonldap-ng.ini</code>.
Configure your <acronymtitle="Domain Name System">DNS</acronym> server to resolve names with your server <acronymtitle="Internet Protocol">IP</acronym>.
</p>
<p>
<p><divclass="notetip">
For tests with <code>example.com</code>, launch the following :
<liclass="level1"><divclass="li"> Configuration is in /etc/lemonldap-ng</div>
</li>
<liclass="level1"><divclass="li"> LemonLDAP::NG configuration (edited by the Manager) is in /var/lib/lemonldap-ng/conf/</div>
</li>
<liclass="level1"><divclass="li"> All <acronymtitle="Practical Extraction and Report Language">Perl</acronym> modules are in the VENDOR perl directory </div>
</li>
<liclass="level1"><divclass="li"> All <acronymtitle="Practical Extraction and Report Language">Perl</acronym> scripts/pages are in /var/lib/lemonldap-ng/</div>
</li>
<liclass="level1"><divclass="li"> All static content (examples, <acronymtitle="Cascading Style Sheets">CSS</acronym>, images, etc.) is in /usr/share/lemonldap-ng/</div>
<liclass="level1"><divclass="li"> Install all build dependencies (see BuildRequires in lemonldap-ng.<acronymtitle="specification">spec</acronym>)</div>
</li>
<liclass="level1"><divclass="li"> Put LemonLDAP::NG tarball in %_topdir/SOURCES</div>
</li>
<liclass="level1"><divclass="li"> Edit ~/.rpmmacros and set your build parameters (example for RHEL5):</div>
</li>
</ul>
<preclass="file">
%_topdir /home/user/build
%dist .el5
%rhel 5
</pre>
<ul>
<liclass="level1"><divclass="li"> Go to %_topdir</div>