Differenze tra le versioni 12 e 74 (in 62 versioni)

BR Indice() VersioniSupportate(hardy intrepid)

Introduzione ad Hylafax

HylaFAX è un sistema per l'invio e la ricezione mezzo fax di documenti digitali di classe enterprise. Il sistema è basato su architettura client/server. Il dispositivo hardware modem/fax viene collegato fisicamente ad un server permettendone la condivisione ai vari client. Hylafax è affidabile e permette carichi di lavoro molto pesanti. Supporta molti dispositivi harware. Alcune delle sue possibilità sono:

inviare fax.
inviare fax a più destinatari.
ricevere fax.
inviare l'esito di trasmissione tramite posta elettronica.
inoltrare come allegati i fax ricevuti ad un indirizzo di posta elettronica (Fax-to-Email Gateway)
stampare automaticamente i fax ricevuti
spedire fax da client di posta di elettronica (Mail-to-Fax Gateway)

Preparativi

In questa sede verrà trattata l'installazione di Hylafax su server Ubuntu. La sua integrazione con Postfix, pur essendo ampiamente esposta, è da considerarsi opzionale. L'installazione considera l'uso di un dispositivo modem/fax esterno, collegato ad una porta seriale del server.

Installazione

Per utilizzare Hylafax è necessario [:AmministrazioneSistema/InstallareProgrammi:installare] i pacchetti hylafax-server e hylafax-client, reperibili dal [:Repository/Componenti:componente] universe dei [:Repository:repository ufficiali].

Configurazione Hylafax

Prima di iniziare la configurazione di Hylafax è opportuno controllare il corretto collegamento del modem/fax. Per fare ciò potrebbe essere sufficiente digitare da riga di comando del server:
```
echo "ATDT123456789" > /dev/ttyS0
```
Qualche attività delle spie del modem/fax confermerà che il dispositivo sia correttamente collegato alla /dev/ttyS0 (corrispondente a COM1).

Come prima cosa è necessario configurare il modem/fax. Sarà sufficiente digitare da riga di comando del server:

faxsetup

Nelle opzioni di configurazione, molto intuitive, si può lasciare tutto come da default tranne i campi:

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 del Vs. Fax. Comparirà nei fax trasmessi e in ricezione.
Long DistanceDialingPrefix: 0                       
International DialingPrefix: 00
Local Identifier: "Nome Vs. Fax Server"    # Stringa identificativa alfanumerica. Comparirà nei fax trasmessi e in ricezione.
RingsBeforeAnswer: 1                       # Numero di squilli prima della risposta.

Immagine(Icone/Piccole/warning.png,,center)

No dialtone.

Spesso i modem/fax sono configurati per il mercato americano. Questo comporta che il dispositivo, prima di effettuare la chiamata, attenda il tono di linea continuo tipico della telefonia statunitense. Non trovandolo, il modem/fax, impedirà si effettui la chiamata.

Potrebbe essere utile modificare questo comportamento, aggiungendo il parametro « X3 » come nell' esempio seguente:

ModemDialCmd:           ATX3DT%s

Questo e molti altri parametri di configurazione si trovano nel file: /etc/hylafax/config.ttyS0

Nel caso si voglia riconfigurare il modem, o aggiungerne un'altro si potrà digitare:

faxaddmodem

Permessi

Per permettere l'uso di Hylafax bisogna aggiungere gli utenti tramite il comando:

faxadduser -p password nome_utente

L' utente verrà aggiunto nel file:

/etc/hylafax/hosts.hfaxd

Comandi di controllo

faxstat -s

Permette di controllare di controllare lo stato del fax server. Sono disponibili altri switch.

/etc/init.d/hylafax restart

Permette di riavviare Hylafax.

Esistono dei moduli di controllo sviluppati per Usermin, Webmin e Nagios. Si possono trovare al seguente indirizzo:

[http://www.hylafax.org/content/Management_Utilities]

Client

Una lista esaustiva di desktop client per Hylafrax si può trovare al seguente indirizzo:

[http://www.hylafax.org/content/Desktop_Client_Software]

Crontab

Per la cancellazione delle code e i report giornalieri inserire in /etc/crontab

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

Integrazione con Postfix

Per l'installazione di Postfix seguire la seguente guida: [http://wiki.ubuntu-it.org/Server/Mail Mail Server]

Nell' esempio di configurazione seguente si assume che Postfix sia stato configurato in modalità « Maildir ». Verranno pure utilizzati Dovecot e Procmail.

Anchor(alias)

Alias

L'installazione di Hylafax dovrebbe aver creato un utente « faxmaster ». Per controllare verificare il file /etc/group Se si è seguita la guida di Postfix si avrà capito l'importanza e la funzione degli alias, in questo caso verrà aggiunto un valore nel file /etc/aliases per stabilire a quale utente inviare i fax ricevuti, le notifiche, ecc.

faxmaster: paolo
paolo:  paolo@prova.com

In questo caso è stato impostato che « faxmaster » corrisponde all'utente « paolo » con indirizzo e-mail « paolo@prova.com ».

Una volta che si è modificato il file /etc/aliases bisognerà comunicarlo a Postfix digitando il comando:

postalias /etc/aliases

Anchor(Fax_to_email_gateway)

Fax to email gateway

Questo permette di ricevere i fax, allegati alla notifica, direttamente al proprio indirizzo di posta elettronica. Modificare il file /var/spool/hylafax/bin/faxrcvd

FILETYPE=pdf
SENDTO=FaxMaster

In questo caso i fax verranno allegati nel formato PDF. Si può sostituire con TIFF o con PS.

Mail to fax gateway

Questo permette di inviare dei fax usando il proprio client di posta elettronica. La sintassi del destinatario sarà: « numero_fax_del_destinatario@fax.prova.com » Per ottenere questo risultato bisognerà modificare i seguenti file:

/etc/postfix/master.cf

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

/etc/postfix/transport

Questo file probabilmente non esisterà. Bisogna crearlo.

fax.prova.com fax:localhost

/etc/postfix/main.cf

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

Digitare il comando:

postmap /etc/postfix/transport

Riavviare Postfix:

/etc/init.d/postfix restart

Notifiche di trasmissione

Per default Hylafax non invia notifiche di avvenuta trasmissione dei fax inviati a buon fine. Le invia solo nel caso di errore e che sia stata configurata la sezione [#Fax_to_email_gateway Fax to email gateway] e impostato correttamente l' [#alias alias per faxmaster]. Nel caso si volessero ricevere le notifiche di avvenuta trasmissione dei fax anche se questi sono andati a buon fine bisogna creare il file: /etc/hylafax/FaxDispatch con il seguente contenuto:

SENDTO=FaxMaster;
FILETYPE=pdf;

Dovecot

Gli unici parametri da cambiare nell' IMAP server Dovecot sono nel file /etc/dovecot/dovecot.conf

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

Anchor(Fax_to_email_gateway) Ovviamente si può configurare anche con protocollo POP3. Fare riferimento alla sezione [#Ulteriori Ulteriori Risorse]

Riavviare l' IMAP server:

/etc/init.d/dovecot restart

Procmail

Creare il file: /etc/procmailrc

Editare le seguenti istruzioni:

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

Anchor(Ulteriori)

Ulteriori risorse

[http://www.pluto.it/files/ildp/HOWTO/Modem-HOWTO/Modem-HOWTO.html Modem How to]
[http://en.wikipedia.org/wiki/Hayes_command_set Elenco comandi Hayes]
[http://www.postfix.org/ Sito ufficiale Postfix]
[http://www.hylafax.org/content/Main_Page Sito ufficiale Hylafax]
[http://www.dovecot.org/ Sito ufficiale Dovecot]
[http://www.procmail.org/ Sito ufficiale Procmail]

CategoryHomepage

-  ⇤ ← Versione 12 del 22/03/2009 00.35.31 → 
  Dimensione: 5750
  Autore: PaoloVisnoviz
  Commento:
+   ← Versione 74 del 05/04/2009 09.00.24 → ⇥
  Dimensione: 8497
  Autore: LucaGambardella
  Commento:
-Le cancellazioni sono segnalate in questo modo.
+Le aggiunte sono segnalate in questo modo.
 Linea 4:
-[[WikiBanner(ArticoloIncompleto)]]


= Introduzione =
+= Introduzione ad Hylafax =
-Linea 10:
+Linea 8:
-Il sistema è basato su architettura client/server. Il dispositivo hardware modem/fax è collegato fisicamente ad un server permettendone la condivisione ai vari client. Hylafax è affidabile e permette carichi di lavoro molto pesanti. Supporta molti modelli di modem/fax. Le sue possibilità sono:
+Il sistema è basato su architettura client/server. Il dispositivo hardware modem/fax viene collegato fisicamente ad un server permettendone la condivisione ai vari client. Hylafax è affidabile e permette carichi di lavoro molto pesanti. Supporta molti dispositivi harware. Alcune delle sue possibilità sono:
-Linea 21:
+Linea 19:
-= Preparativi =
+== Preparativi ==
-Linea 26:
+Linea 24:
-= Installazione =

Per installare '''Hylafax''' è necessario [:AmministrazioneSistema/InstallareProgrammi:installare] i pacchetti ''hylafax-server'' e ''hylafax-client'', reperibile dal [:Repository/Componenti:componente] '''universe''' dei [:Repository:repository ufficiali]. 

# Da verificare il repository


= Configurazione Hylafax =

 0. Prima di iniziare la configurazione di Hylafax è opportuno controllare la corretta installazione del modem/fax. Per fare ciò potrebbe essere sufficiente digitare da riga di comando del server:
{{{
+== Installazione ==

Per utilizzare '''Hylafax''' è necessario [:AmministrazioneSistema/InstallareProgrammi:installare] i pacchetti ''hylafax-server'' e ''hylafax-client'', reperibili dal [:Repository/Componenti:componente] '''universe''' dei [:Repository:repository ufficiali]. 

== Configurazione Hylafax ==

  0. Prima di iniziare la configurazione di Hylafax è opportuno controllare il corretto collegamento del modem/fax. Per fare ciò potrebbe essere sufficiente digitare da riga di comando del server: {{{
-Linea 38:
+Linea 32:
-}}}
Qualche attività delle spie del modem/fax confermerà che il dispositivo sia correttamente collegato alla /dev/ttyS0 (COM1).


 0. Come prima cosa è necessario configurare il modem/fax. Sarà sufficiente digitare da riga di comando del server:{{{
+}}} Qualche attività delle spie del modem/fax confermerà che il dispositivo sia correttamente collegato alla `/dev/ttyS0 ` (corrispondente a COM1).

  0. Come prima cosa è necessario configurare il modem/fax. Sarà sufficiente digitare da riga di comando del server: {{{
faxsetup
}}} Nelle opzioni di configurazione, molto intuitive, si può lasciare tutto come da default tranne i campi: {{{
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 del Vs. Fax. Comparirà nei fax trasmessi e in ricezione.
Long DistanceDialingPrefix: 0                       
International DialingPrefix: 00
Local Identifier: "Nome Vs. Fax Server"    # Stringa identificativa alfanumerica. Comparirà nei fax trasmessi e in ricezione.
RingsBeforeAnswer: 1                       # Numero di squilli prima della risposta.
}}}

||<tablestyle="text-align: justify; width:100%;" style="border:none;" 5%>[[Immagine(Icone/Piccole/warning.png,,center)]] ||<style="padding:0.5em; border:none;">'''No dialtone.''' ||

Spesso i modem/fax sono configurati per il mercato americano. Questo comporta che il dispositivo, prima di effettuare la chiamata, attenda il tono di linea continuo tipico della telefonia statunitense. Non trovandolo, il modem/fax, impedirà si effettui la chiamata.

Potrebbe essere utile modificare questo comportamento, aggiungendo il parametro « X3 » come nell' esempio seguente: {{{
ModemDialCmd:           ATX3DT%s
}}}

Questo e molti altri parametri di configurazione si trovano nel file: `/etc/hylafax/config.ttyS0`

Nel caso si voglia riconfigurare il modem, o aggiungerne un'altro si potrà digitare:
{{{
-Linea 46:
+Linea 61:
-opzioni di configurazione


= Ulteriori risorse =


 * [http://www.pluto.it/files/ildp/HOWTO/Modem-HOWTO/Modem-HOWTO.html Modem How to]
 * [http://en.wikipedia.org/wiki/Hayes_command_set Elenco comandi Hayes]

----


Postfix


dpkg-reconfigure postfix
/etc/postfix/main.cf
 internet
 fser.prova.ts
 paolo
 prova.ts
 192.168.0.0/24
 usare procmail si

postconf -e 'home_mailbox = Maildir/'


Alias

/etc/aliases

FaxMaster: paolo
+== Permessi ==

Per permettere l'uso di Hylafax bisogna aggiungere gli utenti tramite il comando:
{{{
faxadduser -p password nome_utente
}}}

L' utente verrà aggiunto nel file: {{{
/etc/hylafax/hosts.hfaxd
}}}

== Comandi di controllo ==

{{{
faxstat -s 
}}} Permette di controllare di controllare lo stato del fax server. Sono disponibili altri switch.

{{{
/etc/init.d/hylafax restart
}}} Permette di riavviare Hylafax.

Esistono dei moduli di controllo sviluppati per Usermin, Webmin e Nagios. Si possono trovare al seguente indirizzo:

[http://www.hylafax.org/content/Management_Utilities]

== Client ==

Una lista esaustiva di desktop client per Hylafrax si può trovare al seguente indirizzo:

[http://www.hylafax.org/content/Desktop_Client_Software]

== Crontab ==

Per la cancellazione delle code e i report giornalieri inserire in `/etc/crontab`

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

= Integrazione con Postfix =

Per l'installazione di Postfix seguire la seguente guida: [http://wiki.ubuntu-it.org/Server/Mail Mail Server]

Nell' esempio di configurazione seguente si assume che Postfix sia stato configurato in modalità « Maildir ».
Verranno pure utilizzati Dovecot e Procmail.

[[Anchor(alias)]]
== Alias ==

L'installazione di Hylafax dovrebbe aver creato un utente « faxmaster ». Per controllare verificare il file `/etc/group`
Se si è seguita la guida di Postfix si avrà capito l'importanza e la funzione degli alias, in questo caso verrà aggiunto un valore nel file `/etc/aliases` per stabilire a quale utente inviare i fax ricevuti, le notifiche, ecc.

{{{
faxmaster: paolo
paolo:  paolo@prova.com
}}}

In questo caso è stato impostato che « faxmaster » corrisponde all'utente « paolo » con indirizzo e-mail « paolo@prova.com ».

Una volta che si è modificato il file `/etc/aliases` bisognerà comunicarlo a Postfix digitando il comando:

{{{
-Linea 80:
+Linea 125:
-Dovecot

/etc/dovecot/dovecot.conf
+}}}

[[Anchor(Fax_to_email_gateway)]] 
== Fax to email gateway ==

Questo permette di ricevere i fax, allegati alla notifica, direttamente al proprio indirizzo di posta elettronica.
Modificare il file `/var/spool/hylafax/bin/faxrcvd`

{{{
FILETYPE=pdf
SENDTO=FaxMaster
}}}

In questo caso i fax verranno allegati nel formato `PDF`. Si può sostituire con `TIFF` o con `PS`.


== Mail to fax gateway ==

Questo permette di inviare dei fax usando il proprio client di posta elettronica. La sintassi del destinatario sarà: « numero_fax_del_destinatario@fax.prova.com »
Per ottenere questo risultato bisognerà modificare i seguenti file:

  0. `/etc/postfix/master.cf`

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

  0. `/etc/postfix/transport`

Questo file probabilmente non esisterà. Bisogna crearlo.

{{{
fax.prova.com fax:localhost 
}}}

  0. `/etc/postfix/main.cf`

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

Digitare il comando:

{{{
postmap /etc/postfix/transport
}}}

Riavviare Postfix:

{{{
/etc/init.d/postfix restart
}}}

== Notifiche di trasmissione ==

Per default Hylafax non invia notifiche di avvenuta trasmissione dei fax inviati a buon fine. Le invia solo nel caso di errore e che sia stata configurata la sezione [#Fax_to_email_gateway Fax to email gateway] e impostato correttamente l' [#alias alias per faxmaster].
Nel caso si volessero ricevere le notifiche di avvenuta trasmissione dei fax anche se questi sono andati a buon fine bisogna creare il file: `/etc/hylafax/FaxDispatch` con il seguente contenuto:

{{{
SENDTO=FaxMaster;
FILETYPE=pdf;
}}}

= Dovecot =

Gli unici parametri da cambiare nell' IMAP server Dovecot sono nel file `/etc/dovecot/dovecot.conf`

{{{
-Linea 90:
+Linea 198:
+}}}
[[Anchor(Fax_to_email_gateway)]] 
Ovviamente si può configurare anche con protocollo POP3. Fare riferimento alla sezione [#Ulteriori Ulteriori Risorse]

Riavviare l' IMAP server:
{{{
-Linea 92:
+Linea 205:
-Procmailrc

/etc/procmailrc
+}}}

= Procmail =

Creare il file: `/etc/procmailrc`

Editare le seguenti istruzioni:

{{{
-Linea 98:
+Linea 216:
-Restart Dovecot e Postfix

Creazione utenti aggiungendoli al gruppo mail

useradd -m -G mail pippo

 --- mail:x:8:dovecot,paolo,pippo ---

Hylafax

10. e-mail encoding 
------------------- 

Hylafax is able to send received faxes via email. These emails 
need to include base64 encoded attachments. Since this is not essential 
to hylafax to work, you need to do manually some further steps: 
you should install a package that provide encoders (like 
mime-codecs or sharutils) and run 'faxsetup -server' that will 
automatically check for those encoders and change its configuration.


apt-get install hylafax-server hylafax-client

faxaddmodem

/var/spool/hylafax/bin/faxrcvd

FILETYPE=pdf
SENDTO=FaxMaster

HOSTNAME=hostname                  # XXX no good way to find FQDN 
PORT=4559   

      Spedire un fax via mail con Postfix 
   Con Postfix è possibile spedire un fax con HylaFAX semplicemente inviando una mail ad un 
indirizzo del tipo <faxNumber>@fax.our.domain. 

Configurazione nel file /etc/postfix/master.cf: 
fax      unix  -       n       n       -       1       pipe 
  flags= user=fax argv=/usr/bin/faxmail -d -n ${user} 


Configurazione:            /etc/postfix/transport: 
            fax.your.domain fax:localhost 


Configurazione nel file /etc/postfix/main.cf: 

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

postmap /etc/postfix/transport

/var/spool/hylafax/etc/FaxDispatch

SENDTO=FaxMaster;                               # by default email to FaxMaster
FILETYPE=pdf;                                   # in PDF format

 useradd -m -g faxmaster -G mail fax
passwd fax

Webmail – Squirrelmail

apt-get install squirrelmail

squirrelmail-configure

/usr/share/squirrelmail/images/sm_logo.png
400x100

INBOX.Trash
INBOX.Posta inviata 
INBOX.Bozze

/etc/apache2/apache2.conf
Include /etc/squirrelmail/apache.conf

Se volete l'interfaccia di squirrel mail in italiano dovete:

apt-get install squirrelmail-locales 

Installare tramite il gestore pacchetti questo pacchetto:squirrelmail.locales

dopo entrate in 
/var/lib/locales/supported.d/local

aggiungete 
it_IT ISO-8859-1

lo salvate e lanciate questo comando 
sudo dpkg-reconfigure locales

al termine entrate nella vostra casella mail via web e controllate che nelle preferenze ci sia l'italiano, eventualmente controllate il file di configurazione di squirrelmail e controllate che sia configurato in italiano: in tal caso lanciate il comando:

sudo squirrelmail-configure

andate al menù 10 e alla voce 1 deve risultare it_IT  e alla voce 2 iso-8859-1
eventualmente le settate voi, 

Ultima cosa riavviate tutti i servizi.

Link: http://squirrelmail.org/wiki/SupportingMultipleLanguages



Import export addressbook
/usr/share/squirrelmail/plugins
/usr/share/squirrelmail/plugins/abook_import_export
+}}}

[[Anchor(Ulteriori)]] 
= Ulteriori risorse =


 * [http://www.pluto.it/files/ildp/HOWTO/Modem-HOWTO/Modem-HOWTO.html Modem How to]
 * [http://en.wikipedia.org/wiki/Hayes_command_set Elenco comandi Hayes]
 * [http://www.postfix.org/ Sito ufficiale Postfix]
 * [http://www.hylafax.org/content/Main_Page Sito ufficiale Hylafax]
 * [http://www.dovecot.org/ Sito ufficiale Dovecot]
 * [http://www.procmail.org/ Sito ufficiale Procmail]
-Linea 209:
+Linea 229: