|
Dimensione: 7853
Commento:
|
Dimensione: 8096
Commento: altra revisione
|
| Le cancellazioni sono segnalate in questo modo. | Le aggiunte sono segnalate in questo modo. |
| Linea 1: | Linea 1: |
| #format wiki #LANGUAGE it |
|
| Linea 5: | Linea 7: |
| = Introduzione ad Hylafax = | = Introduzione = |
| Linea 7: | Linea 9: |
| Questa guida spiegherà come installare e usare '''HylaFAX''' su server '''Ubuntu''', un sistema 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 9: | Linea 11: |
| == Installazione == | = Installazione = |
| Linea 11: | Linea 13: |
| Per utilizzare '''Hylafax''' è necessario [:AmministrazioneSistema/InstallareProgrammi:installare] i pacchetti ''hylafax-server'' e ''hylafax-client'', reperibili dal [:Repository/Componenti:componente] '''universe''' dei [:Repository:repository ufficiali]. | [:AmministrazioneSistema/InstallareProgrammi:Installare] i pacchetti ''hylafax-server'' e ''hylafax-client'', reperibili dal [:Repository/Componenti:componente] '''universe''' dei [:Repository:repository ufficiali]. |
| Linea 13: | Linea 15: |
| == Configurazione Hylafax == | = Configurazione = |
| Linea 15: | Linea 17: |
| 0. Prima di iniziare la configurazione di '''Hylafax''' è opportuno controllare il corretto collegamento del modem/fax. Per fare ciò è sufficiente digitare in una finestra di terminale del server il seguente comando: {{{ | 0. Prima di iniziare la configurazione controllare il corretto collegamento del modem/fax. Digitare in una finestra di terminale del server il seguente comando: {{{ |
| Linea 17: | Linea 19: |
| }}} Qualche attività delle spie del modem/fax confermerà che il dispositivo sia correttamente collegato alla `/dev/ttyS0 ` (corrispondente a COM1). | }}} Se il modem è collegato correttamente, le spie del modem si accendono. |
| Linea 19: | Linea 21: |
| 0. Come prima cosa è necessario configurare il modem/fax, per fare ciò è sufficiente digitare da riga di comando del server: {{{ | 0. Configurare il modem/fax, digitando sempre nel server il seguente comando: {{{ |
| Linea 21: | Linea 23: |
| }}} Nelle opzioni di configurazione, molto intuitive, si può lasciare tutto come da default tranne i seguenti campi che vanno modificati come segue: {{{ 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. |
}}} 0. 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 27: | 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 31: | 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.''' || ##No dialtone=??? |
Per riconfigurare il modem, o aggiungerne un altro, è possibile digitare il seguente comando: {{{ faxaddmodem }}} |
| Linea 34: | Linea 39: |
| 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. | == Dialtone == |
| Linea 36: | Linea 41: |
| Potrebbe essere utile modificare questo comportamento, aggiungendo il parametro «X3» in «ModemDialCmd» come nell' esempio seguente: {{{ | 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: 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 40: | 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: {{{ faxaddmodem }}} |
Questo e molti altri parametri di configurazione si trovano nel file `/etc/hylafax/config.ttyS0`. |
| Linea 49: | Linea 53: |
| Per permettere l'uso di '''Hylafax''' bisogna aggiungere gli utenti tramite il comando: {{{ |
Per permettere l'uso di '''Hylafax''', aggiungere gli utenti digitando in una finestra di terminale il seguente comando: {{{ |
| Linea 54: | 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 58: | Linea 61: |
| {{{ | * Per controllare lo stato del server fax, in un terminale digitare: {{{ |
| Linea 60: | Linea 63: |
| }}} Permette di controllare di controllare lo stato del fax server. Sono disponibili altri switch. {{{ |
}}} * Per riavviare il servizio, in un terminale digitare: {{{ |
| Linea 64: | Linea 66: |
| }}} 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 Hylafax si può trovare al seguente indirizzo: [http://www.hylafax.org/content/Desktop_Client_Software] |
}}} |
| Linea 78: | Linea 70: |
| Per la cancellazione delle code e i report giornalieri inserire in `/etc/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: {{{ |
| Linea 87: | Linea 77: |
| Per l'installazione di Postfix seguire la seguente guida: [http://wiki.ubuntu-it.org/Server/Mail Mail Server] | Per l'installazione di Postfix seguire la [:Server/Mail:relativa guida]. |
| Linea 89: | Linea 79: |
| Nell' esempio di configurazione seguente si assume che Postfix sia stato configurato in modalità « Maildir ». Verranno pure utilizzati Dovecot e Procmail. |
Nell'esempio di configurazione seguente Postfix è stato configurato in modalità '''Maildir''' e verranno utilizzanti '''Dovecot''' e '''Procmail'''. |
| Linea 95: | Linea 84: |
| L'installazione di Hylafax dovrebbe aver creato un utente « faxmaster » e un utente « fax ». 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. |
'''Hylafax''' crea un utente '''faxmaster''', abilitato alla ricezione dei fax e delle notifiche del programma. |
| Linea 98: | Linea 86: |
| {{{ faxmaster: paolo paolo: paolo@prova.com }}} |
Per fare in modo che vengano consegnate le notifiche relative ai fax e i fax in allegato, aggiungere Aggiungere l'utente di sistema e la mail corrispondente: |
| Linea 103: | Linea 88: |
| In questo caso è stato impostato che « faxmaster » corrisponde all'utente « paolo » con indirizzo e-mail « paolo@prova.com ». | 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 '''faxmaster''' corrisponde all'utente '''mario''' con indirizzo email `mario@rossi.it`. |
| Linea 105: | Linea 93: |
| Una volta che si è modificato il file `/etc/aliases` bisognerà comunicarlo a Postfix digitando il comando: | 0. Salvare e chiudere |
| Linea 107: | Linea 95: |
| {{{ | 0. Infine digitare in una finestra di terminale il seguente comando: {{{ |
| Linea 111: | Linea 99: |
| [[Anchor(Fax_to_email_gateway)]] == Fax to email gateway == |
== Gateway fax - email == |
| Linea 114: | Linea 101: |
| Questo permette di ricevere i fax, allegati alla notifica, direttamente al proprio indirizzo di posta elettronica. Modificare il file `/var/spool/hylafax/bin/faxrcvd` {{{ |
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 122: | 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 124: | Linea 108: |
| [[Anchor(faxemail)]] == Gateway email - fax == |
|
| Linea 125: | Linea 111: |
| == 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` |
| Linea 127: | Linea 113: |
| 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`{{{ |
0. 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: {{{ |
| Linea 135: | Linea 118: |
| 0. `/etc/postfix/transport`. Questo file probabilmente non esisterà. Bisogna crearlo.{{{ | 0. 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: {{{ |
| Linea 139: | Linea 122: |
| 0. `/etc/postfix/main.cf`{{{ | 0. 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: {{{ |
| Linea 144: | Linea 127: |
| 0. Digitare il comando:{{{ | 0. Infine, digitare in una finestra di terminale i seguenti comandi: {{{ |
| Linea 146: | Linea 129: |
| }}} 0. Riavviare Postfix. {{{ |
|
| Linea 154: | 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 il file: `/etc/hylafax/FaxDispatch` con il seguente contenuto: |
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 157: | 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 164: | Linea 143: |
| Gli unici parametri da cambiare nell' IMAP server Dovecot sono nel file `/etc/dovecot/dovecot.conf` {{{ |
0. 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 171: | Linea 148: |
| [[Anchor(Fax_to_email_gateway)]] Ovviamente si può configurare anche con protocollo POP3. Fare riferimento alla sezione [#Ulteriori Ulteriori Risorse] |
|
| Linea 174: | Linea 149: |
| Riavviare l' IMAP server: {{{ |
0. Riavviare il server IMAP digitando il seguente comando: {{{ |
| Linea 181: | Linea 155: |
| Nel caso si sia indicato a `Postfix`, come da default, di utilizzare `Procmail` sarà necessario creare il file: `/etc/procmailrc` Aggiungere le seguenti istruzioni: {{{ |
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 190: | Linea 160: |
| [[Anchor(Ulteriori)]] | |
| Linea 192: | Linea 161: |
| Linea 200: | Linea 168: |
| * [http://www.hylafax.org/content/Desktop_Client_Software Elenco di client desktop] * [http://www.hylafax.org/content/Management_Utilities Moduli di controllo] |
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.
Alias
Hylafax crea un utente 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 in allegato, aggiungere Aggiungere l'utente di sistema e la mail corrispondente:
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 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.
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]
