Hébergement d'un nom de domaine

De FphAdmin.

Sommaire

[modifier] Conditions d'hébergement

Le service de liste de diffusion Sympa de la FPH est ouvert à tout partenaire qui en éprouve le besoin. Par rapport à d'autres services de diffusion, Sympa a l'avantage de pouvoir être paramétré très finement, au prix d'une complexité accrue lors des premières utilisations.

Les conditions techniques à remplir par le partenaire sont les suivantes :

  • Maitriser la gestion des DNS de son domaine et créer un enregistrement de type MX sous la forme forums.{nom du domaine} et un enregistrement CNAME sous la forme www.forums.{nom du domaine}, les deux pointant vers mailf.fph.ch
  • Gérer une adresse de type listmaster@{nom du domaine} qui sera l'adresse d'identification du listmaster du domaine sous Sympa.


Note : les forums forums.{nom du domaine} et www.forums.{nom du domaine} sont des conventions et non des obligations, les listes pourraient porter des noms différents. Cependant, ces conventions sont bien pratiques pour faciliter la gestion des domaines et elles pourront ne pas être respectées que pour de très bonnes raisons. De la même manière, l'adresse du listmaster peut être différente mais on veillera à ne pas mettre des noms de personne mais des noms de fonction (au partenaire de faire les alias nécessaires s'il ne veut pas multiplier les boites aux lettre.


[modifier] Ajout d'un nouveau domaine

L'ajout d'un nouveau domaine se fait à plusieurs endroits : dans Sendmail, dans Apache, dans Munin. On prendra comme exemple « forums.basedefiches.net »

[modifier] Ajout d'un nouveau domaine dans Sendmail

1) Rajouter le nom de domaine dans le fichier /etc/mail/virtuserdomains : ce fichier comprend simplement tous les noms de domaines (ou hôtes virtuels) gérés

2) dans le fichier /etc/mail/sympa/virtusertable.d/~tail (fichier placé à la fin lors de la concaténation de /etc/mail/sympa/virtusertable.d), on peut ajouter la ligne suivante :

@forums.basedefiches.net		error:5.5.1:550 Requested action not taken: list unknown

L'entrée dans ce fichier assure que l'envoi de message à une liste inconnue provoquera l'envoi de l'erreur ci-dessus.

3) dans le fichier /etc/mail/sympa/virtusertable.d/_head_forums, placer les lignes suivantes (note : ((@)) est à remplacer par l'arobase)

sympa ((@)) forums.basedefiches.net		sympa-queue-basedefiches
sympa-request ((@)) forums.basedefiches.net	listmaster ((@)) exemole.fr
sympa-owner ((@)) forums.basedefiches.net	listmaster ((@)) exemole.fr
listmaster ((@)) forums.basedefiches.net	listmaster ((@)) exemole.fr
postmaster ((@)) forums.basedefiches.net	listmaster ((@)) exemole.fr
bounce ((@)) forums.basedefiches.net		sympa-bouncequeue-basedefiches
bounce+* ((@)) forums.basedefiches.net	sympa-bouncequeue-basedefiches

Ces lignes indiquent les adresses principales accessibles hors listes. listmaster ((@)) exemole.fr doit être remplacé par l'adresse du listmaster choisi pour le nom de domaine. Dans « sympa-queue-basedefiches » et « sympa-bouncequeue-basedefiches », il faut remplacer « basedefiches » par le nom domaine sans extension ni tiret ni point (exemple: chinaeuropaforum pour china-europa-forum.net). Il s'agit d'une convention qui peut ne pas être respectée si c'est vraiment indispensable.

4) en complément du point précédent, il faut rajouter dans /etc/mail/sympa/aliases.d/_head_2 les lignes suivantes

sympa-queue-basedefiches:	"|/usr/lib/sympa/bin/queue sympa@forums.basedefiches.net"
sympa-bouncequeue-basedefiches:	"|/usr/lib/sympa/bin/bouncequeue sympa@forums.basedefiches.net"

Ce sont ces lignes qui précisent les actions à réaliser pour les alias définis au point 3

5) Réinitialiser Sendmail suivant la procédure collate -> make -> sendmail reload

[modifier] Ajout d'un nouveau domaine dans Apache

Dans le fichier /etc/apache2/sites-available/forums, il suffit de mettre les lignes suivantes :

<VirtualHost 88.191.92.9:80>
ServerName www.forums.basedefiches.net
Include /etc/apache2/include/forums
</VirtualHost>

La relance d'Apache se fait après la configuration de Sympa

[modifier] Ajout d'un nouveau domaine dans Sympa

1) Créer dans /etc/sympa un répertoire avec le nom du domaine

mkdir /etc/sympa/forums.basedefiches.net

2) Copier le fichier robot.conf d'un autre nom de domaine :

cp /etc/sympa/forums.irenees.net/robot.conf /etc/sympa/forums.basedefiches.net

3) Mettre sympa comme propriétaire de l'ensemble

chown -R sympa /etc/sympa/*
chgrp -R sympa /etc/sympa/*

4) Modifier le fichier robot.conf pour indiquer le listmaster et remplacer toutes les références à l'autre nom de domaine par le nouveau, au passage configurer le CSS comme indiqué ici Personnalisation avec CSS

http_host www.forums.irenees.net
wwsympa_url http://www.forums.irenees.net/
host forums.irenees.net
listmaster listmaster ((@)) irenees.net
title Forums Irenees

5) Créer dans le répertoire /home/sympa/expl un répertoire avec le nom de la liste, mettre Sympa comme propriétaire et www-data comme groupe :

mkdir /home/sympa/expl/forums.basedefiches.net
chown sympa /home/sympa/expl/forums.basedefiches.net
chgrp www-data /home/sympa/expl/forums.basedefiches.net

6) Relancer Sympa puis Apache

/etc/init.d/sympa restart
/etc/init.d/apache2 restart


[modifier] Ajout dans Munin

Munin est le logiciel qui génère des statistiques et des graphes sur l'activité des listes (entre autres choses très diverses). Pour avoir des graphes de sa propre liste, il faut créer des liens symboliques portant le nom de la liste. Il y a trois liens symboliques à créer :

ln -s /usr/local/share/munin/sympa_statsfile_subscribers_  /etc/munin/plugins/sympa_statsfile_subscribers_forums.basedefiches.net
ln -s /usr/local/share/munin/sympa_statsfile_msgrecv_  /etc/munin/plugins/sympa_statsfile_msgrecv_forums.basedefiches.net
ln -s /usr/local/share/munin/sympa_statsfile_byterecv_  /etc/munin/plugins/sympa_statsfile_byterecv_forums.basedefiches.net

Il faut ensuite relancer Munin avec le commande :

/etc/init.d/munin-node restart

Munin se mettant à jour toutes les cinq minutes, il est préférable de ne pas relancer lorsque le nombre de minutes est un multiple de cinq.