root/alternc-doc/trunk/admin/install.xml

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

<!-- $Revision$ -->

<chapter id="admin.install">
<title>Installation d'AlternC</title>

<sect1><para>Avant d'installer un AlternC : Debian Linux.</para>

<sect2><title>Pré-requis : Debian GNU/Linux Sarge.</title>

<para>
AlternC fonctionne sur une distribution Debian GNU/Linux, la version conseillée actuellement est la Sarge (testing). Cette documentation présente l'installation sur une Sarge.
</para>

<para>
Pour installer AlternC, il suffit d'installer une Debian Sarge minimale, c'est à dire avec le minimum de packages nécessaires. Pour un serveur web, mail, mailing lists etc, il n'est pas utile d'installer kde, X11 etc. Cette documentation ne vise pas à apprendre l'installation d'une Debian, nous nous bornerons à expliquer les spécificités ou les choses à penser pour disposer d'un serveur AlternC optimal en fin d'installation.
</para>

</sect2>
<sect2><title>Conseils sur Debian Sarge.</title>

<para>
Voici quelques conseils pour l'installation de la Debian Sarge dans le cadre de l'installation d'AlternC : 
<itemizedlist>
        
        <listitem><para><command>postfix</command> : Lors de la sélection des packages à installer, si vous le pouvez, choisissez d'installer postfix plutôt qu'exim4. En effet, AlternC désinstallera exim pour mettre postfix à la place, autant le faire tout de suite.</para></listitem>
        
        <listitem><para><command>partitions</command> : Les données web et mails des utilisateurs seront situées dans <filename>/var/alternc/mail</filename> et <filename>/var/alternc/html</filename>. Aussi nous vous conseillons de réserver beaucoup de place sur votre disque pour cette partition (/var/alternc) ou pour /var lui-même. Notez que /var/log contiendra les logs de vos services et peut s'avérer gros aussi à terme. (dans des proportions moindres cependant. Enfin, les bases mysql sont dans <filename>/var/lib/mysql</filename>, l'emplacement normal des bases de données, et il est donc conseillé de disposer de disques rapides à cet endroit de votre système de fichier.</para></listitem>
        
        <listitem><para><command>optimisations</command> : sur Unix, il est vivement conseillé de mettre l'attribut <filename>noatime</filename> pour les partitions de votre système situées dans <filename>/etc/fstab</filename> à la colonne "options" de chaque partition. Cela ne concerne pas les partitions virtuelles telles que sysfs proc et usb.</para> </listitem>
        
        <listitem><para><command>Quotas de Groupe</command> : Si vous souhaitez pouvoir limiter l'espace disque disponible pour chaque compte AlternC présent sur votre serveur (web+mail), il vous faut activer les quotas de groupe pour la partition qui contiendra <filename>/var/alternc</filename> (donc <filename>/var/alternc</filename> ou <filename>/var</filename> ou <filename>/</filename>). Pour cela, ajouter l'option <filename>grpquota</filename> dans votre fichier <filename>/etc/fstab</filename>, dans la colonne "options" de cette partition. Notez que les quotas de groupe ne marchent qu'avec les systèmes de fichiers EXT2, EXT3 ou XFS. Il n'est possible de l'utiliser avec reiserfs uniquement avec un sérieux patch du noyau, (donc réservé aux experts !)</para></listitem>

        <listitem><para><command>fichier hosts</command> : Une fois que vous avez configuré correctement votre machine, y compris en lui donnant une adresse ip (soit fournie par votre hébergeur, soit une ip fixe sur une zone privée du type 192.168.0.x si vous êtes derrière un routeur adsl par exemple), n'oubliez pas de renseigner le nom complet de votre machine et son adresse ip dans le fichier <filename>/etc/hosts</filename>. en voici un exemple : </para>
<example><title>Exemple de fichier /etc/hosts</title>
<screen>
127.0.0.1       localhost       localhost.localdomain

192.168.0.10    alice           alice.virtuel.org
</screen>
</example>
        </listitem>
        
        <listitem><para>Sécurité avec SUDO</para> : Il est conseillé de ne pas se connecter par défaut en tant que "root" sur votre serveur. Nous vous conseillons de créer un compte utilisateur unix à votre prénom par exemple, en utilisant la commande <command>adduser &lt;votre prenom&gt;</command> et ensuite à vous donner le droit de lancer des commandes en tant que root grâce à l'utilitaire <command>visudo</command>. Pour cela, installez-le avec la commande "apt-get install sudo" puis donnez-vous des droits en tapant "visudo", ce qui éditera le fichier de droits de sudo.</listitem>
        
        <listitem><para><command>Locales, Langages</command> : Dans Debian, pour disposer de plusieurs langues de travail, donc pour faire fonctionner le multilinguisme dans AlternC, il est nécessaire de choisir la liste des langues et de générer les locales associées (les "locales" sont des fichiers de traduction). Pour cela, en tant que root, tapez <command>dpgk-reconfigure locales</command>. Ensuite, choisissez la liste des langues que vous voulez, nous vous conseillons en_US (iso-8859-1) et fr_FR (iso-8859-1). Notez que si vous choisissez iso-8859-15 pour fr_FR, cela peut ne pas marcher correctement avec le serveur web. Une fois les langues choisies et sélectionnées, vous pouvez choisir la langue par défaut de votre système. Enfin, debian génère les locales et vous rends la main. Pour valider ces modifications de langues, déconnectez-vous du serveur et reconnectez-vous.</para></listitem>

</itemizedlist>

</para>


</sect2>
</sect1>

<sect1><title>Installation d'AlternC</title>
<sect2><title>Le package Debian AlternC</title>

<para>
  Pour installer AlternC sur un serveur Debian GNU/Linux, il suffit d'ajouter dans votre fichier /etc/apt/sources.list la source de package officielle d'AlternC comme suit : 
<screen>
  deb http://debian.alternc.org/sarge main contrib
  deb-src http://debian.alternc.org/sarge main contrib
</screen>
Ensuite, avec <command>aptitude update</command>, mettez à jour la liste des packages disponibles pour apt. Si vous voulez vérifier que les packages d'AlternC sont bien disponibles, tapez apt-cache search alternc. apt doit vous retourner les packages d'AlternC et de ses plugins.
</para>
<para>
Enfin, pour installer AlternC, tapez <command>aptitude install alternc</command>. Le système de package debian installe alors AlternC et les packages en dépendance.
</para>
  <note><para>
  Si vous souhaitez installer les plugins d'AlternC pour mailman ou awstats ou encore les plugins pour cacti ou nagios, attendez de disposer d'un AlternC configuré et fonctionnel, car ces plugins nécessitent souvent un AlternC proprement configuré pour pouvoir être installés.
  </para></note>
<para>
  Lorsque les packages en dépendance d'AlternC s'installent, ils peuvent vous poser plusieurs questions. Pour la plupart des réponses il suffit de taper sur enter pour valider la valeur par défaut. D'ailleurs, la plupart de ces valeurs ne serviront à rien, car AlternC configurera pour vous  ces logiciels. 
</para>
<para>
  Pendant l'installation, nous vous demandons confirmation de l'installation d'AlternC sur le serveur. En effet, AlternC modifie de nombreux paramètres fondamentaux du serveur parmis lesquels la configuration d'apache, de postfix ou de proftpd. Si vous répondez oui à la confirmation, AlternC vous demande alors l'ensemble des paramètres de votre serveur. Dans la plupart des cas, vous pouvez vous contenter de cliquer sur Enter pour valider la valeur par défaut, qui doit être correctement prédéterminée. Voici donc la liste des questions que l'installation d'AlternC vous pose et leur signification : 
</para>

        
<itemizedlist>

        <listitem><para><command>Nom de domaine du bureau.</command> 
        Ce paramètre est le nom DNS (exemple demo.alternc.org) qui servira d'adresse pour le bureau d'administration. Les serveurs sous AlternC ont en effet un nom dns pour le bureau. On utilise généralement un sous-domaine du domaine principal de l'hebergeur ou de la structure concernée. 
Attention : il n'est pas prévu de pouvoir héberger d'emails ou de noms de domaines en dessous du nom choisi, c'est pour cela que nous conseillons d'utiliser un sous-domaine. 
Par exemple si vous vous appelez "virtuel" et que vous choisissez ici "virtuel.org", vous ne pourrez pas créer de mail "@virtuel.org" ou de sous-domaine qqchose.virtuel.org. Utilisez donc de préférence un nom comme "admin.virtuel.org" ou "elsa.virtuel.org". Vous pourrez ainsi toujours héberger le domaine "virtuel.org", des mails "@virtuel.org" etc.
</para>
<para>
        Le nom de domaine que vous entrez doit bien évidemment pointer vers l'ip publique du serveur, afin de permettre à vos utilisateurs d'accéder à leur panneau d'administration en tapant cette adresse dans leur navigateur.
        </para></listitem>
        <listitem><para><command>Nom de votre service d'hébergement.</command> 
        Ce paramètre est peu important, il s'agit du nom de votre service d'hébergement, nom qui sera affiché dans le panneau de contrôle web. Tout caractère autorisés, nous conseillons bien sur les noms courts. C'est un paramètre purement administratif.
        </para></listitem>
        <listitem><para><command>Nom de domaine du serveur de dns primaire.</command> 
        Les domaines que vous allez installer sur votre serveur peuvent être géré par AlternC au niveau DNS. Pour cela, ces domaines installés doivent avoir votre serveur comme dns primaire. Ce paramètre est donc le nom du serveur qui devra être le serveur DNS primaire des domaines que vos comptes voudront installer. Selon le tld utilisé (.fr, .com) ce paramètre peut être imposé pour l'installation de nouveaux domaines.
</para>
<para>
        Notez aussi que c'est ce nom DNS qui sera indiqué comme DNS PRIMAIRE pour la zone des domaines qui seront installés sur le serveur.
        </para></listitem>
        <listitem><para><command>Nom de domaine du serveur de dns secondaire.</command> 
        Chaque domaine doit disposer de 2 serveurs DNS. Aussi, vous pouvez ici renseigner le serveur DNS secondaire qui devra être celui des domaines à installer sur le serveur. C'est ce DNS secondaire qui sera indiqué dans la zone DNS des domaines installés sur votre serveur. 
</para>
<para>
        Si vous ne disposez pas de DNS secondaire, l'équipe d'AlternC se fera une joie de vous en fournir un. Pour cela, contactez les développeurs sur la liste dev@alternc.org en expliquant votre situation technique et le pourquoi du besoin de DNS
        </para></listitem>
        <listitem><para><command>Nom de domaine du serveur mysql.</command> 
        Il s'agit du nom dns du serveur MySQL qui hébergera vos bases de données. Laissez 'localhost' sauf si vous êtes dans une configuration distribuée en cluster pour laquelle un serveur MySQL externe est requis. Note : Il se peut que ce paramètre ne vous soit pas demandé, cela dépend de votre configuration de <command>dpkg</command>.
        </para></listitem>
        <listitem><para><command>Base système mysql d'AlternC.</command> 
        Ce paramètre est le nom de la base de données MySQL qui sera créée, qui contiendra les metadonnées des hébergés (comptes mails, comptes ftp, domaines etc.). Vous pouvez laisser la valeur par défaut "alternc". Note : Il se peut que ce paramètre ne vous soit pas demandé, cela dépend de votre configuration de <command>dpkg</command>.
        </para></listitem>
        <listitem><para><command>Compte mysql d'AlternC.</command> 
        Ce paramètre est le nom du compte utilisateur MySQL qui sera créé et qui aura accès aux metadonnées des hébergés. Vous pouvez laisser la valeur par défaut "alternc". Note : Il se peut que ce paramètre ne vous soit pas demandé, cela dépend de votre configuration de <command>dpkg</command>.
        </para></listitem>
        <listitem><para><command>Mot de passe du compte mysql.</command>
        Ce paramètre est le mot de passe du compte utilisateur MySQL qui aura accès aux metadonnées des hébergés. Note : Il se peut que ce paramètre ne vous soit pas demandé, cela dépend de votre configuration de <command>dpkg</command>.</para>
<note><para>
  Ce mot de passe peut être retrouvé par la suite dans les fichiers suivants du système : <command>/etc/alternc/local.sh, /etc/alternc/alternc.conf et /var/alternc/bureau/class/local.php</command>.
</para></note>
        </listitem>
        <listitem><para><command>L'adresse IP principale de ce serveur</command> 
        Il s'agit de l'adresse ip du serveur, telle qu'elle sera annoncée dans les zones DNS qui seront installées sur le serveur. Il se peut donc que ce soit une ip différente si votre serveur est derrière un NAT, mais dans la plupart des cas, il s'agit tout simplement de l'adresse ip du serveur. Voir le point suivant pour précisions.
        </para></listitem>
        <listitem><para><command>L'adresse IP interne du serveur</command> 
        Il s'agit de l'adresse ip physique du serveur sur son interface réseau publique (généralement eth0). </para>
<note><para>
Ce paramètre est souvent identique a L'adresse IP principale du serveur, sauf dans le cas où le serveur est derrière un routeur effectuant du NAT (Network Address Translation, ou 'translation d'adresse'). Dans ce cas, l'adresse principale est l'adresse externe du routeur NAT, et l'adresse interne est celle du serveur.
</para></note>
        </listitem>
        <listitem><para><command>Le MX à assigner aux nouveaux domaines</command> 
        Il s'agit du nom DNS qui sera spécifié sur le champs MX des domaines hébergés. Ce nom DNS doit donc normalement pointer vers l'ip du serveur, afin que ce dernier reçoive le mail. De plus, si vous utilisez le mode TLS de postfix pour autoriser les connexions cryptés avec votre SMTP, il faut que le nom DNS du certificat soit égal à ce nom DNS du MX pour que le certificat soit reconnu valide.        
        </para></listitem>
        <listitem><para><command>Nom de la partition d'AlternC</command> 
        Ce paramètre contient le nom de la partition disque sur laquelle pointe le dossier <filename>/var/alternc</filename>. Il peut donc s'agir du point de montage de <filename>/var/alternc</filename>, ou de <filename>/var</filename> ou encore de /, le premier trouvé. Ce paramètre permet de gérer les quotas d'espace disque par utilisateur AlternC.
        </para></listitem>
        <listitem><para><command>Serveur de surveillance</command> 
        </para></listitem>
        <listitem><para><command>Serveurs de confiance pour bind</command> 
        </para></listitem>
        <listitem><para><command>Réseaux autorisés en SMTP</command> 
        </para></listitem>
</itemizedlist>

<para>
  Une fois ces paramètres précisés dans les masques de saisie Debian, dpkg finit l'installation des packages et d'AlternC. L'installation d'AlternC consistant à initialiser les bases de données, copier les paramètres du bureau dans <filename>/etc/alternc</filename> et <filename>/var/alternc/bureau/class/local.php</filename>, et enfin d'écraser la configuration des services par des fichiers de configuration dépendant de la configuration d'AlternC et situés dans <filename>/etc/alternc/templates/</filename>.
</para>

<para>
La dernière étape de l'installation consiste à créer un compte AlternC administrateur, dont le login est <command>admin</command> et le mot de passe est <command>admin</command>. Vous pouvez donc vous connecter à l'adresse <filename>http://fqdn/</filename> en remplaçant "fqdn" par le nom DNS nommé "nom de domaine du bureau" dans les paramètres d'AlternC. connectez-vous alors avec le login / pass admin et allez dans "configuration" pour modifier votre mot de passe tout de suite (...)
</para>

</sect2>
<sect2><title>Les packages Debian des plugins d'AlternC</title>
<para>
  AlternC est une suite logicielle de panneau d'hébergement. En tant que telle, il existe donc des plugins, appelés aussi modules d'AlternC, qui permettent d'ajouter des fonctionnalités utiles à vos hébergés ou aux administrateurs système. On trouve par exemple un module alternc-mailman qui permet de gérer des listes de discussion ou de diffusion en utilisant le logiciel Mailman.
</para>
<para>
Voici la liste des modules disponibles pour AlternC (à date d'écriture de cette documentation) : 
<itemizedlist>
  <listitem><para><command>alternc-mailman</command> 
  </para></listitem>
  <listitem><para><command>alternc-procmailbuilder</command>
  </para></listitem>
  <listitem><para><command>alternc-awstats</command>
  </para></listitem>
  <listitem><para><command>alternc-webalizer</command>
  </para></listitem>
  <listitem><para><command>alternc-fetchmailbuilder</command>
  </para></listitem>
  <listitem><para><command>alternc-admintools</command>
  </para></listitem>
  <listitem><para><command>alternc-sympa</command>
  </para></listitem>
  <listitem><para><command>alternc-webinstaller</command>
  </para></listitem>
  <listitem><para><command>alternc-phpcron</command>
  </para></listitem>
<!-- 
 <listitem><para><command></command>
  </para></listitem>
 -->
</itemizedlist>
</para>
</sect2>
</sect1>

</chapter>