doc alternc md v0.99

doc/install_fr.md

@@ -1,7 +1,7 @@
 
 
-
-## Pré-installation
+Pré-installation
+================
 
 AlternC est prévu pour fonctionner sur la dernière ou l'avant-dernière version stable de la distribution Linux Debian. Nous utiliserons donc `apt-get` pour installer les logiciels.
 
@@ -9,8 +9,11 @@ Pour installer Alternc vous devez :
 
 * avoir un accès SSH à ce serveur.
 * Avoir les droits d'administrateur (`sudo -s` ou `su`)
+* vérifier que `#includedir /etc/sudoers.d` est bien dans `/etc/sudoers` avec la commande visudo.
 
-### ACL
+
+ACL
+---
 
 AlternC dépend des acls noyau afin de gérer les droits utilisateurs notamment en ce qui concerne les dossiers web. Il est donc nécessaire d'installer le paquet `acl` avec :
 
@@ -29,7 +32,8 @@ Il faut ensuite indiquer au système la partition qui va contenir les données u
 puis en root (remplacer acl par attr2 si c'est en xfs) :
 
 
-### Quota
+Quota
+-----
 
 AlternC peut également gérer les quotas disques des utilisateurs.Contrairement aux ACLs, les quotas ne sont pas nécessaires au fonctionnement d'AlternC. S'ils ne sont pas activé ou installé, AlternC considérera simplement que les quotas sont infinis pour chaque utilisateur. Pour ce faire il faut installer le paquet quota :
 
@@ -44,7 +48,8 @@ nano /etc/fstab
 UUID=71822887-fedb-4d95-a9cc-0841dcc8944f /               ext3    acl,grpquota,errors=remount-ro 0       1
 ```
 
-### Remontage de la partition
+Remontage de la partition
+-------------------------
 
 Une fois ces modification effectués, il suffit de remonter la partition concerné -en supposant toujours que c'est la partion `/` qui contiendra les données utilisateurs avec :
 
@@ -52,7 +57,13 @@ Une fois ces modification effectués, il suffit de remonter la partition concern
 mount -o remount /
 ```
 
-## MySQL
+
+
+Installation
+============
+
+MySQL
+-----
 
 Si vous voulez héberger le serveur mysql sur la même machine, installez d'abord mysql-server :
 
@@ -62,11 +73,12 @@ apt-get install mysql-server
 
 > IMPORTANT : Entrez un mot de passe administrateur et NOTEZ-LE car il vous sera demandé en cours d'installation.
 
-## Installation
+Configuration des dépôts
+------------------------
+
 
 > L'installation d'Alternc est connue et supportée pour le système Debian GNU/Linux, qui utilise le système de gestion de paquets ​apt.
 
-### Configuration des dépôts alternc sur votre serveur (**Debian**)
 
 Pour installer AlternC sur un serveur vous devez utiliser un éditeur de texte pour ajouter la source des packages d'AlternC :
 
@@ -101,18 +113,21 @@ Il ne reste qu'à lancer la commande d'installation d'alternc
 apt-get install alternc alternc-ssl 
 ```
 
-### Écrans d'installation
+écrans d'installation
+---------------------
 
 Une succession d'écrans vous permet de saisir les informations sur la configuration de votre serveur. Si certains choix par défaut sont sans souci, d'autres nécessitent toute votre attention.
 
-### Serveurs de nom
+serveurs de nom
+---------------
 
 Les serveurs de noms servent à distribuer l'information sur les noms de domaine installés sur votre serveur. Si vous avez besoin de serveurs de noms, Alternc vous propose un service gratuit sur alternc.net en dans ce cas vous pouvez saisir :
 
 * DNS primaire : ns1.alternc.net
 * DNS secondaire : ns2.alternc.net
 
-### Nom de domaine du serveur
+nom de domaine du serveur
+-------------------------
 
 Attention, si vous avez un nom de domaine que vous comptez utiliser pour votre compte, ne l'indiquez pas dans cet écran. En effet, ce nom de domaine sera alors la "porte d'accès" à Alternc.
 
@@ -130,24 +145,28 @@ Pas besoin de configurer pour un service, alternc s'occupe de configurer l'URL
 
 Choisir "Site Internet", puis suivre les instructions
 
-## Post Installation
+Post Installation
+=================
 
-Une fois que l'installation est achevée, le script alternc.install doit être exécuté. Il va générer notamment les configurations de votre serveur pour qu'Alternc fonctionne.
+Une fois que l'installation est achevée, le script `alternc.install` doit être exécuté. Il va générer notamment les configurations de votre serveur pour qu'Alternc fonctionne.
 
 ```
 alternc.install
 ```
 
-## Premier login
+Premier login
+-------------
 
 Vous pouvez désormais accéder au panel Alternc sur le nom de domaine ou l'IP que vous avez donné. Vous devriez voir une page de login dont l'accès par défaut -que vous voudrez sans doute changer immédiatement- est :
 
 * user: `admin`
 * pass: `admin`
 
-## Plugins
+Plugins
+=======
 
-### Webmail / Roundcube
+Webmail / Roundcube
+-------------------
 
 Pour installer roundcube pour alternc, il suffit d'installer le paquet `alternc-roundcube` puis de mettre à jour AlternC :
 
@@ -156,7 +175,8 @@ apt-get install alternc-roundcube
 alternc.install
 ```
 
-### Mailman
+Mailman
+-------
 
 Pour installer la liste de diffusion Mailman, il suffit d'installer le paquet `alternc-mailman` puis de mettre à jour AlternC :
 
@@ -164,68 +184,3 @@ Pour installer la liste de diffusion Mailman, il suffit d'installer le paquet `a
 apt-get install alternc-mailman
 alternc.install
 ```
-
-## Mettre à jour sa version d'AlternC
-
-### Branche 3.x
-
-### Branche 1.x vers 3.x 
-
-#### AVANT l'installation:
-
-* Les pré-requis du chapitre précédent: "Installer", doivent être respectés (acl, quotas, ...).
-* vérifier que `#includedir /etc/sudoers.d` est bien dans `/etc/sudoers` avec la commande visudo.
-* vous devez désactiver le plugin procmailbuilder de Squirrelmail si vous avez un squirrelmail déjà installé, et que ce plugin est activé. Pour cela, exécutez `/etc/squirrelmail/conf.pl`, puis vous devez taper le numéro correspondant au menu "Plugins" afin d'obtenir la liste des plugins installés/disponibles. Si le plugin procmailbuilder n'apparaît pas du tout, c'est parce qu'il n'existe plus, donc tout va bien. Sinon, s'il apparaît dans la liste "Installed Plugins", entrez le numéro correspondant et tapez Entrée, celui-ci devrait passer dans la liste "Available Plugins", et celui-ci se retrouve donc désactivé. 
-
-#### PENDANT l'installation:
-
-* L'installateur Debian vous demandera s'il faut écraser les fichiers de conf modifiés depuis l'installation précédente, répondez OUI sinon rien ne fonctionnera... 
-
-#### APRÈS l'installation :
-
-* Vous devrez lancer manuellement le script de migration des fichiers procmail en sieve (filtrage des mails): /usr/lib/alternc/procmail_to_sieve.php
-Parfois, même après suppression du paquet, courier imap ne s'arrête pas... Veillez à ce que le démon ne s'execute pas, le cas contraire tuez-le. 
-* En ce qui concerne le webmail :
-Vous devez installer un `alternc-squirrelmail` ou `alternc-roundcube` si vous voulez gérer un webmail avec AlternC. 
-`alternc-roundcube` a besoin du paquet `roundcube` des backports de Squeeze : 
-
-```
-apt-get install alternc-roundcube
-```
-
-## FAQ
-
-### Drupal : migration d'Alternc 1 à 3
-
-Dossier temporaire :
-
-Dans la base MySQL du compte en question :
-
-```
-select * from variable where value like "%tmp%";
-```
-
-dans un second terminal :
-
-```
-echo -n "/var/alternc/html/x/xxxxxx/tmp" |wc -c 
-```
-
-le résultat donne ici 32
-
-Dans le MySQL :
-
-```
-update variable set value='s:32:"/var/alternc/html/e/epimalin/tmp";' where name='file_temporary_path';
-```
-OU
-
-```
-update variable set value='s:34:"/var/alternc/html/l/lafabrique/tmp";' where name='file_directory_temp';
-```
-
-Puis vider le cache de drupal :
-
-```
-drush cc all
-```