lemonldap-ng/build/lemonldap-ng/doc/3.2-Install-from-tarball.html
Clément Oudot 34ea9bacd1 Doc: add DBI
2010-03-22 14:41:35 +00:00

262 lines
7.3 KiB
HTML

<?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.2-Install-from-tarball.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="HInstallationfromthetarball">Installation
from the tarball</span></h2>
<p class="paragraph"></p>
<ul>
<li><a href="#HGetthetarball">Get the tarball</a></li>
<li><a href="#HBuildthetarballfromSVN">Build the tarball from
SVN</a></li>
<li><a href="#HExtraction">Extraction</a></li>
<li><a href="#HInstallation">Installation</a></li>
</ul>
<h3 class="heading-1-1"><span id="HGetthetarball">Get the
tarball</span></h3>
<p class="paragraph"></p>All tarballs can be downloaded from the OW2
forge: <span class="nobr"><a href=
"http://forge.objectweb.org/project/showfiles.php?group_id=274">http://forge.objectweb.org/project/showfiles.php?group_id=274</a></span>
<p class="paragraph"></p>If you want the last SVN snapshot, please choose:
<span class="nobr"><a href=
"http://forge.objectweb.org/svnsnapshots/lemonldap-svn-latest.tar.gz">http://forge.objectweb.org/svnsnapshots/lemonldap-svn-latest.tar.gz</a></span>
<p class="paragraph"></p><strong class="strong">Warning</strong>: the
contents of the SVN tarball are not the same as the official tarballs.
Please see the next chapter to learn how build an official tarball from
SVN files.
<h3 class="heading-1-1"><span id="HBuildthetarballfromSVN">Build the
tarball from SVN</span></h3>
<p class="paragraph"></p>Either <span class="wikiexternallink"><a href=
"http://forge.objectweb.org/plugins/scmsvn/index.php?group_id=274">checkout
or export the SVN repository</a></span>, or <span class=
"wikiexternallink"><a href=
"http://forge.objectweb.org/svnsnapshots/lemonldap-svn-latest.tar.gz">extract
the SVN tarball</a></span> to get the SVN files on your disk.
<p class="paragraph"></p>Then go to build directory:
<div class="code">
<pre>
$ cd trunk/build/lemonldap-ng
</pre>
</div><br />
<br />
And run the "dist" target:
<div class="code">
<pre>
$ make dist
</pre>
</div><br />
<br />
The generated tarball is in the current directory.
<h3 class="heading-1-1"><span id=
"HExtraction">Extraction</span></h3><br />
<br />
Just run the tar command:
<div class="code">
<pre>
$ tar zxvf lemonldap-ng-*.tar.gz
</pre>
</div>
<h3 class="heading-1-1"><span id=
"HInstallation">Installation</span></h3><br />
<br />
First check and install the <span class="wikilink"><a href=
"3.1-Install-prerequesites.html">prerequisites</a></span>.<br />
<br />
For full install:<br />
<br />
<div class="code">
<pre>
$ cd lemonldap-ng-*
$ make
$ make configure
$ make test
$ sudo make install
</pre>
</div>
<p class="paragraph"></p>You can modify location of default storage
configuration file in configure target:
<div class="code">
<pre>
$ sudo make configure STORAGECONFFILE=/etc/lemonldap-ng/lemonldap-ng.ini
</pre>
</div><br />
<br />
You can choose other Makefile targets:
<ul class="star">
<li>Perl libraries install :
<ul class="star">
<li>install_libs (all Perl libraries)</li>
<li>install_portal_libs</li>
<li>install_manager_libs</li>
<li>install_handler_libs</li>
</ul>
</li>
<li>Binaries install :
<ul class="star">
<li>install_bin (/usr/local/lemonldap-ng/bin)</li>
</ul>
</li>
<li>Web sites install :
<ul class="star">
<li>install_site (all sites including install_doc_site)</li>
<li>install_portal_site (/usr/local/lemonldap-ng/htdocs/portal)</li>
<li>install_manager_site
(/usr/local/lemonldap-ng/htdocs/manager)</li>
<li>install_handler_site (/usr/local/lemonldap-ng/handler)</li>
</ul>
</li>
<li>Documentation install :
<ul class="star">
<li>install_doc_site (/usr/local/lemonldap-ng/htdocs/doc)</li>
<li>install_examples_site (/usr/local/lemonldap-ng/examples)</li>
</ul>
</li>
</ul>You can also pass parameters to the make install command, with this
syntax:
<div class="code">
<pre>
$ sudo make install PARAM=VALUE PARAM=VALUE ...
</pre>
</div><br />
<br />
Available parameters are:
<ul class="star">
<li><strong class="strong">ERASECONFIG</strong>: set to 0 if you want to
keep your configuration files (default: 1)</li>
<li><strong class="strong">DESTDIR</strong>: only for packaging, install
the product in a jailroot (default: "")</li>
<li><strong class="strong">PREFIX</strong>: installation directory
(default: /usr/local)</li>
<li><strong class="strong">STORAGECONFFILE</strong>: location of default
storage configuration file (default:
/usr/local/lemonldap-ng/etc/lemonldap-ng.ini)</li>
<li><strong class="strong">CRONDIR</strong>: Cronfile directory
(default: $PREFIX/etc/lemonldap-ng/cron.d)</li>
<li><strong class="strong">APACHEUSER</strong>: user running Apache</li>
<li><strong class="strong">APACHEGROUP</strong>: group running
Apache</li>
<li><strong class="strong">DNSDOMAIN</strong>: Main DNS domain (default:
example.com)</li>
<li><strong class="strong">LDAPHOST</strong>: LDAP server (default:
localhost)</li>
<li><strong class="strong">LDAPPORT</strong>: LDAP port (default:
389)</li>
<li><strong class="strong">LDAPSUFFIX</strong>: LDAP suffix (default:
dc=example,dc=com)</li>
<li><strong class="strong">APACHEVERSION</strong>: Apache major version
(default: 2)</li>
<li><strong class="strong">VHOSTLISTEN</strong>: how listen parameter is
configured for virtual hosts in Apache (default: <strong class=
"strong">:80)</strong></li>
<li><strong class="strong">*WITHLA</strong>: install Liberty Alliance
portal (default: 0)</li>
</ul>
</div>
<p class="footer"><a href="index.html">Index</a></p>
</body>
</html>