ENGLISH TRANSLATION: FrequentlyAskedQuestions

Bienvenue dans la foire aux questions d'AlternC. Chaque page est modifiable par n'importe qui, tout simplement en cliquant sur le lien "Modifier le texte" situe en bas de chaque page. Ainsi, cette FAQ pourra etre alimentee automagiquement par les utilisateurs d'AlternC.

Questions generales

Ou est la documentation d'AlternC?

A: nous avons commence a documenter AlternC sur ce wiki, dans la section Documentation, ainsi que dans le manuel en ligne pour  administrateurs et  utilisateurs.

Pourquoi n'y a-t-il pas d'autres questions ici ?

A: ici sont traitees les questions les plus frequentes. Vous pouvez ajouter une question et sa reponse (puisque c'est un wiki), mais priere de respecter le formatage. D'autres questions et discussions se trouvent sur le  forum d'alternc (tres pauvre et quasiment plus actif). Lui preferer les archives de la  liste de discussion des utilisateurs.

Mais ou est passe l'ancien FAQ?

A: l'ancien FAQ n'etait qu'une serie de liens, alors on a fait une section separee (Documentation) qui lie automatiquement vers toutes les docs.

Je voudrais administrer mes membres ? il est ou le paneau d'administration ?

A: les administrateurs des differents membres sont eux-meme des membres parmi d'autres. Ce sont juste des membres qui ont plus de droits que les autres : ils peuvent adminstrer les autres membres. Leur bureau permet donc d'acceder a des fonctions suplementaires.

"admin" est le membre qui est cree initialement a l'installation d'alternc. "admin" n'est pas seulement un administrateur. C'est aussi (et essentiellement) un membre. Un membre qui possede les droits d'administration sur les autres. Les concepts d'alternc sont simples et efficaces : il gere des membres. Point barre.

Je n'arrive pas a acceder a mon bureau.

Quand je tape "alternc.example.org" dans mon navigateur, j'ai un message m'indiquant que la page n'existe pas sur le serveur

A: Alternc utilise le protocole https. Taper  https://alternc.example.org

Problemes d'installation

probleme de dependance (sasl-bin) a l'installation

A: il faut chercher le paquet en question dans  http://apt-get.org et ajouter les lignes dans votre source-list. C'est un peu crade, mais ca peut depanner.

A: Je m'en suis sorti simplement en rajoutant la ligne suivante dans /etc/apt/sources.list :

deb http://ftp2.fr.debian.org/debian/ stable main non-free contrib

Ne pas oublier, pour les etourdis, de faire apt-get update juste apres la modification du fichier /etc/apt/sources.list.

A: Depuis que stable=sarge utilisation de 2 packages Woody:

apt-get install libdb2
wget http://security.debian.org/debian-security/pool/updates/main/c/cyrus-sasl/sasl-bin_1.5.27-3.1woody5_i386.deb
wget http://security.debian.org/debian-security/pool/updates/main/c/cyrus-sasl/libsasl7_1.5.27-3.1woody5_i386.deb
dpkg -i libsasl7_1.5.27-3.1woody5_i386.deb
dpkg -i sasl-bin_1.5.27-3.1woody5_i386.deb

Les paquets CVS ont regle ce probleme, qui sera publie dans le prochain release d'alternc (0.9.4).

A: Dans l'hypothese que sasl-bin n'est pas utilise, on peut creer un paquet vide pour le remplacer:

Installer le paquet 'equivs', puis taper equivs-control sasl-bin-empty. Modifier ensuite le fichier sasl-bin-empty comme suit:

Package: sasl-bin-empty
Maintainer: Sylvain Beucler <Sylvain.Beucler@cliss21.org>
Provides: sasl-bin
Description: Empty/fake package to trick alternc

Puis lancer equivs-build sasl-bin-empty pour recuperer un paquet gigogne.

Note: j'utilise un Provides couple une extension '-empty' (et non directement le nom du paquet) pour pouvoir facilement reperer ce genre de paquet dans le systeme d'ici un ou deux ans (quand AlternC aura corrige ses dependences :p).

Attention aux versions de MySQL, choisissez 4.0,

A : en effet, tous les autres paquets (php...) sont prevus pour la version 4.0 de MySQL et non pas les suivantes.

Cependant, on peut installer la version 0.9.6.3 d'AlternC avec MySQL 5 sur une etch. Pour cela, il faut laisser le compte "root" de MySQL sans mot de passe le temps de l'installation ou d'une mise a jour de fichiers de configuration (mais en mettre un ensuite pour votre securite).

Existe-t-il une explication CLAIRE et PRECISE pour l'installation/configuration ?

(pour quelqu'un qui ne connait quasiment RIEN a Linux et ne ressemble pas a  http://koumbit.net/wiki/Proc%E9dures/InstallationAlternC [bien qu'etant la plus detaillee que j'ai trouvee] il y a des choses qui sont dites comme si on etait senses les savoir)

A: Cette documentation cherche a etre la plus CLAIRE et PRECISE disponible. Un preneur pour l'ameliorer?

A: (28/04/2005) Essayez InstallationAlterncDebianNetInst

A:  Notes personnelles de la Sarge, AlternC (0.9.3) et modules divers.

A:  Notes/tutoriel d'installation d'un serveur GNU/Linux debian avec AlernC et ses dependances. La premiere version est sur une Sarge, mais quelques notes sont ajoutees suite a l' installation sur une etch en VServers, AlternC (0.9.6.3) et modules divers.

Peut on installer Alternc sous windows? Si oui Comment?

A: Nous ne connaissons pour l'instant pas de moyen d'installer AlternC sous Windows.

Comment mettre a jour AlternC ou woody vers sarge?

Alors ici il faut faire attention. Premierement, le code de mise a jour de AlternC est encore en developpement, et il est toujours possible que des bugs y soient presents ou qu'il ne soit pas adapte a toutes les configurations. Ensuite, si vous etes en "pre-1.0", il est recommande de faire une mise-a-jour a 0.9.3 pour commencer, et *ensuite* faire une mise-a-jour vers Sarge. Des simulations ont indique qu'une mise-a-jour de sarge avec une pre-1.0 cause des serieux problemes.

TheAnarcat a ecrit de la documentation sur une mise-a-jour de la pre-1.0 sur woody sur le wiki de Koumbit:  http://koumbit.net/wiki/UpgradeAlternc.

Alors on repete: il faut mettre a jour alternc vers la 0.9.3 *avant* de faire la mise-a-jour vers sarge.

Sur quelles _distribs_ alternc daigne-t-il s'installer ?

A: GNU/Linux SARGE (c'est-a-dire une Debian/Testing?) est la seule distribution recommandee. Il est eventuellement peut-etre possible d'utiliser d'autres distributions modernes utilisant le systeme de paquets Debian (Ubuntu, Knoppix, ...) mais plus rien n'est garanti.

Puis-je utiliser alternc sur ma superbe machine AMD-64 ? Sur un Macintosh ?

A: Non, les seuls paquets disponibles actuellement sont des paquets pour la Debian Sarge (testing) avec une architecture i386. Mise a jour: 0.9.3.1 est aussi disponible pour AMD-64.

J'ai lance un apt-get install alternc* qui donnent 3 km d'erreurs diverses

A: La bonne mainip est de lancer apt-get install alternc qui s'occupe d'installer tout seul les autres paquets dependant. Il est possible *ensuite* d'installer les quelques paquets optionnels, notamment mailman

J'ai lance un apt-get install alternc, mais j'ai repondu un peu n'importe quoi aux questions posees

Faut-il tout reinstaller, pour pouvoir fournir cette fois les bonnes reponses ?

A: Il est possible sans danger de faire apt-get remove alternc suivi de apt-get install alternc Mais la bonne methode est tout simplement de faire dpkg-reconfigure alternc Autre methode : modifier le fichier de configuration cree interactivement par dpkg-reconfigure (/etc/alternc/alternc.conf) et lancer soi-meme alternc.install

Mais que fait donc le magique apt-get install alternc ?

A: Il installe tous les paquets necessaires, puis fait l'equivalent de dpkg-reconfigure alternc

dpkg-reconfigure alternc ne fait rien d'autre que de saisir interactivement le fichier de configuration /etc/alternc/alternc.conf et de lancer alternc.install

Il est donc possible de reconfigurer l'installation autant de fois que necessaire, soit interactivement ( dpkg-reconfigure alternc ), soit a la main ( edition du fichier de configuration et alternc.install )

Catastrophe, apres une tentative d'installation d'alternc, Apache ne veut plus rien savoir

Chaque fois que j'essaye de lancer Apache, j'obtiend l'erreur:

apache: could not open document config file /etc/phpmyadmin/apache.conf

A: La procedure d'installation d'alternc est buggee. Le contournement que j'ai trouve, c'est de faire : ln -s /etc/apache/conf.d/phpmyadmin.conf /etc/phpmyadmin/apache.conf

J'essaye desesperement d'installer alternc, mais apres, je n'accede plus a phpmyadmin

Quand j'appelle la page d'administration phpmyadmin, je n'ai pas l'ecran de saisie de mon mot de passe, mais je rentre directement dans l'ecran de bienvenue. Le probleme c'est que je n'ai alors aucun droit d'acces et je ne peux donc ouvrir aucune base de donnees.

A: Alternc utilise un systeme de biscuits (cookies) pour passer a phpmyadmin le nom de l'utilisateur mysql et son mot de passe.

Le probleme c'est que ca marche tres bien sur un serveur operationnel, en etat de marche, avec mysql parametre correctement. Tant que ce n'est pas le cas, on a plein de problemes. Et pour corriger les problemes de parametrage mysql, rien ne vaut phpmyadmin.

La solution qui semble marcher (pour moi) est tout simplement de detruire. le fichier /etc/phpmyadmin/config.inc.php (ce fichier est de toute facon recree apres chaque alternc.install.

Une fois tous les problemes resolus, il est faut le remettre en place.

Je viens d'installer alternc, mais je ne peux pas rentrer sur le bureau

Je saisi bien "root" comme mot de passe, mais il n'en veut pas.

A: verifier attentivement toutes les informations debitees par alternc.install

Il y a peut etre noye dedans :

Creating user root, with password root (change it as soon as possible)<br>
Fatal error: Call to undefined function:  mysql_pconnect() in /var/alternc/bureau/class/db_mysql.php on line 93

La procedure d'installation alternc.install se termine en disant que tout est cool, et que tout est pret pour le bapteme d'Alternc, mais en fait ce n'est pas vrai.

Solution temporaire:

dpkg-reconfigure php4-mysql

Voir le ticket #592.

J'ai d'autres erreurs noyees dans alternc-install

parsing configuration file /redir.htaccess    [WebMail] Redirection url interne  cannot close F /usr/share/alternc/install/redir.htaccess: Mauvais descripteur de fichier at /usr/sbin/alternc.install line 268.

parsing configuration file /etc/postfix/sasl/smtpd.conf    [Postfix] Fichier de configuration SASL de postfix  cannot close G /tmp/alternc.install.utufeO/etc/postfix/sasl/smtpd.conf: Mauvais descripteur de fichier at /usr/sbin/alternc.install line 269.

A: Je n'ai pas d'idee si c'est grave. Apparament j'arrive a vivre avec ca. Si vous avez des problemes bloquants d'installation il vaut mieux chercher d'autres pistes.

Est-ce possible d'utiliser apache2 ?

A: alternc repose sur apache, et non pas apache2. Il est donc necessaire d'avoir apache operationnel sur le serveur.

De plus, il semble que le port "80" soit d'office sous-entendu par alternc dans la configuration de ses serveurs virtuels (virtual host).

Il est par contre tout a fait possible de faire tourner apache2 sur le serveur, en utilisant un autre port. Il suffit de parametrer le fichier /etc/apache2/ports.conf

Comment faire pour qu'alternc parle une langue que je comprend (le francais) ?

A: Faire:

dpkg-reconfigure locales
localedef -f ISO-8859-1 -i fr_FR fr
/etc/init.d/apache restart
/etc/init.d/apache-ssl restart

...Miracle, alternc parle bien la langue de Moliere

Faire fonctionner l'autentification sasl2 depuis BD Berkeley sur une Debian Sarge

Le paquet AlternC a quelques problemes avec l'authentitfication sasl pour envoyer des emails avec smtp. Il semble bien que plusieurs approches soient envisagees car AlternC fait un appel a saslpasswd en meme temps qu'il rajoute un nouveau email pop dans la bd mysql. Cepandant cet appel ne fonctionne pas car le context au moment de l'execution de saslpasswd fait que celui-ci s'attend a trouver le fichier sasldb2 dans /var/spool/postfix/etc/ et non pas dans /etc. La methode qui semble donc etre utilisee actuellement par AlternC est de cree un fichier /etc/postfix/sasl/smtpd.conf indiquant qu'il faut chercher le mot de passe en clair dans la bd mysql au lieu de faire appel a sasl, ce qui est la config par defaut de Postfix. Comme le fichier /etc/postfix/sasl/smtpd.conf n'est pas automatiquement copie depuis /usr/share/alternc/install/etc/postfix/sasl/smtpd.conf au cours de l'installation et l'authentification smtp ne fonctionne pas.

Ici vous avez 2 solutions, soit vous copiez manuellement le fichier, ce qui a comme avantage d'avoir une source unique pour les parametres utilisateurs des emails mais par contre impose d'avoir les mots de passes en clair dans la bd mysql, ce qui n'est pas genial question securite.

Ou vous suivez la methode ci-dessous permettant d'utilise sasl2 pour l'authentification smtp. Le premier probleme est qu'AlternC utilise sasl version 1 quand les dependances du paquet implique l'utilisation de la version 2.

Par ailleur postfix configure par AlternC s'attend a avoir la bd Berkley sasldb2 dans le dossier /var/spool/postfix/etc/sasldb2 quand elle est placee par Debian dans le dossier /etc. Pour resoudre ces probleme il suffit deplacer la bd dans le dossier /var/spool/postfix/etc/ avec la commande sous root:

 # cp -a /etc/sasldb2 /var/spool/postfix/etc/

Ensuite on cree un lien symbolique pour garde la compatibilite avec Debian:

 # ln -s /var/spool/postfix/etc/sasldb2 /etc/sasldb2

On aurrai pu envisager de faire le lien symbolique dans /var/spool/postfix/etc/ mais postfix n'aime pas trop.

Il faut egalement travailler sur les authorisations du fichier de la bd, pour ceci il semble que la meilleur solution est d'attribuer l'utilisateur postfix au groupe sasl:

 # usermod -G sasl postfix

Maintenant il faut mettre a jour les donnees dans la bd, pour ceci l'on peux soit reentre le mot de passe de chaques comptes pop ou utiliser le petit script bash suivant:

#!/bin/bash
# Author: Martial Guex (m.guex@mutech.ch)
# Begin script parameters:
dbname="alternc"
username="debian-sys-maint"
password="mot de passe pris dans le fichier /etc/mysql/debian.cnf"
# End script parameters
SIFS=$IFS
IFS=$'
'
for l in $(echo "SELECT alias, sasl FROM mail_users" | mysql --batch --skip-column-names --user=$username --password=$password $dbname); do
  IFS=$'	'
  fld=($l)
  email="${fld[0]}"
  pass="${fld[1]}"
  echo "$pass" | saslpasswd -u postfix -c -p "$email"
  IFS=$'
'
done
IFS=$SIFS

Naturelement il est totalement inutile de faire les demarches precedentes si l'on enregistre toujours les mots de passes en clair dans la bd mysql. Il faut donc modifier le fichier m_mail.php se trouvant dans le dossier /var/alternc/bureau/class en appliquant le petit patch disponible a l'adresse  http://www.mutech.ch/m_mail.php.diff. Ensuite il suffit d'enlever le champs sasl dans la bd alternc avec la commande SQL suivante:

ALTER TABLE mail_users DROP COLUMN sasl;

A propos de mysql

Je suis un membre ayant les droits d'administration, mais je n'arrive pas a administrer les bases de mon serveur avec phpmyadmin

A: Il y a deux menus dans le bureau d'un membre administrateur :<br>

• Le menu standard "SQL admin". Ce menu ne marche que si le membre s'est cree au prealable une base quelconque qui lui est propre.
• Le menu "General SQL admin". qui marche aleatoirement car il est bugge. En effet il appelle par phpmyadmin en utilisant le dernier user/password qui traine dans sa memoire. Au depart, c'est juste www-data (qui n'a aucun droit). Apres une connexion/deconnexion sur un autre membre, il peut tres bien appeler phpmyadmin en utilisant le mot de passe du membre qui vient de se deconnecter.

La bonne solution que j'ai trouvee, c'est :

• Creer une base principale avec le bureau du nouveau membre administrateur
• Se deconnecter et se reconnecter avec un membre qui a tous les droits mysql
• Utiliser phpmyadmin pour donner les droits voulus au nouvel utilisateur mysql qui vient d'etre cree par alternc. (Ne pas utiliser le menu "General SQL admin" qui ne parche pas).

Autres questions techniques

Les quotas ne fonctionnent pas, que faire?

A: plusieurs pistes possibles, voir la page  QuotaDebugging de Koumbit.

J'ai perdu le password root d'AlternC! Comment puis-je le recuperer?

A: Utilisez le script PHP suivant:

chdir("/var/alternc/bureau");
require("/var/alternc/bureau/class/config_nochk.php");

// On passe super-admin
$admin->enabled=1;

// On remet le pass root a zero
if (!$admin->update_mem(2000,"root@".$L_FQDN,"Administrateur", "Admin", 'root', 1, 1)) {
        echo "erreur : ".$err->errstr()."<br>
";
        exit();
}

This script is available in /usr/share/alternc/install/reset_root.php on recent AlternC systems (> 0.9.3).

Impossible de creer un domaine/compte ftp/liste d'envoi/etc…

A: c'est probablement les quotas de l'usager qui sont a zero. Les quotas peuvent etre geres par l'administrateur, dans le menu "Gerer les membres". Il est aussi une bonne idee de regler les quotas par defaut dans le "panneau administrateur".

Je n'arrive pas a envoyer de messages avec un client de messagerie avec AlternC v0.9.3

A: Lors de l'envoie vous avez une erreur de type 'Relay Access Denied' avec des erreurs dans les logs de la forme suivante:

warning: SASL authentication problem: unable to open Berkeley db /etc/sasldb2: Permission denied

ou

warning: SASL authentication failure: Password verification failed
warning: unknown[x.x.x.x]: SASL PLAIN authentication failed
warning: SASL authentication problem: unable to open Berkeley db /etc/sasldb2: Permission denied

Voici la demarche qui permet de s'en sortir:

• creer le repertoire /var/spool/postfix/var/run/saslauthd/ en le faisant appartenir au groupe sasl
• ajouter l'user postfix au groupe sasl
• modifier le fichier /etc/default/saslauthd:

  	START=yes
  	MECHANISMS="rimap"
  	PWDIR=/var/spool/postfix/var/run/saslauthd
  	PIDFILE="${PWDIR}/saslauthd.pid"
  	PARAMS="-r -m /var/spool/postfix/var/run/saslauthd -O monMX.fr"
  	#monMX.fr est le nom de votre serveur de messagerie
  

• redemarrer sasl : /etc/init.d/saslauthd restart
• creer le fichier /etc/postfix/sasl/smtpd.conf:

  	pwcheck_method: saslauthd
  	mech_list: plain
  

• redemarrer postfix : /etc/init.d/postfix restart

Maintenant vous pouvez configurer votre client de messagerie avec une authentification SMTP/TLS

Je veux changer l'apparence du bureau, comment faire?

AlternC n'utilise pas de systeme de template, mais separe tout de meme la partie logique de la partie affichage. Tout les internes du code PHP se trouvent dans bureau/class/*. L'affichage du bureau se fait au travers des fichiers bureau/admin/*.

Si vous faites des ameliorations, sentez-vous bien a l'aise de commenter le bug #37, quitte a attacher votre patch directement la.

Quelle est la correspondance entre les usagers AlternC et les usagers UNIX?

A priori, aucune. Par contre, chaque usager alternc est un "group" unix. Ce groupe n'est pas, pour l'instant, entre dans /etc/group, alors les fichiers apparaissent comme ayant des groupes "numeriques"...

Est ce qu'AlternC est un OS

Non. Ce n'est pas parce que les developpeurs ont decide de remplacer le nom Debian par AlternC dans tout les fichiers de la machine que vous utilisez un OS AlternC. AlternC est un logiciel qui abuse du systeme, avec une instalation extremenent intrusive. La plupart des fichiers de config sous /etc sont ecrases au profits de fichiers corrompus. Des executables sont copies la ou des fichiers de config/donnees sont censes se trouver et inversement. Une fois installe, supprimer le package devient une chose tres penible et laborieuse. Une machine infectee par AlternC en gardera toujours une petite trace quelque part.

Comment migrer un domaine existant sur un autre compte

• Recuperer l'uid du compte sur lequel est installe le domaine et celui du compte sur lequel il doit etre migre.

• Faire les modifications suivantes en remplacant a chaque fois la valeur uid de l'ancien compte par celle du nouveau.

Dans la table domaine la valeur du champ 'compte' du domaine

Dans la table mail_domain la valeur du champ 'uid' du domaine

Dans la table mail_users la valeur du champ 'uid' des mails du domaine

Dans la table mailman la valeur du champ 'uid' des listes du domaine

• Modifier la table quota des deux comptes pour prendre en compte le transfert (domaine -1/+1, mails -6/+6, ...)

En prenant en compte le domaine et ses sous-domaines (domaine.tld, www.domaine.tld, ...)

• Supprimmer les liens symboliques du domaines dans /var/alternc/dns/x/

• Creer les nouveaux liens symboliques

• Modifier les entrees correspondantes au domaine dans /var/alternc/apacheconf/x/domaine

• Recharger apache

TODO: base de donnees

Comment modifier son FQDN ?

Comment mettre des quotas par boite sur AlternC

Cette doc explique comment installer des quotas par boite en utilisant le patch VDA de postfix.

Comment sauvegarder les donnees sur un serveur distant ?

Actuellement Alternc ne propose pas de sauvegardes automatisees. Toutefois vous pouvez utiliser des outils complementaires. Nous vous suggerons parmi tant d'autres :

 rsync, systeme recommande si vous avez la main sur le serveur de sauvegarde

 rdiff

 backup-manager, une solution si vous n'avez qu'un acces ftp

Pour alternc, les dossiers a sauvegarder sont :

Un backup complet de /etc/ peux s'averer utile pour garder l'ensemble des fichiers de conf !!

• /var/alternc/
• /etc/alternc/
• /var/lib/mysql
• /var/lib/squirrelmail/data

Pour alternc-mailman, il faut rajouter

• /etc/mailman/
• /var/lib/mailman

Plus de mails qui arrivent, plus acces en IMAP, Squirrelmail qui refuse de s'ouvrir, ... ?

Avant de partir a la recherche d'un probleme complexe, verifier le quota web du compte. Si le "quota_web" est arrive a sa limite, plus aucun message ne sera accepte et dans certains cas l'acces au compte imap sera impossible.

Solution: Augmenter le quota du compte ou faire de la place ...