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

258 lines
7.6 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.3-Install-from-redhat-packages.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=
"HInstallationonRedHat2FCentOS">Installation on RedHat/CentOS</span></h2>
<p class="paragraph"></p>
<ul>
<li><a href="#HRPMsorganization">RPMs organization</a></li>
<li><a href="#HGetthepackages">Get the packages</a></li>
<li><a href="#HBuildyourpackages">Build your packages</a></li>
<li><a href="#HPackageGPGsignature">Package GPG signature</a></li>
<li><a href="#HInstallpackageswithyum">Install packages with
yum</a></li>
<li><a href="#HInstallpackageswithrpm">Install packages with
rpm</a></li>
<li><a href="#HInstalljustonecomponent">Install just one
component</a></li>
<li><a href="#HFilelocation">File location</a></li>
<li><a href="#HChangedefaultDNSdomain">Change default DNS
domain</a></li>
</ul>
<h3 class="heading-1-1"><span id="HRPMsorganization">RPMs
organization</span></h3>
<p class="paragraph"></p>LemonLDAP::NG provides many RPMs :
<ul class="star">
<li>lemonldap-ng: meta-package, contains no file but dependencies on
other packages</li>
<li>lemonldap-ng-doc: contains HTML documentation and project docs
(README, etc.)</li>
<li>lemonldap-ng-conf: contains default configuration (DNS domain:
example.com)</li>
<li>lemonldap-ng-test: contains sample CGI test page</li>
<li>lemonldap-ng-handler: contains Apache Handler implementation
(agent)</li>
<li>lemonldap-ng-manager: contains administration interface and session
explorer</li>
<li>lemonldap-ng-portal: contains authentication portal and menu</li>
<li>perl-Lemonldap-NG-Common: CPAN - Shared modules</li>
<li>perl-Lemonldap-NG-Handler: CPAN - Handler modules</li>
<li>perl-Lemonldap-NG-Manager: CPAN - Manager modules</li>
<li>perl-Lemonldap-NG-Portal: CPAN - Portal modules</li>
</ul>This schema shows the dependencies between modules:
<p class="paragraph"></p><img src="lemonldap-ng-packages.png" alt=
"lemonldap-ng-packages.png" />
<h3 class="heading-1-1"><span id="HGetthepackages">Get the
packages</span></h3>
<p class="paragraph"></p>For now, RPMS are only available in the
<span class="wikiexternallink"><a href=
"http://forge.objectweb.org/project/showfiles.php?group_id=274">download
section of lemonldap project on OW2 forge</a></span>. The first RPMS came
with version 0.9.3.
<h3 class="heading-1-1"><span id="HBuildyourpackages">Build your
packages</span></h3>
<ul class="star">
<li>Install rpm-build package</li>
<li>Install all build dependencies (see BuildRequires in
lemonldap-ng.spec)</li>
<li>Put lemonldap-ng.spec in %_topdir/SPECS</li>
<li>Put LemonLDAP::NG tarball in %_topdir/SOURCES</li>
<li>Edit ~/.rpmmacros and set your build parameters (example for
RHEL5):</li>
</ul>
<div class="code">
<pre>
%_topdir /home/user/build
%dist .el5
%rhel 5
</pre>
</div>
<ul class="star">
<li>Go to %_topdir</li>
<li>Do rpmbuild -ba SPECS/lemonldap-ng.spec</li>
</ul>
<h3 class="heading-1-1"><span id="HPackageGPGsignature">Package GPG
signature</span></h3><br />
<br />
The GPG key can be downloaded here: <span class=
"wikiexternallink"><a href="http://wiki.lemonldap.ow2.org/xwiki/bin/download/NG/DocInstallRedHatPackages/RPM-GPG-KEY-OW2">
http://wiki.lemonldap.ow2.org/xwiki/bin/download/NG/DocInstallRedHatPackages/RPM-GPG-KEY-OW2</a></span><br />
<br />
Install it to trust RPMs:<br />
<br />
<div class="code">
<pre>
# rpm --<span class="java-keyword">import</span> <span class="nobr"><a href=
"http://wiki.lemonldap.ow2.org/xwiki/bin/download/NG/DocInstallRedHatPackages/RPM&amp;#45;GPG&amp;#45;KEY&amp;#45;OW2">http://wiki.lemonldap.ow2.org/xwiki/bin/download/NG/DocInstallRedHatPackages/RPM-GPG-KEY-OW2</a></span>
</pre>
</div>
<h3 class="heading-1-1"><span id="HInstallpackageswithyum">Install
packages with yum</span></h3><br />
<br />
If the packages are stored in a yum repository:<br />
<br />
<div class="code">
<pre>
# yum install lemonldap-ng
</pre>
</div><br />
<br />
You can also use yum on local RPMs file, to manage dependencies:
<div class="code">
<pre>
# yum install lemonldap-ng-* perl-Lemonldap-NG-*
</pre>
</div>
<h3 class="heading-1-1"><span id="HInstallpackageswithrpm">Install
packages with rpm</span></h3><br />
<br />
Before installing the packages, install <span class="wikilink"><a href=
"3.1-Install-prerequesites.html">dependencies</a></span>.<br />
<br />
You have then to install all the downloaded packages:
<div class="code">
<pre>
# rpm -Uvh lemonldap-ng-* perl-Lemonldap-NG-*
</pre>
</div>
<h3 class="heading-1-1"><span id="HInstalljustonecomponent">Install just
one component</span></h3><br />
<br />
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.
<h3 class="heading-1-1"><span id="HFilelocation">File location</span></h3>
<ul class="star">
<li>Configuration is in /etc/lemonldap-ng</li>
<li>LemonLDAP::NG configuration (edited by the Manager) is in
/var/lib/lemonldap-ng/conf/</li>
<li>All Perl modules are in the VENDOR perl directory</li>
<li>All Perl scripts/pages are in /var/lib/lemonldap-ng/</li>
<li>All static content (examples, CSS, images, etc.) is in
/usr/share/lemonldap-ng/</li>
</ul>
<h3 class="heading-1-1"><span id="HChangedefaultDNSdomain">Change default
DNS domain</span></h3><br />
<br />
By default, DNS domain is "example.com". You can change it quick with a
sed command. For example, we change it to ow2.org:<br />
<br />
<div class="code">
<pre>
# sed -i 's/example.com/ow2.org/g' /etc/lemonldap-ng/apache2.conf /etc/lemonldap-ng/apps-list.xml /<span class="java-keyword">var</span>/lib/lemonldap-ng/conf/lmConf-1 /etc/lemonldap-ng/apply.conf /<span class="java-keyword">var</span>/lib/lemonldap-ng/test/index.pl
</pre>
</div>
</div>
<p class="footer"><a href="index.html">Index</a></p>
</body>
</html>