====== Setup di Mailman ======

Questo HowTo descrive come installare e configurare **Mailman** per la gestione delle mailing list.

===== Installazione di Mailman =====

Per iniziare bisogna installare i pacchetti necessari:

  apt-get update && apt-get install mailman

===== Creare la lista predefinita di mailman =====

Mailman richiede la presenza di una mailing lista predefinita chiamata **mailman**:

  # newlist mailman
    Inserisci l'email della persona che l'amministra:
    Password iniziale per mailman:

L'indizirro email è il vostro.

===== Integrare Mailman con Postfix =====

In /etc/postfix/main.cf apportare le seguenti modifiche

  #
  # mailman aliases
  #
  
  alias_maps              = hash:/etc/aliases,
        hash:/var/lib/mailman/data/aliases		« aggiungere questa riga
  
  owner_request_special   = no       « aggiungere questa riga
  mailman_destination_recipient_limit     = 1		« aggiungere questa riga
  
  ...
  
  virtual_alias_maps      = hash:/etc/postfix/ispcp/aliases,
        hash:/var/lib/mailman/data/virtual-mailman	« aggiungere questa riga

Ricaricare il demone Postfix:

  /etc/init.d/postfix reload

===== Configurazione dell'interfaccia web =====

Mailman è controllato da un'interfaccia web gestita dal server apache e bisogna quindi aggiungervi un nuovo vhost.
Creare il file **/etc/apache2/sites-available/mailman.conf** e inserire le seguenti righe:

  #
  # mailman Virtual Host Webinterface
  #
  
  <VirtualHost xxx.xxx.xxx.xxx:80>                                 « inserire qui l'indirizzo IP
          ServerAdmin     admin@tuodominio.it                      « inserire qui il vostro indirizzo email
          DocumentRoot    /var/www/mailman
  
          ServerName      liste.tuodominio.it                      « inserire qui il dominio
  
          ErrorLog        /var/log/apache2/liste.tuodominio.it-error.log  « inserire qui il dominio
          CustomLog       /var/log/apache2/liste.tuodominio.it-access.log combined  « inserire qui il dominio
  
          Alias /pipermail /var/lib/mailman/archives/public/
          Alias /images/mailman /usr/share/images/mailman/
  
          <Directory /var/lib/mailman/archives/>
                  Options Indexes FollowSymLinks
                  AllowOverride None
          </Directory>
  
          ScriptAlias /admin /usr/lib/cgi-bin/mailman/admin
          ScriptAlias /admindb /usr/lib/cgi-bin/mailman/admindb
          ScriptAlias /confirm /usr/lib/cgi-bin/mailman/confirm
  
          # Il file create.html è un file fittizio per evitare che qualcuno possa creare una nuova lista dall'interfaccia web
          # ScriptAlias /create /usr/lib/cgi-bin/mailman/create
          Alias /create /var/www/mailman/create.html
  
          ScriptAlias /edithtml /usr/lib/cgi-bin/mailman/edithtml
          ScriptAlias /listinfo /usr/lib/cgi-bin/mailman/listinfo
          ScriptAlias /options /usr/lib/cgi-bin/mailman/options
          ScriptAlias /private /usr/lib/cgi-bin/mailman/private
          ScriptAlias /rmlist /usr/lib/cgi-bin/mailman/rmlist
          ScriptAlias /roster /usr/lib/cgi-bin/mailman/roster
          ScriptAlias /subscribe /usr/lib/cgi-bin/mailman/subscribe
          ScriptAlias /mailman/ /usr/lib/cgi-bin/mailman/
  
  </VirtualHost>

Attivate ora il nuovo vhost:

  a2ensite mailman.conf

Per abilitare l'esecuzione di mailman in un sottodominio del tipo //liste.tuodominio.it// bisogna modificare il file **/etc/apache2/sites-available/ispcp.conf** nella sezione vhost //tuodominio.it// e cancellare //*.tuodominio.it// dalla seguente riga:

  ServerAlias     www.tuodominio.it tuodominio.it *.tuodominio.it

Dopo tutto ciò, bisogna ricaricare la configurazione di apache:

  /etc/init.d/apache2 reload

===== Modificare la configurazione di Mailman =====

In /etc/mailman/mm_cfg.py bisogna definire i seguenti valori:

  DEFAULT_URL_PATTERN = 'http://%s/'
  DEFAULT_EMAIL_HOST = 'liste.tuodominio.it'  « inserire qui il proprio dominio
  DEFAULT_URL_HOST   = 'liste.tuodominio.it'  « come sopra

Alla fine di /etc/mailman/mm_cfg.py aggiungere:

  # Virtual Postfix Domains, mailman should update
  POSTFIX_STYLE_VIRTUAL_DOMAINS = ['tuodominio.it','unaltrodominio.org','acaso.net']

In questa variabile bisogna indicare **tutti** i domini per i quali si vogliono usare le mailing list.

===== Cosa manca =====

Bisogna definire l'indirizzo web per ciascuna lista creata.

L'indirizzo web è registrato nella variabile **web_page_url** per ciascuna lista. Questa variabile è esportato col comando config_list. Per farlo eseguire:

  echo "web_page_url = 'http://liste.tuodominio.it/'" > /root/web_page_url.cfg      « inserire qui il vostro dominio
  
  # Eseguire questa istruzione per ciascuna lista sul server
  config_list -i /root/web_page_url.cfg NOME_LISTA

===== Creare una mailing list =====

Ora si può creare una nuova lista come segue:

  # newlist
    Inserisci il nome della lista: prova@tuodominio.it
    Inserisci l'email della persona che l'amministra: io@tuodominio.it
    Password iniziale per prova@tuodominio.it: prova
  
  # config_list -i /root/web_page_url.cfg prova

**Attenzione:** Mailman identifica le mailing list solo con la parte iniziale dell'indirizzo email, ovvero quella che precede la "@". Così se si creano due liste prova@miodominio.it e prova@tuodominio.it, Mailman accetterà solo la prima. Vedrete che mailman gestisce queste liste senza il dominio.

===== Amministrazione =====

Potete amministrare le vostre liste dall'indirizzo: http://liste.tuodominio.it/mailman/admin/prova/

===== Maggiori informazioni =====

Per maggiori informazioni, consultare i seguenti siti:

  * [[http://www.gnu.org/software/mailman/docs.html|Mailman Documentation]]
  * [[http://www.gnu.org/software/mailman/mailman-install/index.html|Mailman Installation Manual]]