Show
Ignore:
Timestamp:
04/28/06 19:43:54 (2 years ago)
Author:
benjamin
Message:

documentation, mise a jour pour 0.9.5

Files:

Legend:

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

    r1142 r1550  
    2727        <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> 
    2828         
    29         <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.</para></listitem> 
     29        <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> 
    3030         
    3131        <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> 
    3232         
    33         <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> 
     33        <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> 
    3434 
    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> 
     
    6767</para> 
    6868<para> 
    69 Enfin, pour installer AlternC, tapez <command>aptitude install alternc postfix</command>. Le système de package debian installe alors AlternC et les packages en dépendance. (à ce jour, il est parfois 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.) 
     69Enfin, pour installer AlternC, tapez <command>aptitude install alternc</command>. Le système de package debian installe alors AlternC et les packages en dépendance. 
    7070</para> 
    7171  <note><para> 
     
    7373  </para></note> 
    7474<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.  
     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 configurera pour vous ces logiciels.  
    7676</para> 
    7777<para> 
     
    144144 
    145145<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>. 
     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>/etc/alternc/templates/</filename>. 
    147147</para> 
    148148 
    149149<para> 
    150 La 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 <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 root et allez dans "configuration" pour modifier votre mot de passe tout de suite (...) 
     150La 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 (...) 
    151151</para> 
    152152 
     
    159159Voici la liste des modules disponibles pour AlternC (à date d'écriture de cette documentation) :  
    160160<itemizedlist> 
    161   <listitem><para><command>alternc-mailman</command> 
     161  <listitem><para><command>alternc-mailman</command>  
    162162  </para></listitem> 
    163163  <listitem><para><command>alternc-procmailbuilder</command> 
  • alternc-doc/trunk/admin/internals.xml

    r1142 r1550  
    2929Courier Suite  Serveur pop, pops, imap, imaps 
    3030Spamassassin   Logiciel d'antispam 
     31Postgrey       Filtrage antispam 
    3132Clamav         Antivirus 
    3233</screen> 
    3334 
    3435<para> 
    35 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. 
     36Chaque 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>/etc/alternc/templates/</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/local.sh</filename>, qui a été prérempli avec les informations que vous avez saisi dans les masques de configuration lors de l'installation d'AlternC. 
    3637</para> 
    3738 
    3839<example><title>Exemple de Fichier de configuration AlternC</title> 
    3940<para> 
    40 Le fichier de configuration d'apache est dans /etc/apache/httpd.conf. on y retrouve entre autre : 
     41Le fichier de configuration d'apache est dans /etc/apache/httpd.conf. Voici un exemple (ce n'est qu'un exemple, le fichier issu de /etc/alternc/templates est probablement différent. On y retrouve entre autre : 
    4142</para> 
    4243 
  • alternc-doc/trunk/admin/intro.xml

    r1119 r1550  
    2323<para> 
    2424De nombreuses personnes ont participé à la conception et au perfectionnement  
    25 d'AlternC. Parmi eux, on retrouve des administrateurs systèmes de L'Autre Net,  
    26 Globenet, Eitic, Koumbit, Metaconsult, Neuronnexion, DomainePublic, ainsi que des  
     25d'<ulink url="http://www.alternc.org/">AlternC</ulink>. Parmi eux, on retrouve des administrateurs systèmes de <ulink url="http://www.lautre.net">L'Autre Net<ulink>,  
     26<ulink url="http://www.globenet.org">Globenet<ulink>, <ulink url="http://www.eitic.fr">Eitic<ulink>, <ulink url="http://www.koumbit.net">Koumbit<ulink>, <ulink url="http://www.metaconsult.fr">Metaconsult<ulink>, <ulink url="http://www.nnx.com">Neuronnexion<ulink>, <ulink url="http://www.domainepublic.net">DomainePublic<ulink>, ainsi que des  
    2727étudiants ayant aidé au projet, parfois dans le cadre d'un stage, sans compter les  
    2828très nombreuses contributions diverses sur les listes de discussion du projet. 
  • alternc-doc/trunk/admin/plugins.xml

    r1134 r1550  
    1111</para> 
    1212<para> 
    13   Ces plugins modifient généralement le menu principal des hébergés, <filename>menu.php</filename>. Si l'élément de menu ainsi inséré ne vous convient pas, vous pouvez modifier le fichier <filename>/var/alternc/bureau/admin/menulist.txt</filename> qui contient la liste des éléments de menu à charger pour les mettre dans l'ordre qu'il vous plait. 
     13  Ces plugins modifient généralement le menu principal des hébergés, <filename>menu.php</filename>. Si l'élément de menu ainsi inséré ne vous convient pas, vous pouvez modifier le fichier <filename>/etc/alternc/menulist.txt</filename> qui contient la liste des éléments de menu à charger pour les mettre dans l'ordre qu'il vous plait. 
    1414</para> 
    1515 
  • alternc-doc/trunk/admin/svn.xml

    r1146 r1550  
    2727svn+ssh://svn.debian.org/var/lib/svn/debian-edu/trunk 
    2828http://corp.mycompany.com:8080/svn/internal/ 
     29https://dev.alternc.org/svn/alternc/alternc/trunk 
    2930</screen> 
    3031Ce ne sont, bien sur, que des exemples. Subversion supportant de nombreux protocoles de transfert d'information, il est possible que d'autres forme d'url existent.