Changeset 1131

Show
Ignore:
Timestamp:
05/15/05 17:39:08 (4 years ago)
Author:
benjamin
Message:

installation, suite.

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved
  • trunk/admin/install.xml

    r1129 r1131  
    3232         
    3333        <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 professionnels !)</para></listitem> 
    34          
     34 
    3535        <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> 
    3636<example><title>Exemple de fichier /etc/hosts</title> 
     
    3838127.0.0.1       localhost       localhost.localdomain 
    3939 
    40 192.168.0.10    alice           alice.myserver.com 
    41  
    42 # The following lines are desirable for IPv6 capable hosts 
    43 ::1     ip6-localhost ip6-loopback 
    44 fe00::0 ip6-localnet 
    45 ff00::0 ip6-mcastprefix 
    46 ff02::1 ip6-allnodes 
    47 ff02::2 ip6-allrouters 
    48 ff02::3 ip6-allhosts 
     40192.168.0.10    alice           alice.virtuel.org 
    4941</screen> 
    5042</example> 
     
    6557<sect1><title>Installation d'AlternC</title> 
    6658<sect2><title>Le package Debian AlternC</title> 
     59 
    6760<para> 
     61  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 :  
     62<screen> 
     63  deb http://debian.alternc.org/sarge main contrib 
     64  deb-src http://debian.alternc.org/sarge main contrib 
     65</screen> 
     66Ensuite, avec <command>apt-get</command> update, 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. 
     67</para> 
     68<para> 
     69Enfin, pour installer AlternC, tapez <command>apt-get install alternc postfix</command>. Le système de package debian installe alors AlternC et les packages en dépendance. Il est nécessaire d'installer postfix en même temps pour forcer la désinstallation d'un éventuel logiciel de courrier comme exim ou sendmail qui aurait pu être installé préalablement.  
     70</para> 
     71  <note><para> 
     72  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. 
     73  </para></note> 
     74<para> 
     75  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 écrase les fichiers de configuration de ces logiciels.  
     76</para> 
     77<para> 
     78  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 :  
     79</para> 
    6880 
     81         
     82</itemizedlist> 
     83 
     84        <listitem><para><command>Nom de domaine du bureau.</command>  
     85        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.  
     86Attention : 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.  
     87Par 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. 
    6988</para> 
     89<para> 
     90        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. 
     91        </para></listitem> 
     92        <listitem><para><command>Nom de votre service d'hébergement.</command>  
     93        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. 
     94        </para></listitem> 
     95        <listitem><para><command>Nom de domaine du serveur de dns primaire.</command>  
     96        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. 
     97</para> 
     98<para> 
     99        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. 
     100        </para></listitem> 
     101        <listitem><para><command>Nom de domaine du serveur de dns secondaire.</command>  
     102        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.  
     103</para> 
     104<para> 
     105        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 
     106        </para></listitem> 
     107        <listitem><para><command>Nom de domaine du serveur mysql.</command>  
     108        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>. 
     109        </para></listitem> 
     110        <listitem><para><command>Base système mysql d'AlternC.</command>  
     111        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>. 
     112        </para></listitem> 
     113        <listitem><para><command>Compte mysql d'AlternC.</command>  
     114        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>. 
     115        </para></listitem> 
     116        <listitem><para><command>Mot de passe du compte mysql.</command> 
     117        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> 
     118<note><para> 
     119  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>. 
     120</para></note> 
     121        </listitem> 
     122        <listitem><para><command>L'adresse IP principale de ce serveur</command>  
     123        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. 
     124        </para></listitem> 
     125        <listitem><para><command>L'adresse IP interne du serveur</command>  
     126        Il s'agit de l'adresse ip physique du serveur sur son interface réseau publique (généralement eth0). </para> 
     127<note><para> 
     128Ce 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. 
     129</para></note> 
     130        </listitem> 
     131        <listitem><para><command>Le MX à assigner aux nouveaux domaines</command>  
     132        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.         
     133        </para></listitem> 
     134        <listitem><para><command>Nom de la partition d'AlternC</command>  
     135        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. 
     136        </para></listitem> 
     137        <listitem><para><command>Serveur de surveillance</command>  
     138        </para></listitem> 
     139        <listitem><para><command>Serveurs de confiance pour bind</command>  
     140        </para></listitem> 
     141        <listitem><para><command>Réseaux autorisés en SMTP</command>  
     142        </para></listitem> 
     143</itemizedlist> 
     144 
     145<para> 
     146  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>/usr/share/alternc/install/etc/</filename>. 
     147</para> 
     148 
     149<para> 
     150La dernière étape de l'installation consiste à créer un compte AlternC administrateur, dont le login est <command>root</command> et le mot de passe est <command>root</command>. Vous pouvez donc vous connecter à l'adresse http://fqdn/ 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 root et allez dans "configuration" pour modifier votre mot de passe tout de suite (...) 
     151</para> 
     152 
    70153</sect2> 
    71154<sect2><title>Les packages Debian des plugins d'AlternC</title> 
    72155<para> 
    73  
     156  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. 
     157</para> 
     158<para> 
     159Voici la liste officielle des modules disponibles pour AlternC (à date d'écriture de cette documentation) :  
     160<itemizedlist> 
     161  <listitem><para><command>alternc-mailman</command> 
     162  </para></listitem> 
     163  <listitem><para><command>alternc-procmailbuilder</command> 
     164  </para></listitem> 
     165  <listitem><para><command>alternc-awstats</command> 
     166  </para></listitem> 
     167  <listitem><para><command>alternc-webalizer</command> 
     168  </para></listitem> 
     169  <listitem><para><command>alternc-fetchmailbuilder</command> 
     170  </para></listitem> 
     171  <listitem><para><command>alternc-admintools</command> 
     172  </para></listitem> 
     173  <listitem><para><command>alternc-sympa</command> 
     174  </para></listitem> 
     175  <listitem><para><command>alternc-webinstaller</command> 
     176  </para></listitem> 
     177  <listitem><para><command>alternc-phpcron</command> 
     178  </para></listitem> 
     179<!--  
     180 <listitem><para><command></command> 
     181  </para></listitem> 
     182 --> 
     183</itemizedlist> 
    74184</para> 
    75185</sect2> 
  • trunk/plan_formation_debian.txt

    r1130 r1131  
    11 
    22* Formation Administration systeme Debian GNU/Linux, Serveur d'hebergement 
    3 duree, 3 jours. 
     3duree, 3 jours.  
    44 
    55Plan de formation :  
  • trunk/support_formation_debian.txt

    r1130 r1131  
    7272 
    7373 
     74Sous Linux, dans le cadre d'un serveur d'hébergement, nous utilisons principalement la ligne de commande pour piloter les services et administrer le système. Il y a plusieurs manière d'obtenir un accès à la ligne de commande Linux. La première est l'accès via le clavier et l'écran du serveur. Evidemment, ce moyen devient inutile lorsque le serveur se retrouve en salle machine. On utilise alors le service SSH pour se connecter - à distance - au serveur via Internet. SSH est un service qui "écoute" sur le port 22 de l'adresse ip de la machine. Pour se connecter au serveur, il suffit de lancer "ssh username@serveur.org" depuis une mqhine linux, où username est le nom d'utilisateur sous lequel on souhaite se connecter, et serveur.org le nom dns du serveur. Sous Windows, on peut utiliser le logiciel PUTTY, client ssh très connu. 
     75 
     76Une fois connecté au serveur, nous obtenons un prompt. Ce prompt est l'invite de commande du programme de console lancé sur le serveur, nommé "shell". Il existe différents shells, par exemple, bash, ksh, csh, zsh, qui ont des caractéristiques communes importantes (notemment le gros de la syntaxe de gestion des variables) et quelques spécificités facilitant généralement l'utilisation avancée de la console. 
     77 
     78Ainsi, on lit quelque chose du genre "monserveur:/home/benjamin$". On peut maintenant taper des commandes dont voici les premières que nous allons apprendre. Elles ne sont pas forcément très utiles à elles seules, mais elles servent très souvent comme commandes de base pour la gestion de serveur linux.   
     79 
     80"man <programme>" permet d'obtenir l'aide d'un programme unix/linux ! Commande très intéressante s'il en est, elle permet de connaitre la manière d'utiliser un programme et les arguments de celui-ci. Dans man, vous pouvez utiliser les bouton "flèche haut", "flèche bas", "page précédente", "page suivante" pour avancer et reculer dans la documentation, et "q" pour quitter la page de manuel. Vous êtes bien évidemment invité à consulter les pages de manuel est commandes que nous allons voir dans cette formation. 
     81 
     82"cd" permet de changer le dossier courant. le prompt décrit plus haut montre le dossier courant entre le : et le $. Ainsi, "cd public_html" va vous déplacer dans le dossier public_html. pour remonter d'un dossier, on utilise "cd ..". Le dossier ".." étant en fait un dossier symbolisant le parent du dossier courant. 
     83 
     84La commande "ls" permet quand à elle d'obtenir la liste des fichiers présents dans le dossier courant. Cette commande comme beaucoup d'autres, peut recevoir des paramètres derrière l'appel à la commande elle-même. Par exemple, "ls -al" demande l'affichage des fichiers cachés (-a pour All) du dossier courant, ainsi que l'affichage long (-l) c'est à dire avec précision de la taille, des droits et des propriétaires de chaque fichier. la commande "man ls" vous donnnera tous les paramètres que ls connaît. 
     85 
     86 
     87TODO : compléter avec mkdir, rm, less, ps, grep. et une partie sur les 3 flux stdin/stdout/stderr. 
     88 
     89 
    7490    - Debian, l'integration de GNU/Linux, le packaging. (2h) 
    7591        - la FHS (File Hierarchy Standard) details (/etc /var /tmp /home ...) 
    7692        - le packaging debian : apt et dpkg, ainsi que http://packages.debian.org/ 
    7793        - (des)installation, interrogation, maintenance et dependances des packages installes.  
     94 
     95 
     96 
     97 
    7898 
    7999