Differenze tra le versioni 90 e 92 (in 2 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 e cercare la seguente riga:
```
ModemDialCmd:           ATX3DT%s
```

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

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

Integrazione con 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 è stato configurato come [#faxemail gateway fax-email] e 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]

CategoryHomepage

-  ⇤ ← Versione 90 del 12/04/2009 11.14.55 → 
  Dimensione: 8191
  Autore: PaoloVisnoviz
  Commento:
+   ← Versione 92 del 12/04/2009 18.29.31 → ⇥
  Dimensione: 8113
  Autore: MiloCasagrande
  Commento:
-Le cancellazioni sono segnalate in questo modo.
+Le aggiunte sono segnalate in questo modo.
 Linea 9:
-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:
-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:
+Linea 19:
+}}} 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 25:
-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 31:
-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 35:
-||<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:
+Linea 39:
+== Dialtone ==
 Linea 41:
-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:
-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` e cercare la seguente riga: {{{
-Linea 47:
+Linea 49:
-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
}}}
+Questo e molti altri parametri di configurazione si trovano nel file `/etc/hylafax/config.ttyS0`.
-Linea 60:
+Linea 57:
-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 61:
-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 64:
-Mentre per riavviare '''Hylafax''' digitare il seguente comando: {{{
+ * Per riavviare il servizio, in un terminale digitare: {{{
-Linea 82:
+Linea 79:
-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 84:
-'''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:
-== Fax email gateway ==
+== Gateway fax - email ==
 Linea 101:
-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:
-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:
-[[Anchor(Fax_to_email_gateway)]] 
== Mail to fax gateway ==
+[[Anchor(faxemail)]] 
== Gateway email - fax ==
 Linea 111:
-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:
-. Infine digitare in una finestra di terminale i seguenti comandi: {{{
+. Infine, digitare in una finestra di terminale i seguenti comandi: {{{
 Linea 134:
-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 è stato configurato come [#faxemail gateway fax-email] e impostato correttamente l'[#alias alias per faxmaster].
-Linea 137:
+Linea 136:
-{{{
+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 144:
+Linea 143:
-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 149:
-Infine riavviare l' IMAP server digitando il seguente comando: {{{
+. Riavviare il server IMAP digitando il seguente comando: {{{
-Linea 156:
+Linea 155:
-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 161:
-Linea 170:
+Linea 168:
- * [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]