338 lines
12 KiB
HTML
338 lines
12 KiB
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="fr"
|
|
lang="fr" dir="ltr">
|
|
|
|
<head>
|
|
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
|
|
<title></title><!-- metadata --><!-- style sheet links -->
|
|
|
|
<meta name="generator" content="Hors ligne" />
|
|
<meta name="version" content="Hors-ligne 0.1" />
|
|
|
|
<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="installation_on_red_hatcentos">Installation on Red Hat/CentOS</h1>
|
|
<div class="level1">
|
|
|
|
</div><!-- EDIT1 SECTION "Installation on Red Hat/CentOS" [1-46] -->
|
|
|
|
<h2 class="sectionedit2" id="organization">Organisation</h2>
|
|
<div class="level2">
|
|
|
|
<p>
|
|
|
|
LemonLDAP::NG provides packages for Red Hat/Centos 6 and 7:
|
|
|
|
</p>
|
|
<ul>
|
|
<li class="level1"><div class="li"> lemonldap-ng : meta-paquet qui ne contient aucun fichier mais des dépendances vers les autres paquets</div>
|
|
</li>
|
|
<li class="level1"><div class="li"> lemonldap-ng-doc : contient la documentation <abbr title="HyperText Markup Language">HTML</abbr> et celle du projet (README, etc...)</div>
|
|
</li>
|
|
<li class="level1"><div class="li"> lemonldap-ng-fr-doc: French translation for documentation</div>
|
|
</li>
|
|
<li class="level1"><div class="li"> lemonldap-ng-conf : contient la configuration par défaut (domaine <abbr title="Domain Name System">DNS</abbr> : example.com)</div>
|
|
</li>
|
|
<li class="level1"><div class="li"> lemonldap-ng-test: contains sample CGI test page</div>
|
|
</li>
|
|
<li class="level1"><div class="li"> lemonldap-ng-handler : contient l'implémentation de l'agent pour Apache (handler)</div>
|
|
</li>
|
|
<li class="level1"><div class="li"> lemonldap-ng-manager : contient l'interface d'administration et l'explorateur de session</div>
|
|
</li>
|
|
<li class="level1"><div class="li"> lemonldap-ng-portal : contient le portail d'authentification et le menu</div>
|
|
</li>
|
|
<li class="level1"><div class="li"> lemonldap-ng-fastcgi-server: FastCGI server needed to use Nginx</div>
|
|
</li>
|
|
<li class="level1"><div class="li"> perl-Lemonldap-NG-Common : CPAN - modules partagés</div>
|
|
</li>
|
|
<li class="level1"><div class="li"> perl-Lemonldap-NG-Handler : CPAN - modules agent</div>
|
|
</li>
|
|
<li class="level1"><div class="li"> perl-Lemonldap-NG-Manager : CPAN - modules manager</div>
|
|
</li>
|
|
<li class="level1"><div class="li"> perl-Lemonldap-NG-Portal : CPAN - modules portail</div>
|
|
</li>
|
|
</ul>
|
|
|
|
</div><!-- EDIT2 SECTION "Organization" [47-993] -->
|
|
|
|
<h2 class="sectionedit3" id="get_the_packages">Obtenir ces paquets</h2>
|
|
<div class="level2">
|
|
|
|
</div><!-- EDIT3 SECTION "Get the packages" [994-1023] -->
|
|
|
|
<h3 class="sectionedit4" id="yum_repository">Dépôt YUM</h3>
|
|
<div class="level3">
|
|
|
|
<p>
|
|
Ajouter ces dépôts YUM pour obtenir les paquets récents :
|
|
</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/rpm6/
|
|
enabled=1
|
|
gpgcheck=1
|
|
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-OW2</pre>
|
|
|
|
<p>
|
|
</p><p></p><div class="notetip">
|
|
|
|
Change the base <abbr title="Uniform Resource Locator">URL</abbr> for EL7 packages:
|
|
|
|
</p>
|
|
<pre class="file">baseurl=http://lemonldap-ng.org/rpm7/</pre>
|
|
|
|
<p>
|
|
|
|
</p></div></p>
|
|
</p>
|
|
|
|
<p>
|
|
Lancer ceci pour rafraîchir le cache :
|
|
</p>
|
|
<pre class="code">yum update</pre>
|
|
|
|
<p>
|
|
</p><p></p><div class="notewarning">
|
|
You must also install the EPEL repository for non-core dependencies. Voir le chapître <a href="../../documentation/1.9/prereq.html#yum" class="wikilink1" title="documentation:1.9:prereq">pré-requis et dépendances</a>.
|
|
|
|
</div></p>
|
|
</p>
|
|
|
|
</div><!-- EDIT4 SECTION "YUM repository" [1024-1658] -->
|
|
|
|
<h3 class="sectionedit5" id="manual_download">Téléchargement manuel</h3>
|
|
<div class="level3">
|
|
|
|
<p>
|
|
Les paquets RPM sont disponibles sur la <a href="../../download.html" class="wikilink1" title="Téléchargement">page de téléchargement</a>.
|
|
</p>
|
|
|
|
</div><!-- EDIT5 SECTION "Manual download" [1659-1741] -->
|
|
|
|
<h2 class="sectionedit6" id="package_gpg_signature">Signature GPG des paquets</h2>
|
|
<div class="level2">
|
|
|
|
<p>
|
|
La clef GPG peut être téléchargée ici : <a href="../media/rpm-gpg-key-ow2" class="media mediafile mf_" title="rpm-gpg-key-ow2 (1.7 KB)">rpm-gpg-key-ow2</a>
|
|
</p>
|
|
|
|
<p>
|
|
L'installer pour certifier les RPMs:
|
|
</p>
|
|
<pre class="code">rpm --import rpm-gpg-key-ow2</pre>
|
|
|
|
</div><!-- EDIT6 SECTION "Package GPG signature" [1742-1907] -->
|
|
|
|
<h2 class="sectionedit7" id="install_packages">Installer les paquets</h2>
|
|
<div class="level2">
|
|
|
|
</div><!-- EDIT7 SECTION "Install packages" [1908-1937] -->
|
|
|
|
<h3 class="sectionedit8" id="with_yum">Avec YUM</h3>
|
|
<div class="level3">
|
|
|
|
<p>
|
|
Si les paquets sont stockés dans un dépôt yum :
|
|
</p>
|
|
<pre class="code shell">yum install lemonldap-ng</pre>
|
|
<pre class="code shell">Transaction Summary
|
|
===================================================
|
|
Install 82 Package(s)
|
|
Upgrade 0 Package(s)
|
|
|
|
Total download size: 18 M
|
|
Is this ok [y/N]: y</pre>
|
|
|
|
<p>
|
|
On peut aussi utiliser yum sur des fichiers RPMs locaux :
|
|
</p>
|
|
<pre class="code">yum localinstall lemonldap-ng-* perl-Lemonldap-NG-*</pre>
|
|
|
|
</div><!-- EDIT8 SECTION "With YUM" [1938-2355] -->
|
|
|
|
<h3 class="sectionedit9" id="with_rpm">Avec RPM</h3>
|
|
<div class="level3">
|
|
|
|
<p>
|
|
Avant d'installer les paquets, installer toutes les <a href="../../documentation/1.9/prereq.html" class="wikilink1" title="documentation:1.9:prereq">dépendances</a>.
|
|
</p>
|
|
|
|
<p>
|
|
Il faut ensuite installer tous les paquets téléchargés :
|
|
</p>
|
|
<pre class="code">rpm -Uvh lemonldap-ng-* perl-Lemonldap-NG-*</pre>
|
|
|
|
<p>
|
|
</p><p></p><div class="notetip">
|
|
On peut n'installer qu'un seul composant en choisissant le paquet <code>lemonldap-ng-portal</code>, <code>lemonldap-ng-handler</code> ou <code>lemonldap-ng-manager</code>.
|
|
</p>
|
|
|
|
<p>
|
|
Installer le paquet <code>lemonldap-ng-conf</code> sur tous les serveurs qui contiennent un de ces paquets.
|
|
|
|
</p></div></p>
|
|
</p>
|
|
|
|
</div><!-- EDIT9 SECTION "With RPM" [2356-2823] -->
|
|
|
|
<h2 class="sectionedit10" id="first_configuration_steps">Premiers pas de configuration</h2>
|
|
<div class="level2">
|
|
|
|
</div><!-- EDIT10 SECTION "First configuration steps" [2824-2862] -->
|
|
|
|
<h3 class="sectionedit11" id="change_default_dns_domain">Changer le domaine DNS par défaut</h3>
|
|
<div class="level3">
|
|
|
|
<p>
|
|
Par défaut, le domaine <abbr title="Domain Name System">DNS</abbr> est <code>example.com</code>. On peut le changer rapidement par une commande sed. Par exemple, pour le changer en <code>ow2.org</code>:
|
|
</p>
|
|
<pre class="code shell">sed -i 's/example\.com/ow2.org/g' /etc/lemonldap-ng/* /var/lib/lemonldap-ng/conf/lmConf-1 /var/lib/lemonldap-ng/test/index.pl</pre>
|
|
|
|
</div><!-- EDIT11 SECTION "Change default DNS domain" [2863-3177] -->
|
|
|
|
<h3 class="sectionedit12" id="apache_virtual_host">Hôte virtuel Apache :</h3>
|
|
<div class="level3">
|
|
|
|
<p>
|
|
Si <abbr title="LemonLDAP::NG">LL::NG</abbr> est le seul logiciel installé sur Apache, la fonctionnalité d'hôte virtuel peut ne pas avoir été activée.
|
|
</p>
|
|
|
|
<p>
|
|
Pour ce faire, décommenter la ligne <code>NameVirtualHost</code> dans <code>/etc/httpd/conf.d/z-lemonldap-ng-handler.conf</code> :
|
|
</p>
|
|
<pre class="code file apache"><span class="kw1">NameVirtualHost</span> *:<span class="nu0">80</span></pre>
|
|
|
|
<p>
|
|
Vérifier la configuration d'Apache et redémarrer :
|
|
</p>
|
|
<pre class="code shell">apachectl configtest
|
|
apachectl restart</pre>
|
|
|
|
</div><!-- EDIT12 SECTION "Apache virtual host" [3178-3572] -->
|
|
|
|
<h3 class="sectionedit13" id="default_virtual_host">Default virtual host</h3>
|
|
<div class="level3">
|
|
|
|
<p>
|
|
|
|
Apache on RedHat comes with a default virtual host:
|
|
|
|
</p>
|
|
<pre class="code file apache"><<span class="kw3">LocationMatch</span> <span class="st0">"^/+$"</span>>
|
|
<span class="kw1">Options</span> -<span class="kw2">Indexes</span>
|
|
<span class="kw1">ErrorDocument</span> 403 /.noindex.html
|
|
</<span class="kw3">LocationMatch</span>></pre>
|
|
|
|
<p>
|
|
|
|
This conflicts with LemonLDAP::NG ErrorDocument configuration, so you need to comment this part of the vhost.
|
|
If you have an apache fresh install, it can be a good idea to completely disable the welcome vhost.
|
|
|
|
</p>
|
|
|
|
</div><!-- EDIT13 SECTION "Default virtual host" [3573-3980] -->
|
|
|
|
<h3 class="sectionedit14" id="reload_virtual_host">Recharger l'hôte virtuel</h3>
|
|
<div class="level3">
|
|
|
|
<p>
|
|
Pour autoriser le manager à recharger la configuration, enregistrer le nom d'hôte virtuel de rechargement dans le fichier hosts du serveur :
|
|
</p>
|
|
<pre class="code shell">echo "127.0.0.1 reload.example.com" >> /etc/hosts</pre>
|
|
|
|
<p>
|
|
</p><p></p><div class="notetip">Adapter le nom d'hôte virtuel de rechargement au domaine configuré.
|
|
</div></p>
|
|
</p>
|
|
|
|
</div><!-- EDIT14 SECTION "Reload virtual host" [3981-4282] -->
|
|
|
|
<h3 class="sectionedit15" id="upgrade">Mise à jour</h3>
|
|
<div class="level3">
|
|
|
|
<p>
|
|
Pour mettre à jour <abbr title="LemonLDAP::NG">LL::NG</abbr>, lisez toutes les <a href="../../documentation/1.9/upgrade.html" class="wikilink1" title="documentation:1.9:upgrade">notes de mise à jour</a>.
|
|
</p>
|
|
|
|
</div><!-- EDIT15 SECTION "Upgrade" [4283-4363] -->
|
|
|
|
<h3 class="sectionedit16" id="dns">DNS</h3>
|
|
<div class="level3">
|
|
|
|
<p>
|
|
Configurer le serveur <abbr title="Domain Name System">DNS</abbr> pour résoudre les noms avec l'adresse <abbr title="Internet Protocol">IP</abbr> de votre serveur.
|
|
</p>
|
|
|
|
<p>
|
|
</p><p></p><div class="notetip">
|
|
Pour les tests avec <code>example.com</code>, lancer ce qui suit :
|
|
</p>
|
|
<pre class="code shell">cat /etc/lemonldap-ng/for_etc_hosts >> /etc/hosts</pre>
|
|
|
|
<p>
|
|
|
|
</p></div></p>
|
|
</p>
|
|
|
|
<p>
|
|
Suivre les <a href="../../documentation/1.9/start.html#configuration" class="wikilink1" title="documentation:1.9:start">étapes suivantes</a>
|
|
</p>
|
|
|
|
</div><!-- EDIT16 SECTION "DNS" [4364-4636] -->
|
|
|
|
<h2 class="sectionedit17" id="file_location">Emplacement du fichier</h2>
|
|
<div class="level2">
|
|
<ul>
|
|
<li class="level1"><div class="li"> La configuration se trouve dans /etc/lemonldap-ng</div>
|
|
</li>
|
|
<li class="level1"><div class="li"> La configuration LemonLDAP::NG (editée par le manager) se trouve dans /var/lib/lemonldap-ng/conf/</div>
|
|
</li>
|
|
<li class="level1"><div class="li"> All Perl modules are in the VENDOR perl directory </div>
|
|
</li>
|
|
<li class="level1"><div class="li"> All Perl scripts/pages are in /var/lib/lemonldap-ng/</div>
|
|
</li>
|
|
<li class="level1"><div class="li"> Tous le contenu statique (exemples, <abbr title="Cascading Style Sheets">CSS</abbr>, images, etc...) se trouve dans /usr/share/lemonldap-ng/</div>
|
|
</li>
|
|
</ul>
|
|
|
|
</div><!-- EDIT17 SECTION "File location" [4637-4993] -->
|
|
|
|
<h2 class="sectionedit18" id="build_your_packages">Construire les paquets</h2>
|
|
<div class="level2">
|
|
|
|
<p>
|
|
Si besoin, on peut reconstruire les RPMs :
|
|
</p>
|
|
<ul>
|
|
<li class="level1"><div class="li"> Install rpm-build package</div>
|
|
</li>
|
|
<li class="level1"><div class="li"> Installer toutes les dépendances de construction (voir BuildRequires dans lemonldap-ng.<abbr title="spécification">spec</abbr>)</div>
|
|
</li>
|
|
<li class="level1"><div class="li"> Mettre l'archive LemonLDAP::NG dans %_topdir/SOURCES</div>
|
|
</li>
|
|
<li class="level1"><div class="li"> Edit ~/.rpmmacros and set your build parameters (example for RHEL6):</div>
|
|
</li>
|
|
</ul>
|
|
<pre class="file">%_topdir /home/user/build
|
|
%dist .el6
|
|
%rhel 6</pre>
|
|
<ul>
|
|
<li class="level1"><div class="li"> Aller dans %_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>
|
|
</div><!-- closes <div class="dokuwiki export">--></body></html> |