Differenze tra le versioni 90 e 96 (in 6 versioni)

BR Indice() VersioniSupportate(hardy intrepid)

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

[:AmministrazioneSistema/InstallareProgrammi:Installare] i pacchetti hylafax-server e hylafax-client, reperibili dal [:Repository/Componenti:componente] universe dei [:Repository:repository ufficiali].

Configurazione

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.
Configurare il modem/fax, digitando sempre nel server il seguente comando:
```
faxsetup
```

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 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:

Aprire con un [:Ufficio/EditorDiTesto:editor di testo] con i [:AmministrazioneSistema/Sudo:privilegi di amministrazione] il file /etc/hylafax/config.ttyS0 cercare la seguente riga:
```
ModemDialCmd:           ATDT%s
```
Modificarla nel modo seguente:
```
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 un terminale digitare:
```
faxstat -s 
```
Per riavviare il servizio, in un terminale digitare:
```
/etc/init.d/hylafax restart
```

Crontab

Aprire con un [:Ufficio/EditorDiTesto:editor di testo] con i [:AmministrazioneSistema/Sudo: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 [http://wiki.ubuntu-it.org/AmministrazioneSistema/Cron 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 [http://wiki.ubuntu-it.org/Server/Mail#head-ecc2610cdffaaba30bf3fed0d4a5991eb0ee844a 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 [http://wiki.ubuntu-it.org/Server/Mail#head-5f25f6d3a3b65d74f570a04825c1f272563cb9bf 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 [:Server/Mail:relativa guida].

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

Anchor(alias)

Alias

Hylafax crea in modo predefinito un utente chiamato faxmaster abilitato alla ricezione dei fax e delle notifiche del programma.

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:

Aprire con un [:Ufficio/EditorDiTesto:editor di testo] con i [:AmministrazioneSistema/Sudo:privilegi di amministrazione] il file /etc/aliases e inserire il seguente testo:
```
faxmaster: mario
paolo:  mario@rossi.it
```
In questo modo faxmaster corrisponde all'utente mario con indirizzo email mario@rossi.it.
Salvare e chiudere
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 [:Ufficio/EditorDiTesto:editor di testo] con i [:AmministrazioneSistema/Sudo: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.

Anchor(faxemail)

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.prova.com

Aprire con un [:Ufficio/EditorDiTesto:editor di testo] con i [:AmministrazioneSistema/Sudo: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.
```
Aprire con un [:Ufficio/EditorDiTesto:editor di testo] con i [:AmministrazioneSistema/Sudo:privilegi di amministrazione] il file /etc/postfix/transport e inserire il seguente testo:
```
fax.prova.com fax:localhost 
```
Aprire con un [:Ufficio/EditorDiTesto:editor di testo] con i [:AmministrazioneSistema/Sudo: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
```
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 [#faxemail gateway fax - email] ed è stato impostato correttamente l'[#alias alias per faxmaster].

Per ricevere le notifiche di avvenuta trasmissione dei fax anche se questi sono andati a buon fine, è necessario creare con un [:Ufficio/EditorDiTesto:editor di testo] con i [:AmministrazioneSistema/Sudo:privilegi di amministrazione] il file /etc/hylafax/FaxDispatch inserendo quanto segue:

SENDTO=FaxMaster;
FILETYPE=pdf;

Dovecot

Aprire con un [:Ufficio/EditorDiTesto:editor di testo] con i [:AmministrazioneSistema/Sudo: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
```
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 [:Ufficio/EditorDiTesto:editor di testo] con i [:AmministrazioneSistema/Sudo:privilegi di amministrazione] il file /etc/procmailrc inserendo quanto segue:

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

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]
[http://www.hylafax.org/content/Desktop_Client_Software Elenco di client desktop]
[http://www.hylafax.org/content/Management_Utilities Moduli di controllo]

CategoryServer

-  ⇤ ← Versione 90 del 12/04/2009 11.14.55 → 
  Dimensione: 8191
  Autore: PaoloVisnoviz
  Commento:
+   ← Versione 96 del 12/04/2009 23.26.05 → ⇥
  Dimensione: 8938
  Autore: PaoloVisnoviz
  Commento:
-Le cancellazioni sono segnalate in questo modo.
+Le aggiunte sono segnalate in questo modo.
 Linea 1:
+## page was renamed from PaoloVisnoviz/Prove2
-Linea 9:
+Linea 10:
-In questa guida sono presenti delle istruzioni utili all'installazione di '''HylaFAX''' su server '''Ubuntu''', un programma per l'invio e la ricezione mezzo fax di documenti digitali di classe enterprise.
+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.
-Linea 17:
+Linea 18:
-Prima di iniziare la configurazione di '''Hylafax''' controllare il corretto collegamento del modem/fax. 
Digitare in una finestra di terminale del server il seguente comando: {{{
+. Prima di iniziare la configurazione controllare il corretto collegamento del modem/fax. Digitare in una finestra di terminale del server il seguente comando: {{{
 Linea 20:
+}}} Se il modem è collegato correttamente, le spie del modem si accendono.

 0. Configurare il modem/fax, digitando sempre nel server il seguente comando: {{{
faxsetup
-Linea 22:
+Linea 26:
-Se il modem è collegato correttamente, le spie del modem si accendono.
  Configurare il modem/fax, digitando nella riga di comando del server il seguente comando: {{{
faxsetup
}}} 

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 del Vs. Fax. Comparirà nei fax trasmessi e in ricezione.
+. 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
-Linea 34:
+Linea 32:
-Local Identifier: "Nome Vs. Fax Server"    # Stringa identificativa alfanumerica. Comparirà nei fax trasmessi e in ricezione.
RingsBeforeAnswer: 1                       # Numero di squilli prima della risposta.
+Local Identifier: "Nome del server fax"    # Stringa identificativa alfanumerica, comparirà nei fax trasmessi e in ricezione
RingsBeforeAnswer: 1                       # Numero di squilli prima della risposta
-Linea 38:
+Linea 36:
-||<tablestyle="text-align: justify; width:100%;" style="border:none;" 5%>[[Immagine(Icone/Piccole/warning.png,,center)]] ||<style="padding:0.5em; border:none;">'''No dialtone.''' ||
+Per riconfigurare il modem, o aggiungerne un altro, è possibile digitare il seguente comando: {{{
faxaddmodem
}}}
 Linea 40:
+== Dialtone ==
-Linea 41:
+Linea 42:
-Molto 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.
+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.
-Linea 43:
+Linea 44:
-Aprire con un [:Ufficio/EditorDiTesto:editor di testo] con i [:AmministrazioneSistema/Sudo:privilegi di amministrazione] il file `/etc/hylafax/config.ttyS0` e cercare la seguente riga: {{{
+Per risolvere questo problema, procedere come segue:

 0. Aprire con un [:Ufficio/EditorDiTesto:editor di testo] con i [:AmministrazioneSistema/Sudo:privilegi di amministrazione] il file `/etc/hylafax/config.ttyS0` cercare la seguente riga: {{{
ModemDialCmd:           ATDT%s
}}} Modificarla nel modo seguente: {{{
-Linea 47:
+Linea 52:
-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 può digitare il seguente comando:
{{{
faxaddmodem
}}}
-Linea 60:
+Linea 59:
-Dove «nome_utente» va sostituito con il proprio nome utente e «password» con la propria password.
+Dove `nome_utente` va sostituito con il proprio nome utente e `password` con la propria password.
-Linea 64:
+Linea 63:
-Con il seguente comando è possibile controllare lo stato del fax server: {{{
+ * Per controllare lo stato del server fax, in un terminale digitare: {{{
-Linea 67:
+Linea 66:
-Mentre per riavviare '''Hylafax''' digitare il seguente comando: {{{
+ * Per riavviare il servizio, in un terminale digitare: {{{
-Linea 78:
+Linea 77:
+Tramite il servizio di schedulazione [http://wiki.ubuntu-it.org/AmministrazioneSistema/Cron Cron], il comando `faxqclean` elimina i fax spediti. Il comando `faxcron` crea un rapporto statistico che viene inoltrato all' utente `faxmaster`.
-Linea 79:
+Linea 80:
+'''Postfix''' è il [http://wiki.ubuntu-it.org/Server/Mail#head-ecc2610cdffaaba30bf3fed0d4a5991eb0ee844a 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 [http://wiki.ubuntu-it.org/Server/Mail#head-5f25f6d3a3b65d74f570a04825c1f272563cb9bf Delivery Agent] e '''Procmail''', un'applicazione molto potente usata per filtrare la posta in ingresso.

== Installazione di Postfix ==
-Linea 82:
+Linea 87:
-Nell' esempio di configurazione seguente Postfix è stato configurato in modalità « Maildir ».
Verranno utilizzati Dovecot e Procmail.
+Nell'esempio di configurazione seguente Postfix è stato configurato in modalità '''Maildir''' e verranno utilizzanti '''Dovecot''' e '''Procmail'''.
-Linea 88:
+Linea 92:
-'''Hylafax''' crea un utente "faxmaster", il quale è abilitato alla ricezione dei fax e delle notifiche di '''Hylafax'''. Aggiungere l'utente di sistema e la mail corrispondente per la consegna delle notifiche e dei fax allegati come indicato di seguito:
Aprire con un [:Ufficio/EditorDiTesto:editor di testo] con i [:AmministrazioneSistema/Sudo:privilegi di amministrazione] il file `/etc/aliases` e inserire il seguente testo: {{{
faxmaster: paolo
paolo:  paolo@prova.com
}}}
In questo caso è stato impostato che « faxmaster » corrisponde all'utente « paolo » con indirizzo e-mail « paolo@prova.com ».
Salvare e chiudere.
Infine digitare in una finestra di terminale il seguente comando: {{{
+'''Hylafax''' crea in modo predefinito un utente chiamato '''faxmaster''' abilitato alla ricezione dei fax e delle notifiche del programma.

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:

 0. Aprire con un [:Ufficio/EditorDiTesto:editor di testo] con i [:AmministrazioneSistema/Sudo:privilegi di amministrazione] il file `/etc/aliases` e inserire il seguente testo: {{{
faxmaster: mario
paolo:  mario@rossi.it
}}} In questo modo '''faxmaster''' corrisponde all'utente '''mario''' con indirizzo email `mario@rossi.it`.

 0. Salvare e chiudere

 0. Infine, digitare in una finestra di terminale il seguente comando: {{{
-Linea 99:
+Linea 107:
-== Fax email gateway ==
+== Gateway fax - email ==
-Linea 101:
+Linea 109:
-Per ricevere i fax con relativa notifica direttamente al proprio indirizzo di posta elettronica aprire con un [:Ufficio/EditorDiTesto:editor di testo] con i [:AmministrazioneSistema/Sudo:privilegi di amministrazione] il file `/var/spool/hylafax/bin/faxrcvd` e modificare le seguenti righe: {{{
+Per ricevere i fax con relativa notifica direttamente al proprio indirizzo di posta elettronica, aprire con un [:Ufficio/EditorDiTesto:editor di testo] con i [:AmministrazioneSistema/Sudo:privilegi di amministrazione] il file `/var/spool/hylafax/bin/faxrcvd` e modificare le seguenti righe: {{{
-Linea 106:
+Linea 114:
-In questo caso i fax verranno allegati nel formato `PDF`. Si può sostituire con `TIFF` o con `PS`.
+In questo caso i fax vengono allegati nel formato PDF, ma è possibile utilizzare i formati TIFF o PS.
-Linea 108:
+Linea 116:
-[[Anchor(Fax_to_email_gateway)]] 
== Mail to fax gateway ==
+[[Anchor(faxemail)]] 
== Gateway email - fax ==
-Linea 111:
+Linea 119:
-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 »
+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`
-Linea 127:
+Linea 135:
-. Infine digitare in una finestra di terminale i seguenti comandi: {{{
+. Infine, digitare in una finestra di terminale i seguenti comandi: {{{
-Linea 134:
+Linea 142:
-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 con un [:Ufficio/EditorDiTesto:editor di testo] con i [:AmministrazioneSistema/Sudo:privilegi di amministrazione] il file: `/etc/hylafax/FaxDispatch` mettendo il seguente testo:
+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 [#faxemail gateway fax - email] ed è stato impostato correttamente l'[#alias alias per faxmaster].
-Linea 137:
+Linea 144:
-{{{
+Per ricevere le notifiche di avvenuta trasmissione dei fax anche se questi sono andati a buon fine, è necessario creare con un [:Ufficio/EditorDiTesto:editor di testo] con i [:AmministrazioneSistema/Sudo:privilegi di amministrazione] il file `/etc/hylafax/FaxDispatch` inserendo quanto segue: {{{
-Linea 142:
+Linea 149:
-= Dovecot =
+== Dovecot ==
-Linea 144:
+Linea 151:
-Aprire con un [:Ufficio/EditorDiTesto:editor di testo] con i [:AmministrazioneSistema/Sudo:privilegi di amministrazione] il file `/etc/dovecot/dovecot.conf` e aggiungere il seguente testo: {{{
+. Aprire con un [:Ufficio/EditorDiTesto:editor di testo] con i [:AmministrazioneSistema/Sudo:privilegi di amministrazione] il file `/etc/dovecot/dovecot.conf` e aggiungere il seguente testo: {{{
-Linea 150:
+Linea 157:
-Infine riavviare l' IMAP server digitando il seguente comando: {{{
+. Riavviare il server IMAP digitando il seguente comando: {{{
-Linea 154:
+Linea 161:
-= Procmail =
+== Procmail ==
-Linea 156:
+Linea 163:
-Nel caso si sia indicato a `Postfix`, come da default, di utilizzare `Procmail` sarà necessario creare con un [:Ufficio/EditorDiTesto:editor di testo] con i [:AmministrazioneSistema/Sudo:privilegi di amministrazione] il file: `/etc/procmailrc` mettendo il seguente testo: {{{
+Nel caso si sia indicato a '''Postfix''', come da impostazione predefinita, di utilizzare '''Procmail''', è necessario creare con un [:Ufficio/EditorDiTesto:editor di testo] con i [:AmministrazioneSistema/Sudo:privilegi di amministrazione] il file `/etc/procmailrc` inserendo quanto segue: {{{
-Linea 162:
+Linea 169:
-Linea 170:
+Linea 176:
- * [http://www.hylafax.org/content/Desktop_Client_Software Lista di desktop client]
 * [[http://www.hylafax.org/content/Management_Utilities Moduli di controllo]
+ * [http://www.hylafax.org/content/Desktop_Client_Software Elenco di client desktop]
 * [http://www.hylafax.org/content/Management_Utilities Moduli di controllo]
-Linea 174:
+Linea 179:
-CategoryHomepage
+CategoryServer