Introduzione

In questa guida sono presenti delle istruzioni utili all'installazione di HylaFAX, un programma per l'invio e la ricezione mezzo fax di documenti digitali, su un server Ubuntu integrando il servizio col server di posta Postfix per inviare e ricevere i fax attraverso la posta elettronica.

Installazione

Installare i pacchetti hylafax-server e hylafax-client, reperibili dal componente universe dei repository ufficiali.

Configurazione

1. Prima di iniziare la configurazione controllare il corretto collegamento del modem/fax. Digitare in una finestra di terminale del server il seguente comando:

   echo "ATDT123456789" > /dev/ttyS0

   Se il modem è collegato correttamente, le spie del modem si accendono.

2. Configurare il modem/fax, digitando in una finestra di terminale del server il seguente comando:

   faxsetup

3. Modificare i campi come nell'esempio:

   Country Code: 39                           # Prefisso della nazione di appartenenza, in questo caso Italia
   Area Code: 02                              # Prefisso distretto telefonico, in questo caso Milano
   FAX Number: +39,02,1234567890              # Numero di telefono del fax, comparirà nei fax trasmessi e in ricezione
   Long DistanceDialingPrefix: 0                       
   International DialingPrefix: 00
   Local Identifier: "Nome del server fax"    # Stringa identificativa alfanumerica, comparirà nei fax trasmessi e in ricezione
   RingsBeforeAnswer: 1                       # Numero di squilli prima della risposta

Per riconfigurare il modem, o aggiungerne un altro, è possibile digitare in una finestra di terminale il seguente comando:

faxaddmodem

Dialtone

Molto spesso i modem/fax sono configurati per il mercato americano. In questi casi il dispositivo, prima di effettuare la chiamata, attende il tono di linea continuo tipico della telefonia statunitense. Non trovandolo non viene effettuata la chiamata.

Per risolvere questo problema, procedere come segue:

1. Aprire con un editor di testo con i privilegi di amministrazione il file /etc/hylafax/config.ttyS0 cercare la seguente riga:

   ModemDialCmd:           ATDT%s

   Modificarla come nel seguente esempio:

   ModemDialCmd:           ATX3DT%s

Permessi

Per permettere l'uso di Hylafax, aggiungere gli utenti digitando in una finestra di terminale il seguente comando:

faxadduser -p password nome_utente

Dove nome_utente va sostituito con il proprio nome utente e password con la propria password.

Comandi di controllo

• Per controllare lo stato del server fax, in una finestra di terminale digitare il seguente comando:

  faxstat -s 

• Per riavviare il servizio, in una finestra di terminale digitare il seguente comando:

  /etc/init.d/hylafax restart

Crontab

Aprire con un editor di testo con i privilegi di amministrazione il file /etc/crontab e inserire il seguente testo:

0 * * * * /usr/sbin/faxqclean
0 0 * * * /usr/sbin/faxcron | mail -s "Report di HylaFAX" faxmaster

Tramite il servizio di schedulazione Cron, il comando faxqclean elimina i fax spediti. Il comando faxcron crea un rapporto statistico che viene inoltrato all' utente faxmaster.

Integrazione con Postfix

Postfix è il Mail Transfer Agent predefinito di Ubuntu, la sua integrazione con Hylafax permette di ricevere ed inviare fax gestendoli da un normale client di posta. Allo scopo sono necessari Dovecot, il Delivery Agent e Procmail, un'applicazione molto potente usata per filtrare la posta in ingresso.

Installazione di Postfix

Per l'installazione di Postfix seguire la relativa guida.

Nell'esempio di configurazione seguente Postfix è stato configurato in modalità Maildir e verranno utilizzanti Dovecot e Procmail.

Alias

Hylafax crea in modo predefinito un utente chiamato faxmaster e un gruppo fax abilitati alla ricezione dei fax e alle notifiche del programma. Per il corretto funzionamento è necessario creare un utente fax.

Per fare in modo che vengano consegnate le notifiche relative ai fax e i fax stessi in allegato all'utente di sistema, procedere come segue:

1. Aprire con un editor di testo con i privilegi di amministrazione il file /etc/aliases e inserire il seguente testo:

   faxmaster: mario
   mario:  mario@rossi.it

   In questo modo faxmaster corrisponde all'utente mario con indirizzo email mario@rossi.it.

2. Salvare e chiudere

3. Infine, digitare in una finestra di terminale il seguente comando:

   postalias /etc/aliases 

Gateway fax - email

Per ricevere i fax con relativa notifica direttamente al proprio indirizzo di posta elettronica, aprire con un editor di testo con i privilegi di amministrazione il file /var/spool/hylafax/bin/faxrcvd e modificare le seguenti righe:

FILETYPE=pdf
SENDTO=FaxMaster

In questo caso i fax vengono allegati nel formato PDF, ma è possibile utilizzare i formati TIFF o PS.

Gateway email - fax

Questo permette di inviare dei fax usando il proprio client di posta elettronica. La sintassi del destinatario sarà: numero_fax_del_destinatario@fax.rossi.it

1. Aprire con un editor di testo con i privilegi di amministrazione il file /etc/postfix/master.cf e inserire il seguente testo:

   fax      unix  -       n       n       -       1       pipe 
     flags= user=fax argv=/usr/bin/faxmail -d -n ${user}      # Rispettare il rientro ad inizio riga.

2. Aprire con un editor di testo con i privilegi di amministrazione il file /etc/postfix/transport e inserire il seguente testo:

   fax.rossi.it fax:localhost 

3. Aprire con un editor di testo con i privilegi di amministrazione il file /etc/postfix/main.cf e inserire il seguente testo:

   transport_maps = hash:/etc/postfix/transport 
   fax_destination_recipient_limit = 1

4. Infine, digitare in una finestra di terminale i seguenti comandi:

   postmap /etc/postfix/transport
   /etc/init.d/postfix restart

Notifiche di trasmissione

In modo predefinito Hylafax non invia notifiche di avvenuta trasmissione dei fax andati a buon fine, ma solo nel caso di errore e se il programma è stato configurato come gateway fax - email ed è stato impostato correttamente l'alias per faxmaster.

Per ricevere le notifiche di avvenuta trasmissione dei fax anche se questi sono andati a buon fine, è necessario creare due files.

Con un editor di testo con i privilegi di amministrazione creare il primo file /etc/hylafax/FaxDispatch inserendo quanto segue:

SENDTO=FaxMaster;
FILETYPE=pdf;

Con un editor di testo con i privilegi di amministrazione creare il secondo file /etc/hylafax/FaxNotify inserendo quanto segue:

RETURNFILETYPE=pdf;

Dovecot

1. Aprire con un editor di testo con i privilegi di amministrazione il file /etc/dovecot/dovecot.conf e aggiungere il seguente testo:

   protocols = imap imaps
   disable_plaintext_auth = no
   mail_location = maildir:~/Maildir

2. Riavviare il server IMAP digitando il seguente comando:

   /etc/init.d/dovecot restart

Procmail

Nel caso si sia indicato a Postfix, come da impostazione predefinita, di utilizzare Procmail, è necessario creare con un editor di testo con i privilegi di amministrazione il file /etc/procmailrc inserendo quanto segue:

DEFAULT=$HOME/Maildir/ 
MAILDIR=$HOME/Maildir

Ulteriori risorse

• Modem How to

• Elenco comandi Hayes

• Sito ufficiale Postfix

• Sito ufficiale Hylafax

• Sito ufficiale Dovecot

• Sito ufficiale Procmail

• Elenco di client desktop

• Moduli di controllo

CategoryServer CategoryDaRevisionare