lemonldap-ng/doc/pages/documentation/quickstart.html


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"
 lang="en" dir="ltr">

<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title></title>
<!-- metadata -->
<meta name="generator" content="Offline" />
<meta name="version" content="Offline 0.1" />
<!-- style sheet links -->
<link rel="stylesheet" media="all" type="text/css" href="../../css/all.css" />
<link rel="stylesheet" media="screen" type="text/css" href="../../css/screen.css" />
<link rel="stylesheet" media="print" type="text/css" href="../../css/print.css" />

</head>
<body>
<div class="dokuwiki export">


<h1 class="sectionedit1" id="quick_start_tutorial">Quick start tutorial</h1>
<div class="level1">

<p>
<p><div class="noteimportant">
This tutorial will guide you into a minimal installation and configuration procedure. You need some prerequisites:
</p>
<ul>
<li class="level1"><div class="li"> A computer with a GNU/Linux or recent UNIX system</div>
</li>
<li class="level1"><div class="li"> A web browser launched from the computer (to access localhost)</div>
</li>
<li class="level1"><div class="li"> A cup of coffee (or tea, we are open minded)</div>
</li>
</ul>

<p>

</div></p>
</p>

</div>
<!-- EDIT1 SECTION "Quick start tutorial" [1-347] -->
<h2 class="sectionedit2" id="installation">Installation</h2>
<div class="level2">

<p>
You can install Lemonldap::NG using <a href="../download.html" class="wikilink1" title="download">packages</a> (rpm or deb) or by hand as described below.
</p>

<p>
LemonLDAP::NG is written in Perl and requires a lot of Perl dependencies. <a href="../documentation/current/prereq.html" class="wikilink1" title="documentation:latest:prereq">You must install them first</a>.
</p>

<p>
Get the tarball on <a href="../download.html" class="wikilink1" title="download">download page</a> and follow next steps (or install using <a href="../documentation/current/installrpm.html" class="wikilink1" title="documentation:latest:installrpm">RPM</a> or <a href="../documentation/current/installdeb.html" class="wikilink1" title="documentation:latest:installdeb">Debian</a> packages):
</p>

</div>
<!-- EDIT2 SECTION "Installation" [348-801] -->
<h3 class="sectionedit3" id="extract">Extract</h3>
<div class="level3">
<pre class="code">tar zxvf lemonldap-ng-*.tar.gz
cd lemonldap-ng-*</pre>

</div>
<!-- EDIT3 SECTION "Extract" [802-885] -->
<h3 class="sectionedit4" id="build">Build</h3>
<div class="level3">
<pre class="code">make
make test</pre>

</div>
<!-- EDIT4 SECTION "Build" [886-933] -->
<h3 class="sectionedit5" id="install">Install</h3>
<div class="level3">
<pre class="code">sudo make install</pre>

</div>
<!-- EDIT5 SECTION "Install" [934-986] -->
<h2 class="sectionedit6" id="configuration">Configuration</h2>
<div class="level2">

</div>
<!-- EDIT6 SECTION "Configuration" [987-1013] -->
<h3 class="sectionedit7" id="system">System</h3>
<div class="level3">

<p>
Update your /etc/hosts to map <abbr title="Single Sign On">SSO</abbr> URLs to localhost:
</p>
<pre class="code">sudo make postconf</pre>

</div>
<!-- EDIT7 SECTION "System" [1014-1119] -->
<h3 class="sectionedit8" id="apache">Apache</h3>
<div class="level3">

<p>
Include LemonLDAP::NG configuration in your main Apache configuration:
</p>
<pre class="code file apache"><span class="kw1">include</span> /usr/local/lemonldap-ng/etc/portal-apache2.conf
<span class="kw1">include</span> /usr/local/lemonldap-ng/etc/handler-apache2.conf
<span class="kw1">include</span> /usr/local/lemonldap-ng/etc/manager-apache2.conf
<span class="kw1">include</span> /usr/local/lemonldap-ng/etc/test-apache2.conf</pre>

<p>
Restart Apache:
</p>
<pre class="code">sudo apachectl configtest
sudo apachectl restart</pre>

</div>
<!-- EDIT8 SECTION "Apache" [1120-1537] -->
<h2 class="sectionedit9" id="run">Run</h2>
<div class="level2">

<p>
Since LemonLDAP::NG 1.2, the <a href="../documentation/current/authdemo.html" class="wikilink1" title="documentation:latest:authdemo">demonstration backend</a> is configured by default. Demonstration backend has hard coded user accounts:
</p>
<div class="table sectionedit10"><table class="inline">
	<thead>
	<tr class="row0 roweven">
		<th class="col0 leftalign"> Login  </th><th class="col1"> Password </th><th class="col2"> Role </th>
	</tr>
	</thead>
	<tr class="row1 rowodd">
		<td class="col0 centeralign">  rtyler  </td><td class="col1 centeralign">  rtyler  </td><td class="col2 centeralign">  user  </td>
	</tr>
	<tr class="row2 roweven">
		<td class="col0 centeralign">  msmith  </td><td class="col1 centeralign">  msmith  </td><td class="col2 centeralign">  user  </td>
	</tr>
	<tr class="row3 rowodd">
		<td class="col0 centeralign">  dwho  </td><td class="col1 centeralign">  dwho  </td><td class="col2 centeralign">  administrator  </td>
	</tr>
</table></div>
<!-- EDIT10 TABLE [1720-1852] -->
</div>
<!-- EDIT9 SECTION "Run" [1538-1854] -->
<h3 class="sectionedit11" id="open_sso_session">Open SSO session</h3>
<div class="level3">

<p>
Go on <a href="http://auth.example.com" class="urlextern" title="http://auth.example.com"  rel="nofollow">http://auth.example.com</a> and log with one of the demonstration account.
</p>

</div>
<!-- EDIT11 SECTION "Open SSO session" [1855-1960] -->
<h3 class="sectionedit12" id="access_protected_application">Access protected application</h3>
<div class="level3">

<p>
Try <a href="http://test1.example.com" class="urlextern" title="http://test1.example.com"  rel="nofollow">http://test1.example.com</a> or <a href="http://test2.example.com" class="urlextern" title="http://test2.example.com"  rel="nofollow">http://test2.example.com</a>
</p>

</div>
<!-- EDIT12 SECTION "Access protected application" [1961-2058] -->
<h3 class="sectionedit13" id="edit_configuration">Edit configuration</h3>
<div class="level3">

<p>
Log with the dwho account and go on <a href="http://manager.example.com" class="urlextern" title="http://manager.example.com"  rel="nofollow">http://manager.example.com</a>
</p>

</div>
</div><!-- closes <div class="dokuwiki export">-->
Update documentation script to request the new wiki (#192) 15 years ago
			`<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"`
			`"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">`
			`<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"`
			`lang="en" dir="ltr">`

			`<head>`
			`<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />`
			`<title></title>`
			`<!-- metadata -->`
			`<meta name="generator" content="Offline" />`
			`<meta name="version" content="Offline 0.1" />`
			`<!-- style sheet links -->`
			`<link rel="stylesheet" media="all" type="text/css" href="../../css/all.css" />`
			`<link rel="stylesheet" media="screen" type="text/css" href="../../css/screen.css" />`
			`<link rel="stylesheet" media="print" type="text/css" href="../../css/print.css" />`

			`</head>`
			`<body>`
			`<div class="dokuwiki export">`


Update documentation (new dokuwiki version) 11 years ago			`<h1 class="sectionedit1" id="quick_start_tutorial">Quick start tutorial</h1>`
Update documentation script to request the new wiki (#192) 15 years ago			`<div class="level1">`

			`<p>`
			`<p><div class="noteimportant">`
			`This tutorial will guide you into a minimal installation and configuration procedure. You need some prerequisites:`
			`</p>`
			`<ul>`
			`<li class="level1"><div class="li"> A computer with a GNU/Linux or recent UNIX system</div>`
			`</li>`
			`<li class="level1"><div class="li"> A web browser launched from the computer (to access localhost)</div>`
			`</li>`
			`<li class="level1"><div class="li"> A cup of coffee (or tea, we are open minded)</div>`
			`</li>`
			`</ul>`

			`<p>`

			`</div></p>`
			`</p>`

			`</div>`
Update documentation (new dokuwiki version) 11 years ago			`<!-- EDIT1 SECTION "Quick start tutorial" [1-347] -->`
			`<h2 class="sectionedit2" id="installation">Installation</h2>`
Update documentation script to request the new wiki (#192) 15 years ago			`<div class="level2">`

			`<p>`
Doc update 15 years ago			`You can install Lemonldap::NG using <a href="../download.html" class="wikilink1" title="download">packages</a> (rpm or deb) or by hand as described below.`
Doc update 15 years ago			`</p>`

			`<p>`
Update documentation (new dokuwiki version) 11 years ago			`LemonLDAP::NG is written in Perl and requires a lot of Perl dependencies. <a href="../documentation/current/prereq.html" class="wikilink1" title="documentation:latest:prereq">You must install them first</a>.`
Update documentation script to request the new wiki (#192) 15 years ago			`</p>`

			`<p>`
Correct links in offline documentation to map latest/ to current/ (#442) 14 years ago			`Get the tarball on <a href="../download.html" class="wikilink1" title="download">download page</a> and follow next steps (or install using <a href="../documentation/current/installrpm.html" class="wikilink1" title="documentation:latest:installrpm">RPM</a> or <a href="../documentation/current/installdeb.html" class="wikilink1" title="documentation:latest:installdeb">Debian</a> packages):`
Update documentation script to request the new wiki (#192) 15 years ago			`</p>`

			`</div>`
Update documentation (new dokuwiki version) 11 years ago			`<!-- EDIT2 SECTION "Installation" [348-801] -->`
			`<h3 class="sectionedit3" id="extract">Extract</h3>`
Update documentation script to request the new wiki (#192) 15 years ago			`<div class="level3">`
Update documentation (new dokuwiki version) 11 years ago			`<pre class="code">tar zxvf lemonldap-ng-*.tar.gz`
			`cd lemonldap-ng-*</pre>`
Update documentation script to request the new wiki (#192) 15 years ago
			`</div>`
Update documentation (new dokuwiki version) 11 years ago			`<!-- EDIT3 SECTION "Extract" [802-885] -->`
			`<h3 class="sectionedit4" id="build">Build</h3>`
Update documentation script to request the new wiki (#192) 15 years ago			`<div class="level3">`
Update documentation (new dokuwiki version) 11 years ago			`<pre class="code">make`
			`make test</pre>`
Update documentation script to request the new wiki (#192) 15 years ago
			`</div>`
Update documentation (new dokuwiki version) 11 years ago			`<!-- EDIT4 SECTION "Build" [886-933] -->`
			`<h3 class="sectionedit5" id="install">Install</h3>`
Update documentation script to request the new wiki (#192) 15 years ago			`<div class="level3">`
Update documentation (new dokuwiki version) 11 years ago			`<pre class="code">sudo make install</pre>`
Update documentation script to request the new wiki (#192) 15 years ago
			`</div>`
Update documentation (new dokuwiki version) 11 years ago			`<!-- EDIT5 SECTION "Install" [934-986] -->`
			`<h2 class="sectionedit6" id="configuration">Configuration</h2>`
Update documentation script to request the new wiki (#192) 15 years ago			`<div class="level2">`

			`</div>`
Update documentation (new dokuwiki version) 11 years ago			`<!-- EDIT6 SECTION "Configuration" [987-1013] -->`
			`<h3 class="sectionedit7" id="system">System</h3>`
Update documentation script to request the new wiki (#192) 15 years ago			`<div class="level3">`

			`<p>`
Update documentation (new dokuwiki version) 11 years ago			`Update your /etc/hosts to map <abbr title="Single Sign On">SSO</abbr> URLs to localhost:`
Update documentation script to request the new wiki (#192) 15 years ago			`</p>`
Update documentation (new dokuwiki version) 11 years ago			`<pre class="code">sudo make postconf</pre>`
Update documentation script to request the new wiki (#192) 15 years ago
			`</div>`
Update documentation (new dokuwiki version) 11 years ago			`<!-- EDIT7 SECTION "System" [1014-1119] -->`
			`<h3 class="sectionedit8" id="apache">Apache</h3>`
Update documentation script to request the new wiki (#192) 15 years ago			`<div class="level3">`

			`<p>`
			`Include LemonLDAP::NG configuration in your main Apache configuration:`
			`</p>`
			`<pre class="code file apache"><span class="kw1">include</span> /usr/local/lemonldap-ng/etc/portal-apache2.conf`
			`<span class="kw1">include</span> /usr/local/lemonldap-ng/etc/handler-apache2.conf`
Update doc 13 years ago			`<span class="kw1">include</span> /usr/local/lemonldap-ng/etc/manager-apache2.conf`
			`<span class="kw1">include</span> /usr/local/lemonldap-ng/etc/test-apache2.conf</pre>`
Update documentation script to request the new wiki (#192) 15 years ago
			`<p>`
			`Restart Apache:`
			`</p>`
Update documentation (new dokuwiki version) 11 years ago			`<pre class="code">sudo apachectl configtest`
			`sudo apachectl restart</pre>`
Update documentation script to request the new wiki (#192) 15 years ago
			`</div>`
Update documentation (new dokuwiki version) 11 years ago			`<!-- EDIT8 SECTION "Apache" [1120-1537] -->`
			`<h2 class="sectionedit9" id="run">Run</h2>`
Update documentation script to request the new wiki (#192) 15 years ago			`<div class="level2">`

Documentation update 14 years ago			`<p>`
Update doc in trunk for version 1.3 14 years ago			`Since LemonLDAP::NG 1.2, the <a href="../documentation/current/authdemo.html" class="wikilink1" title="documentation:latest:authdemo">demonstration backend</a> is configured by default. Demonstration backend has hard coded user accounts:`
Documentation update 14 years ago			`</p>`
Update documentation (new dokuwiki version) 11 years ago			`<div class="table sectionedit10"><table class="inline">`
			`<thead>`
Documentation update 14 years ago			`<tr class="row0 roweven">`
			`<th class="col0 leftalign"> Login </th><th class="col1"> Password </th><th class="col2"> Role </th>`
			`</tr>`
Update documentation (new dokuwiki version) 11 years ago			`</thead>`
Documentation update 14 years ago			`<tr class="row1 rowodd">`
			`<td class="col0 centeralign"> rtyler </td><td class="col1 centeralign"> rtyler </td><td class="col2 centeralign"> user </td>`
			`</tr>`
			`<tr class="row2 roweven">`
			`<td class="col0 centeralign"> msmith </td><td class="col1 centeralign"> msmith </td><td class="col2 centeralign"> user </td>`
			`</tr>`
			`<tr class="row3 rowodd">`
			`<td class="col0 centeralign"> dwho </td><td class="col1 centeralign"> dwho </td><td class="col2 centeralign"> administrator </td>`
			`</tr>`
Update documentation (new dokuwiki version) 11 years ago			`</table></div>`
			`<!-- EDIT10 TABLE [1720-1852] -->`
Update documentation script to request the new wiki (#192) 15 years ago			`</div>`
Update documentation (new dokuwiki version) 11 years ago			`<!-- EDIT9 SECTION "Run" [1538-1854] -->`
			`<h3 class="sectionedit11" id="open_sso_session">Open SSO session</h3>`
Update documentation script to request the new wiki (#192) 15 years ago			`<div class="level3">`

			`<p>`
Documentation update 14 years ago			`Go on <a href="http://auth.example.com" class="urlextern" title="http://auth.example.com" rel="nofollow">http://auth.example.com</a> and log with one of the demonstration account.`
Update documentation script to request the new wiki (#192) 15 years ago			`</p>`

			`</div>`
Update documentation (new dokuwiki version) 11 years ago			`<!-- EDIT11 SECTION "Open SSO session" [1855-1960] -->`
			`<h3 class="sectionedit12" id="access_protected_application">Access protected application</h3>`
Update documentation script to request the new wiki (#192) 15 years ago			`<div class="level3">`

			`<p>`
Work on documentation (#171) 15 years ago			`Try <a href="http://test1.example.com" class="urlextern" title="http://test1.example.com" rel="nofollow">http://test1.example.com</a> or <a href="http://test2.example.com" class="urlextern" title="http://test2.example.com" rel="nofollow">http://test2.example.com</a>`
Update documentation script to request the new wiki (#192) 15 years ago			`</p>`

			`</div>`
Update documentation (new dokuwiki version) 11 years ago			`<!-- EDIT12 SECTION "Access protected application" [1961-2058] -->`
			`<h3 class="sectionedit13" id="edit_configuration">Edit configuration</h3>`
Update documentation script to request the new wiki (#192) 15 years ago			`<div class="level3">`

			`<p>`
Documentation update 14 years ago			`Log with the dwho account and go on <a href="http://manager.example.com" class="urlextern" title="http://manager.example.com" rel="nofollow">http://manager.example.com</a>`
Update documentation script to request the new wiki (#192) 15 years ago			`</p>`

			`</div>`
Update documentation (new dokuwiki version) 11 years ago			`</div><!-- closes <div class="dokuwiki export">-->`