root/alternc-doc/branches/r0/admin/internals.xml

<?xml version="1.0" encoding="iso-8859-1"?>

<!-- $Revision$ -->

<chapter id="admin.internals">
<title>Fonctionnement interne d'AlternC</title>

<sect1><title>Debian / Alternc, une distribution linux et un panneau de configuration général</title>

<para>
AlternC est un produit basé sur la distribution Debian. Cette distribution propose un système de paquets d'installation (fichiers .deb) installables facilement (avec la commande dpkg) ou tout simplement téléchargeables automatiquement grâce à l'outil apt-get. AlternC utilise le système apt-get pour pouvoir s'installer. Il propose donc un dossier web (http://debian.alternc.org) où votre système pourra trouver les paquets d'AlternC.
</para>
<para>
AlternC se base sur des logiciels standards utilisés pour l'hébergement de contenu web, de mails, de listes ... Ces logiciels dont donc fournis par Debian, et nous utilisons les paquets standards Debian. Voici la liste des logiciels utilisés et de leur rôle, ceci n'est pas une référence, les outils utilisés pouvant changer avec le temps 
</para>

<screen>
Apache         Serveur Web (pages http)
Postfix        Serveur Smtp (courrier électronique)
Proftpd        Serveur Ftp (transfert de fichiers)
Bind9          Serveur Dns (noms de domaine)
Mailman        Serveur de listes de discussion / diffusion
Mysql4         Serveur de bases de données
Php4           Language de contenu dynamique
PhpMyAdmin     Interface web de gestion de données
Squirrelmail   Interface web de lecture de mail
AWstats        Statistiques web
Webalizer      Statistiques web
Courier Suite  Serveur pop, pops, imap, imaps
Spamassassin   Logiciel d'antispam
Clamav         Antivirus
</screen>

<para>
Chaque logiciel est installé par le système apt-get de debian, lors de l'installation d'AlternC (voire la documentation d'installation). A l'installation d'AlternC, celui-ci écrase les fichiers de configuration des différents logiciels ci-dessus, en les remplaçant par des versions optimisées et adaptées à l'hébergement de contenus mutualisés. Le paquet AlternC fournit donc des modèles de fichiers de configuration dans <filename>/usr/share/alternc/1.0/install/etc</filename> qui remplaceront ceux fournis par Debian. Ces fichiers contiennent des balises sous la forme %%variable%% où 'variable' provient du fichier de configuration générale d'AlternC : <filename>/etc/alternc/alternc.conf</filename>, que vous avez modifié avant d'installer AlternC.
</para>

<example><title>Exemple de Fichier de configuration AlternC</title>
<para>
Le fichier de configuration d'apache est dans /etc/apache/httpd.conf. on y retrouve entre autre :
</para>

<screen>
##
## httpd.conf -- Apache HTTP server configuration file (sample)
##
...
# Listen: Allows you to bind Apache to specific IP addresses and/or
#Listen 3000
#Listen 12.34.56.78:80
...
# BindAddress: You can support virtual hosts with this option. This directive
#BindAddress *
</screen>

<para>
Celui fourni avec AlternC contiendra des valeurs substituables à l'installation :
</para>

<screen>
# 
# Fichier de configuration principale d'Apache pour AlternC (extraits)
ServerType standalone
ServerRoot /etc/apache
MaxRequestsPerChild 100
Listen %%myip%%:80
BindAddress %%myip%%
...
</screen>

<para>
Ainsi l'installation d'AlternC pourra créer un fichier httpd.conf personnalisé pour votre serveur, ce qui donnerait :
</para>

<screen>
# 
# Fichier de configuration principale d'Apache pour AlternC (extraits)
ServerType standalone
ServerRoot /etc/apache
MaxRequestsPerChild 100
Listen 80.67.172.60:80
BindAddress 80.67.172.60
...
</screen>
</example>

</sect1>





<sect1><title>Apache, fonctionnement du serveur Web sous AlternC</title>

<para>
Le serveur web Apache est le plus connu et le plus utilisé des logiciels permettant de mettre à disposition des pages web (via la protocole http). Il est utilisé par AlternC, non seulement comme serveur permettant de mettre à disposition les pages web hébergées par les clients de votre serveur, mais il permet aussi d'accéder au panneau de configuration, le Bureau d'AlternC.
</para>
<para>
Avec la configuration Debian par défaut, apache ne sait pas gérer les domaines proprement : il sert toutes les pages web dans /var/www. AlternC modifie donc sa configuration pour supporter les domaines 'virtuels', à savoir la possibilité d'héberger plusieurs domaines sur un même serveur disposant d'une seule adresse ip. La ligne de configuration magique correspondante est la suivante :
<filename>VirtualDocumentRoot /var/alternc/dns/%-2.1/%0</filename>
</para>
<para>

Ce paramètre permet de diriger Apache automatiquement vers la page souhaitée en fonction du nom du domaine. %-2.1 signifie "le premier (1) caractère du second membre (2) du domaine en lisant par la droite (-)". Par exemple, pour le domaine www.alternc.org, apache va chercher le dossier <filename>/var/alternc/dns/a/www.alternc.org/</filename>. AlternC pose donc un lien symbolique a cet endroit, pointant vers le dossier choisi par l'hébergé dans son espace web.
</para>
<para>
Chaque hébergé dispose d'un espace web. Cet espace web est situé dans <filename>/var/alternc/html/e/essai</filename> pour le compte essai..., ainsi, si le compte essai fait pointer le domaine www.virtuel.org dans le dossier virt de son compte, il crée ce dossier, et le domaine pointera sous forme de lien symbolique de <filename>/var/alternc/html/e/essai/virt</filename> à l'emplacement <filename>/var/alternc/dns/v/www.virtuel.org</filename>.
</para>
<para>
Pour la gestion des domaines, il y a d'autres cas d'hébergement de domaines : dans le panneau de l'hébergé, ce dernier peut choisir plusieurs modes :
</para>

<itemizedlist>

<listitem><para>      Hébergément d'un domaine/sous-domaine vers un dossier de son espace web</para></listitem>
<listitem><para>      Redirection vers une adresse IP</para></listitem>
<listitem><para>      Redirection vers une autre url (http://...)</para></listitem>
<listitem><para>      Autre redirection : vers le webmail, le bureau ...</para></listitem>

</itemizedlist>

<para>
Le premier cas a été étudié ci-dessus.
</para>
<para>
Lorsque l'hébergé choisi de diriger un domaine vers une ip, aucun lien symbolique n'est créé dans <filename>/var/alternc/dns</filename>, mais la zone dns de l'hébergé reçoit une nouvelle ligne du type
</para>
<screen>
sousdomaine   IN   A   80.67.172.5 
</screen>
<para>
Ce fichier zone est situé dans <filename>/etc/bind/master/virtuel.org</filename> (par exemple, voir La section sur le serveur dns (bind)
</para>
<para>
Lorsque l'hébergé choisi de diriger un domaine vers une redirection http://, un lien symbolique est créé dans <filename>/var/alternc/dns/v/virtuel.org</filename> vers le dossier <filename>/var/alternc/dns/redir/v/virtuel.org/</filename> nouvellement créé, dans lequel on retrouve un fichier .htaccess. Ces fichiers sont des options de configuration d'Apache, et permettent de préciser notemment des redirections. Dans notre cas, on utilise les Rewrite Rules d'Apache pour rediriger l'internaute vers la page demandée. 
</para>

</sect1>




<sect1><title>Bind, le serveur DNS</title>
<para>
AlternC utilise Bind9 comme serveur dns, permettant ainsi l'hébergement complet de noms de domaines, enregistrés chez votre registrar préféré. Vous pouvez donc installer un domaine sur votre serveur AlternC et préciser votre serveur comme dns primaire du domaine. Bind9 est très simple d'utilisation : on retrouve un fichier zone par domaine dans le dossier <filename>/etc/bind/master</filename>, qui est référencé dans le fichier <filename>/etc/bind/automatic.conf</filename>. Ce fichier reçoit une ligne par domaine enregistré, prévenant bind que ce domaine est installé sur le serveur et qu'il en est le dns primaire.
</para>
<para>
La création, la modification et la suppression d'informations d'un domaine dans AlternC ne se fait pas de manière instantanée. Un script unix effectue les modifications nécessaires et redémarre bind si besoin toutes les 5 minutes. Ce script est situé dans /usr/lib/alternc/system/do_domaines.sh. Il est lancé par le système cron grâce au fichier <filename>/etc/cron.d/alternc</filename>
</para>

<example><title>Exemple de fichier zone</title>
<para>
Voici un exemple de fichier zone pour bind. On y retrouve toutes les informations sur le domaine concerné (ici mailfr.com) : TTL (durée de mise en cache maximale des informations), Serveur primaire (SOA primary.heberge.info), Serveurs de nom du domaine (NS primary et secondary), Serveur de courrier du domaine (MX = Mail Exchanger), et l'adresse IP du domaine vide (IN A) et de tous les sous-domaines (* IN A) :
</para>
<screen>
$TTL 1D
; BIND data file for domain mailfr.com
@       IN SOA primary.heberge.info. root.brassens.heberge.info. (
                2003082602      ; serial
                21600           ; refresh (6h)
                3600            ; retry (1h)
                604800          ; expiry (7d)
                86400 ) ; RR TTL (24h)

                IN      NS      primary.heberge.info.
                IN      NS      secondary.heberge.info.
                IN      MX 5    mx.heberge.info.
                IN      A       80.67.172.60
*               IN      A       80.67.172.60
</screen>
</example>
</sect1>


<sect1><title>Postfix, le serveur de Courrier</title>
<para>
AlternC utilise Postfix comme MTA (Mail Transfer Agent = serveur de courrier) pour recevoir et 
envoyer du courrier via le protocole smtp. les boites aux lettres sont stockées dans le serveur 
localement au format maildir dans un dossier sous <filename>/var/alternc/mail/</filename>. 
Par exemple, la boite aux lettres de <filename>benjamin@example.com</filename> est située dans 
<filename>/var/alternc/mail/b/benjamin_example.com/Maildir/</filename>
</para>
<para>
Le fichier de configuration principal de Postfix est <filename>/etc/postfix/main.cf</filename>. 
Il est modifié à l'installation d'AlternC pour aller chercher les emails dans une base MySQL 
fournie par le serveur MySQL Local. Cette base possède 2 tables principales : la table <command>mail_alias</command> et la table <command>mail_domain</command>. 
Une troisième table existe : <command>mail_users</command> qui contiendra les login/mot de passe 
pop/imap des boites aux lettres
</para>

</sect1>

</chapter>