Commit 84520302 authored by Xavier Guimard's avatar Xavier Guimard

Doc update

parent ef5decc1
......@@ -25,13 +25,22 @@
<h1><a name="exported_variables" id="exported_variables">Exported variables</a></h1>
<div class="level1">
</div>
<!-- SECTION "Exported variables" [1-34] -->
<h2><a name="presentation" id="presentation">Presentation</a></h2>
<div class="level2">
<p>
Exported variables are the variables available to <a href="../../documentation/1.0/writingrulesand_headers.html" class="wikilink1" title="documentation:1.0:writingrulesand_headers">write rules and headers</a>. They are extracted from the users database by the <a href="../../documentation/1.0/start.html#authentication_users_and_password_databases" class="wikilink1" title="documentation:1.0:start">users module</a>.
</p>
<p>
To create a variable, you&#039;ve just to map a user attributes in Lemonldap::NG using “Variables » Exported variables”. For each variable, The first field is the name which will be used in rules, macros or headers and the second field is the name of the user database field. Examples for <a href="../../documentation/1.0/authldap.html" class="wikilink1" title="documentation:1.0:authldap">LDAP</a>:
To create a variable, you&#039;ve just to map a user attributes in <acronym title="LemonLDAP::NG">LL::NG</acronym> using <code>Variables</code> » <code>Exported variables</code>. For each variable, The first field is the name which will be used in rules, macros or headers and the second field is the name of the user database field.
</p>
<p>
Examples for <a href="../../documentation/1.0/authldap.html" class="wikilink1" title="documentation:1.0:authldap">LDAP</a>:
</p>
<table class="inline">
<tr class="row0 roweven">
......@@ -50,11 +59,11 @@ To create a variable, you&#039;ve just to map a user attributes in Lemonldap::NG
<p>
<a href="/_detail/documentation/exportedvars.png?id=documentation%3A1.0%3Aexportedvars" class="media" title="documentation:exportedvars.png"><img src="../../../media/documentation/exportedvars.png" class="media" title="Exported variables in the manager" alt="Exported variables in the manager" width="500" /></a>
<a href="/_detail/documentation/exportedvars.png?id=documentation%3A1.0%3Aexportedvars" class="media" title="documentation:exportedvars.png"><img src="../../../media/documentation/exportedvars.png" class="mediacenter" title="Exported variables in the Manager" alt="Exported variables in the Manager" width="500" /></a>
</p>
</div>
<!-- SECTION "Exported variables" [1-743] -->
<!-- SECTION "Presentation" [35-771] -->
<h2><a name="extend_variables_using_macros_and_groups" id="extend_variables_using_macros_and_groups">Extend variables using macros and groups</a></h2>
<div class="level2">
<div class="plugin_include_content" id="plugin_include__documentation:1.0:performances">
......@@ -101,4 +110,4 @@ admin <span class="sy0">-&gt;</span> <span class="re0">$uid</span> <span class="
<div class="level2">
</div>
<!-- SECTION "Extend variables using macros and groups" [744-] --></div><!-- closes <div class="dokuwiki export">-->
\ No newline at end of file
<!-- SECTION "Extend variables using macros and groups" [772-] --></div><!-- closes <div class="dokuwiki export">-->
\ No newline at end of file
......@@ -60,6 +60,7 @@ LemonLDAP::NG provides many RPMs :
</ul>
<p>
This schema shows the dependencies between modules:
</p>
......@@ -68,51 +69,56 @@ This schema shows the dependencies between modules:
</p>
</div>
<!-- SECTION "RPMs organization" [46-945] -->
<!-- SECTION "RPMs organization" [46-944] -->
<h2><a name="get_the_packages" id="get_the_packages">Get the packages</a></h2>
<div class="level2">
</div>
<!-- SECTION "Get the packages" [945-974] -->
<h3><a name="yum_repository" id="yum_repository">YUM repository</a></h3>
<div class="level3">
<p>
For now, RPMS are only available on the <a href="../../download.html" class="wikilink1" title="download">Download page</a>.
</p>
You can add this YUM repository to get recent packages:
</div>
<!-- SECTION "Get the packages" [946-1045] -->
<h2><a name="build_your_packages" id="build_your_packages">Build your packages</a></h2>
<div class="level2">
</p>
<pre class="code">
vi /etc/yum.repos.d/lemonldap-ng.repo
</pre>
<pre class="file">
[lemonldap-ng]
name=LemonLDAP::NG packages
baseurl=http://lemonldap-ng.org/rpm/
enabled=1
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-OW2
</pre>
<p>
You must also install a repository for non-core dependencies. Example with EPEL:
If you need it, you can rebuild RPMs:
</p>
<ul>
<li class="level1"><div class="li"> Install rpm-build package</div>
</li>
<li class="level1"><div class="li"> Install all build dependencies (see BuildRequires in lemonldap-ng.<acronym title="specification">spec</acronym>)</div>
</li>
<li class="level1"><div class="li"> Put LemonLDAP::NG tarball in %_topdir/SOURCES</div>
</li>
<li class="level1"><div class="li"> Edit ~/.rpmmacros and set your build parameters (example for RHEL5):</div>
</li>
</ul>
<pre class="file">
%_topdir /home/user/build
%dist .el5
%rhel 5
</pre>
<ul>
<li class="level1"><div class="li"> Go to %_topdir</div>
</li>
<li class="level1"><div class="li"> Build:</div>
</li>
</ul>
<pre class="code">
rpmbuild -ta SOURCES/lemonldap-ng-VERSION.tar.gz
rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm
</pre>
<p>
See <a href="../../documentation/1.0/prereq.html#yum" class="wikilink1" title="documentation:1.0:prereq">Prerequisites and dependencies</a> chapter for more.
</p>
</div>
<!-- SECTION "Build your packages" [1046-1500] -->
<!-- SECTION "YUM repository" [975-1527] -->
<h3><a name="manual_download" id="manual_download">Manual download</a></h3>
<div class="level3">
<p>
RPMs are available on the <a href="../../download.html" class="wikilink1" title="download">Download page</a>.
</p>
</div>
<!-- SECTION "Manual download" [1528-1610] -->
<h2><a name="package_gpg_signature" id="package_gpg_signature">Package GPG signature</a></h2>
<div class="level2">
......@@ -129,7 +135,7 @@ rpm --import rpm-gpg-key-ow2
</pre>
</div>
<!-- SECTION "Package GPG signature" [1501-1666] -->
<!-- SECTION "Package GPG signature" [1611-1776] -->
<h2><a name="install_packages_with_yum" id="install_packages_with_yum">Install packages with yum</a></h2>
<div class="level2">
......@@ -138,20 +144,31 @@ rpm --import rpm-gpg-key-ow2
If the packages are stored in a yum repository:
</p>
<pre class="code">
yum install lemonldap-ng
</pre>
<pre class="code shell"># yum install lemonldap-ng
...
Transaction Summary
===================================================
Install 82 Package(s)
Upgrade 0 Package(s)
&nbsp;
Total download size: 18 M
Is this ok [y/N]: y</pre>
<p>
You can also use yum on local RPMs file, to manage dependencies:
You can also use yum on local RPMs file:
</p>
<pre class="code">
yum install lemonldap-ng-* perl-Lemonldap-NG-*
# yum localinstall lemonldap-ng-* perl-Lemonldap-NG-*
</pre>
<p>
<p><div class="noteimportant">In any cases, you will need to add a repository hosting <acronym title="Practical Extraction and Report Language">Perl</acronym> modules dependencies, like EPEL, see <a href="../../documentation/1.0/prereq.html" class="wikilink1" title="documentation:1.0:prereq">dependencies</a>.
</div></p>
</p>
</div>
<!-- SECTION "Install packages with yum" [1667-1922] -->
<!-- SECTION "Install packages with yum" [1777-2347] -->
<h2><a name="install_packages_with_rpm" id="install_packages_with_rpm">Install packages with rpm</a></h2>
<div class="level2">
......@@ -169,17 +186,21 @@ rpm -Uvh lemonldap-ng-* perl-Lemonldap-NG-*
</pre>
</div>
<!-- SECTION "Install packages with rpm" [1923-2141] -->
<!-- SECTION "Install packages with rpm" [2348-2566] -->
<h2><a name="install_just_one_component" id="install_just_one_component">Install just one component</a></h2>
<div class="level2">
<p>
You can choose to install only one component by choosing the package lemonldap-ng-portal, lemonldap-ng-handler or lemonldap-ng-manager. Install the package lemonldap-ng-conf only on the server which stores configuration.
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>.
</p>
<p>
Install the package <code>lemonldap-ng-conf</code> only on the server which stores configuration.
</p>
</div>
<!-- SECTION "Install just one component" [2142-2403] -->
<!-- SECTION "Install just one component" [2567-2845] -->
<h2><a name="file_location" id="file_location">File location</a></h2>
<div class="level2">
<ul>
......@@ -196,7 +217,7 @@ You can choose to install only one component by choosing the package lemonldap-n
</ul>
</div>
<!-- SECTION "File location" [2404-2759] -->
<!-- SECTION "File location" [2846-3201] -->
<h2><a name="change_default_dns_domain" id="change_default_dns_domain">Change default DNS domain</a></h2>
<div class="level2">
......@@ -209,4 +230,38 @@ sed -i &#039;s/example\.com/ow2.org/g&#039; /etc/lemonldap-ng/* /var/lib/lemonld
</pre>
</div>
<!-- SECTION "Change default DNS domain" [2760-] --></div><!-- closes <div class="dokuwiki export">-->
\ No newline at end of file
<!-- SECTION "Change default DNS domain" [3202-3512] -->
<h2><a name="build_your_packages" id="build_your_packages">Build your packages</a></h2>
<div class="level2">
<p>
If you need it, you can rebuild RPMs:
</p>
<ul>
<li class="level1"><div class="li"> Install rpm-build package</div>
</li>
<li class="level1"><div class="li"> Install all build dependencies (see BuildRequires in lemonldap-ng.<acronym title="specification">spec</acronym>)</div>
</li>
<li class="level1"><div class="li"> Put LemonLDAP::NG tarball in %_topdir/SOURCES</div>
</li>
<li class="level1"><div class="li"> Edit ~/.rpmmacros and set your build parameters (example for RHEL5):</div>
</li>
</ul>
<pre class="file">
%_topdir /home/user/build
%dist .el5
%rhel 5
</pre>
<ul>
<li class="level1"><div class="li"> Go to %_topdir</div>
</li>
<li class="level1"><div class="li"> Build:</div>
</li>
</ul>
<pre class="code">
rpmbuild -ta SOURCES/lemonldap-ng-VERSION.tar.gz
</pre>
</div>
<!-- SECTION "Build your packages" [3513-] --></div><!-- closes <div class="dokuwiki export">-->
\ No newline at end of file
......@@ -283,6 +283,8 @@ LemonLDAP::NG is the first <acronym title="Single Sign On">SSO</acronym> softwar
<a href="/_detail/icons/clock.png?id=start" class="media" title="icons:clock.png"><img src="../media/icons/clock.png" class="media" alt="" /></a>
</div>
</p>
<ul class="rss"><li><div class="li"><a href="http://websvn.ow2.org/revision.php?repname=lemonldap&amp;path=%2F&amp;rev=1864" class="urlextern" title="http://websvn.ow2.org/revision.php?repname=lemonldap&amp;path=%2F&amp;rev=1864" rel="nofollow">French translation in progress</a> by guimard (2010/11/28 13:14)</div></li><li><div class="li"><a href="http://websvn.ow2.org/revision.php?repname=lemonldap&amp;path=%2F&amp;rev=1863" class="urlextern" title="http://websvn.ow2.org/revision.php?repname=lemonldap&amp;path=%2F&amp;rev=1863" rel="nofollow">Doc update and french translation in progress</a> by guimard (2010/11/28 08:37)</div></li><li><div class="li"><a href="http://websvn.ow2.org/revision.php?repname=lemonldap&amp;path=%2F&amp;rev=1862" class="urlextern" title="http://websvn.ow2.org/revision.php?repname=lemonldap&amp;path=%2F&amp;rev=1862" rel="nofollow">Test to run under Apache user to verify that Poratl ...</a> by guimard (2010/11/27 19:42)</div></li><li><div class="li"><a href="http://websvn.ow2.org/revision.php?repname=lemonldap&amp;path=%2F&amp;rev=1861" class="urlextern" title="http://websvn.ow2.org/revision.php?repname=lemonldap&amp;path=%2F&amp;rev=1861" rel="nofollow">Hide authentication loop on reset password (#LEMONLDAP-253)</a> by clement_oudot (2010/11/27 17:23)</div></li><li><div class="li"><a href="http://websvn.ow2.org/revision.php?repname=lemonldap&amp;path=%2F&amp;rev=1860" class="urlextern" title="http://websvn.ow2.org/revision.php?repname=lemonldap&amp;path=%2F&amp;rev=1860" rel="nofollow">Doc update</a> by guimard (2010/11/27 17:19)</div></li></ul>
<ul class="rss"><li><div class="li"><a href="http://websvn.ow2.org/revision.php?repname=lemonldap&amp;path=%2F&amp;rev=1869" class="urlextern" title="http://websvn.ow2.org/revision.php?repname=lemonldap&amp;path=%2F&amp;rev=1869" rel="nofollow">Require a minimal version of Perl (5.008)</a> by clement_oudot (2010/11/29 15:32)</div></li><li><div class="li"><a href="http://websvn.ow2.org/revision.php?repname=lemonldap&amp;path=%2F&amp;rev=1868" class="urlextern" title="http://websvn.ow2.org/revision.php?repname=lemonldap&amp;path=%2F&amp;rev=1868" rel="nofollow">Fix default jquery-ui theme for sessions explorer</a> by clement_oudot (2010/11/29 15:31)</div></li><li><div class="li"><a href="http://websvn.ow2.org/revision.php?repname=lemonldap&amp;path=%2F&amp;rev=1867" class="urlextern" title="http://websvn.ow2.org/revision.php?repname=lemonldap&amp;path=%2F&amp;rev=1867" rel="nofollow">Work on RPM (#LEMONLDAP-206):
* Minify JS and CSS
* Launch upgrade ...</a> by clement_oudot (2010/11/29 15:30)</div></li><li><div class="li"><a href="http://websvn.ow2.org/revision.php?repname=lemonldap&amp;path=%2F&amp;rev=1866" class="urlextern" title="http://websvn.ow2.org/revision.php?repname=lemonldap&amp;path=%2F&amp;rev=1866" rel="nofollow">Manage old Config::IniFiles version in migration script (#LEMONLDAP-255)</a> by clement_oudot (2010/11/29 11:14)</div></li><li><div class="li"><a href="http://websvn.ow2.org/revision.php?repname=lemonldap&amp;path=%2F&amp;rev=1865" class="urlextern" title="http://websvn.ow2.org/revision.php?repname=lemonldap&amp;path=%2F&amp;rev=1865" rel="nofollow">Doc update</a> by clement_oudot (2010/11/28 15:14)</div></li></ul>
</div>
<!-- SECTION "SVN activity" [3361-] --></div><!-- closes <div class="dokuwiki export">-->
\ No newline at end of file
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment