Documentation technique : Debian
Documentation basée sur la distribution Debian

> > > > Installation et configuration

Installation et configuration

Sympa nécessite au préalable un serveur de base de donnée correctement installé (Mysql par exemple, mais aussi Postgresql, Oracle ou SQlite), un serveur de mails (Postfix par exemple) et un serveur Web (Apache).

Installation

Dans un premier temps, il est important de créer un utilisateur Unix spécifique que l’on nommera "sympa" :

  1. sudo adduser sympa

Nous devons voir apparaitre à l’écran :

  1. Ajout de l\'utilisateur « sympa »...
  2. Ajout du nouveau groupe « sympa » (1003)...
  3. Ajout du nouvel utilisateur « sympa » (1003) avec le groupe « sympa »...
  4. Création du répertoire personnel « /home/sympa »...
  5. Copie des fichiers depuis « /etc/skel »...

Télécharger

Nous devons répondre au moins aux questions posées suivantes (les autres restant facultatives) :

  • Entrez le nouveau mot de passe UNIX
  • Retapez le nouveau mot de passe UNIX

Ensuite nous allons installer, ou du moins tester s’ils le sont déjà, une bonne partie des dépendances de sympa. Du fait qu’il soit écrit en perl, le serveur a de très nombreuses dépendances car les librairies de ce language sont fragmentées dans de multiples paquest. On lance alors cette commande :

  1. sudo apt-get install build-essential openssl gettext mhonarc libmysqlclient15-dev libxml2 libxml2-dev perl perl-modules libmailtools-perl libclass-dbi-perl libmime-base32-perl libmime-perl libmime-charset-perl libwww-perl libhtml-parser-perl libhtml-tagset-perl libcrypt-ciphersaber-perl libfcgi-perl libdigest-perl libdigest-md5-file-perl libconvert-asn1-perl libnet-ldap-perl libnet-ldap-server-perl libdb-file-lock-perl libio-stringy-perl libnet-ssleay-perl libio-socket-ssl-perl libclass-dbi-pg-perl libclass-dbi-mysql-perl libclass-dbi-sqlite-perl libclass-dbi-loader-perl libunicode-map8-perl libunicode-string-perl libxml-libxml-perl libio-all-perl libhtml-format-perl libhtml-parser-perl libhtml-tree-perl libdbd-pg-perl libdbd-mysql-perl libdbi-perl libterm-progressbar-perl libxml-perl libxml-libxml-perl libhtml-stripscripts-parser-perl libmime-lite-perl libintl-perl libfile-copy-recursive-perl libarchive-zip-perl libmime-encwords-perl libnet-netmask-perl libtemplate-perl libunicode-linebreak-perl libmail-dkim-perl libsoap-lite-perl libmime-lite-html-perl

Ceci fait, nous pouvons ensuite passer à l’étape de récupération du logiciel :

  1. # On va dans notre home
  2. cd ~
  3. # On récupère de la dernière archive stable (vérifiez que le lien est correct sur le site http://www.sympa.org
  4. wget http://www.sympa.org/distribution/sympa-6.1.17.tar.gz
  5. # On décompresse l'archive
  6. tar -xvzf sympa-6.1.17.tar.gz
  7. # On change de répertoire
  8. cd sympa-6.1.17/

Télécharger

Nous pouvons ensuite passer à l’étape de compilation du serveur :

  1. # La phase de configuration en précisant trois options spécifiques à Debian :
  2. # --with-initdir qui correspond à l'emplacement des fichier d'init du système
  3. # --with-lockdir qui correspond à l'emplacement des futurs fichiers lock
  4. # --with-newaliases_arg donne les arguments passés à la commande newaliases.
  5. # Comme le serveur peut servir à autre chose que pour sympa, on lui passe le fichier de base de donnée de mails à mettre à jour
  6. ./configure --with-initdir=/etc/init.d/ --with-lockdir=/var/lock --with-newaliases_arg="-oA/etc/mail/sympa_aliases"
  7. # Puis on peut compiler
  8. make
  9. # Et enfin installer le tout
  10. sudo make install

Télécharger

On va créer le fichier /etc/mail/sympa_aliases où seront injectés les alias pour les listes :

  1. mkdir -p /etc/mail
  2. nano /etc/mail/sympa_aliases

Télécharger

On y ajoute les lignes suivantes :

  1. sympa: "| /home/sympa/bin/queue sympa@lists.domaine.example"
  2. listmaster: "| /home/sympa/bin/queue listmaster@lists.domaine.example"
  3. bounce+*: "| /home/sympa/bin/bouncequeue sympa@lists.domaine.example"
  4. abuse-feedback-report: "| /home/sympa/bin/bouncequeue sympa@lists.domaine.example"
  5. sympa-request: listmaster@lists.domaine.example
  6. sympa-owner: listmaster@lists.domaine.example

Télécharger

On donne les bons droits d’accès et on crée la base de donnée de mails :

  1. newaliases -oA/etc/mail/sympa_aliases
  2. chown -Rvf sympa:sympa /etc/mail/

Télécharger

Avant toute autre chose nous devons vérifier que l’ensemble des librairies perl nécessaires sont correctement installées. Sympa fourni un script pour cela qui vérifie et si besoin installe ou mets à jour les librairies nécessaires. Il suffit de lancer la commande :

  1. sudo /home/sympa/bin/sympa_wizard.pl --check

Si les librairies ne sont pas présentes, Sympa utilisera CPAN pour les installer, dans notre cas deux librairies n’étaient pas disponibles ou à jour dans les dépots Débian :

  • Mhonarc ;
  • Unicode-LineBreak ;

Nous n’installons que les librairies nécessaires (celles par défaut).

Si cette étape s’est correctement passée, nous pouvons passer à la configuration.

Configuration

Il suffit cette fois-ci de lancer la même commande sans le paramètre --check (Les valeurs par défaut sont celles inscrites entre crochets) :

  1. sudo /home/sympa/bin/sympa_wizard.pl

A ce moment là, beaucoup de questions vous seront posées.

  1. home: Directory containing mailing lists subdirectories [/home/sympa/list_data]
  2. # Laissez la valeur par défaut, on a créé un utilisateur sympa pour cela.
  3. arc_path: Where to store HTML archives [/home/sympa/arc]
  4. # Idem, on laisse la valeur par défaut.
  5. http_host: URL to a virtual host. [http://domain.example]
  6. # Mettez ici l'url par laquelle vous souhaitez accéder au serveur de mailing lists, dans notre exemple, on utilisera "http://lists.domaine.example"
  7. static_content_path: The directory where Sympa stores static contents (CSS, members pictures, documentation) directly delivered by Apache [/home/sympa/static_content]
  8. # Laissez la valeur par défaut.
  9. static_content_url: The URL mapped with the static_content_path directory defined above [/static-sympa]
  10. # Laissez la valeur par défaut.
  11. syslog: The syslog facility for sympa [LOCAL1]
  12. # Laissez la valeur par défaut.
  13. log_facility: The syslog facility for wwsympa, archived and bounced [LOCAL1]
  14. # Laissez la valeur par défaut.
  15. domain: Main robot hostname [domain.example]
  16. # Le nom d'hote du robot principal, on mettra dans notre exemple "lists.domaine.example"
  17.  
  18. Sympa will associate listmaster privileges to these email addresses (mail and web interfaces). Some error reports may also be sent to these addresses.
  19. listmaster: Listmasters email list comma separated [your_email_address@domain.example]
  20. # Mettre ici l'adresse email du Listmasters à savoir l'utilisateur qui gère le serveur, dans notre exemple on mettra "postmaster@domaine.example". Mettez une adresse qui existe réellement.
  21. email: Local part of sympa email adresse [sympa]
  22. # Laissez la valeur par défaut.
  23. create_list: Who is able to create lists [public_listmaster]
  24. # Laissez la valeur par défaut.
  25.  
  26. cache_list_config: Use of binary version of the list config structure on disk: none | binary_file [none]
  27. # Laissez la valeur par défaut.
  28. max_size: The default maximum size (in bytes) for messages (can be re-defined for each list) [5242880]
  29. # Laissez la valeur par défaut, à moins que vous souhaitiez autoriser des messages de plus de 5242880 bytes.
  30. use_blacklist: comma separated list of operations for which blacklist filter is applied [send,create_list]
  31. # Laissez la valeur par défaut.
  32.  
  33. lang: Default lang (ca | cs | de | el | es | et_EE | en_US | fr | fi | hu | it | ja_JP | ko | nl | nb_NO | oc | pl | pt_BR | ru | sv | tr | vi | zh_CN | zh_TW) [en_US] :
  34. # Choisissez dans la liste la langue par défaut du serveur. Dans notre exemple, on mettra "fr"
  35. supported_lang: Supported languages [ca,cs,de,el,es,et_EE,en_US,fr,fi,hu,it,ja_JP,ko,nl,nb_NO,oc,pl,pt_BR,ru,sv,tr,vi,zh_CN,zh_TW]
  36. # La liste des langues supportées, on va laisser toutes les langues, donc la valeur par défaut.
  37. bounce_warn_rate: Bouncing email rate for warn list owner [30]
  38. # Laissez la valeur par défaut.
  39.  
  40. sendmail: Path to the MTA (sendmail, postfix, exim or qmail) [/usr/sbin/sendmail]
  41. # Laissez la valeur par défaut.
  42. antivirus_path: Path to the antivirus scanner engine [] :
  43. # Laissez la valeur par défaut.
  44. antivirus_args: Antivirus pluggin command argument []
  45. # Laissez la valeur par défaut.
  46. mhonarc: Path to MhOnarc mail2html pluggin [/usr/bin/mhonarc]
  47. # Laissez la valeur par défaut.
  48. openssl: Path to OpenSSL []
  49. # Laissez la valeur par défaut.
  50. capath: The directory path use by OpenSSL for trusted CA certificates []
  51. # Laissez la valeur par défaut.
  52. cafile:  This parameter sets the all-in-one file where you can assemble the Certificates of Certification Authorities (CA) [/home/sympa/default/ca-bundle.crt]
  53. # Laissez la valeur par défaut.
  54. key_passwd: Password used to crypt lists private keys []
  55. # Laissez la valeur par défaut.
  56.  
  57. db_type: Database type (mysql | Pg | Oracle | Sybase | SQLite) [mysql] :
  58. # Si vous souhaitez utiliser mysql (notre cas), laissez la valeur par défaut, sinon choisissez votre type de base de donnée.
  59. db_name: Name of the database [sympa]
  60. # Nom de la base de donnée, laissez la valeur par défaut ou indiquez une base existante par exemple.
  61. db_host: The host hosting your sympa database [localhost]
  62. # Si le serveur de base de donnée est sur la même machine que le serveur de Mailing lists, laissez la valeur par défaut.
  63. db_user: Database user for connexion [user_name]
  64. # Nom d'utilisateur (Mysql ou autre) qui aura accès à la base de donnée. Dans notre exemple on utilisera "sympa".
  65. db_passwd: Database password (associated to the db_user) [user_password]
  66. # Le mot de passe de cet utilisateur de la base de donnée. Dans notre exemple, on utilisera "sympa_pass"
  67.  
  68. use_fast_cgi: Is fast_cgi module for Apache (or Roxen) installed (0 | 1) [1]
  69. # Laissez la valeur par défaut.
  70. wwsympa_url: Sympa's main page URL [http://host.domain.example/sympa]
  71. # L'adresse à laquelle on accède au serveur. Dans notre exemple on utilisera "http://lists.domaine.example"
  72. title: Title of main web page [Mailing lists service]
  73. # Titre qui sera affiché sur le serveur. Laissez la valeur par défaut.
  74. default_home: Main page type (lists | home) [home]
  75. # Laissez la valeur par défaut.
  76. default_shared_quota: Default disk quota for shared repository []
  77. # Laissez la valeur par défaut.
  78.  
  79. spam status : ham, spam or unsure. This parameter replace antispam_tag_header_name, antispam_tag_header_spam_regexp and antispam_tag_header_ham_regexp. [x-spam-status]
  80. # Laissez la valeur par défaut.
  81. antispam_tag_header_name: If a spam filter (like spamassassin or j-chkmail) add a smtp headers to tag spams, name of this header (example X-Spam-Status) [X-Spam-Status]
  82. # Laissez la valeur par défaut.
  83. antispam_tag_header_spam_regexp: The regexp applied on this header to verify message is a spam (example \s*Yes) [^\s*Yes]
  84. # Laissez la valeur par défaut.
  85. antispam_tag_header_ham_regexp: The regexp applied on this header to verify message is NOT a spam (example \s*No) [^\s*No]
  86. # Laissez la valeur par défaut.

Télécharger

Les deux fichiers de configuration /etc/sympa.conf et /etc/wwsympa.conf sont alors mis à jour. Vous pourrez ensuite les éditer manuellement.

Création de la base de donnée

Il est maintenant nécessaire de créer la base de donnée. On va utiliser les mêmes informations que fournies lors de la configuration précedente soit :

  • On utilise un serveur MySQL ;
  • La base de donnée s’appelle sympa ;
  • Le nom d’utilisateur de la base de donnée est sympa ;
  • Le mot de passe de cet utilisateur est sympa_pass ;

On va se logguer sur le serveur MySQL en root :

  1. mysql -u root -p

Le mot de passe doit vous avoir été demandé et vous accédez à l’interface MySQL en ligne de commande.

On va ensuite créer la base de donnée et donner les droits au nouvel utilisateur sympa qui sera créé automatiquement :

  1. CREATE DATABASE sympa;
  2. GRANT ALL PRIVILEGES ON sympa.* TO 'sympa'@'localhost' IDENTIFIED BY 'sympa_pass' WITH GRANT OPTION;
  3. # Pour sortir, tappez "quit" ou "ctrl+c"

Télécharger

Modification du script d’init de sympa

Sympa installe son script d’initialisation tout seul dans le répertoire adéquat /etc/init.d/ mais pour que ce script fonctionne correctement pour Debian sans possible problème d’intéraction malheureuse avec d’autres, il est nécessaire de lui ajouter quelques ligne en entête du fichier. On l’ouvre donc :

  1. nano /etc/init.d/sympa

et on ajoute les lignes suivantes en haut du fichier après la ligne #!/bin/sh :

  1. ### BEGIN INIT INFO
  2. # Provides:             sympa
  3. # Required-Start:       $syslog $remote_fs $network
  4. # Required-Stop:        $syslog $remote_fs
  5. # Default-Start:        2 3 4 5
  6. # Default-Stop:         0 1 6
  7. # Short-Description:    Sympa Mailing lists management
  8. # Description:          Sympa is a powerfull mailing lists management system
  9. ### END INIT INFO

Télécharger

Puis on réinitialise ce script correctement :

  1. sudo update-rc.d sympa defaults

Lancement du serveur de mailing list

Finalement nous pouvons lancer le serveur sympa comme ceci :

  1. sudo /etc/init.d/sympa start

Le script sympa.pl alors lancé créera les tables nécessaires à la base de donnée.

Et nous devrions voir les lignes suivantes :

  1. Starting Sympa subsystem:
  2. Starting module sympa.pl: success
  3. Starting module bulk.pl: success
  4. Starting module archived.pl: success
  5. Starting module bounced.pl: success
  6. Starting module task_manager.pl: success

Télécharger

On peut désormais passer à la configuration d’Apache pour Sympa

  • Auteur :
  • Publié le :
  • Mis à jour : 12/09/17

Aucun commentaire

Commentez la documentation

Qui êtes-vous ?
[Se connecter]
Ajoutez votre commentaire ici

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.