|
Dimensione: 7470
Commento:
|
Dimensione: 8191
Commento:
|
| Le cancellazioni sono segnalate in questo modo. | Le aggiunte sono segnalate in questo modo. |
| Linea 1: | Linea 1: |
| #format wiki #LANGUAGE it |
|
| Linea 4: | Linea 6: |
| [[WikiBanner(ArticoloIncompleto)]] | |
| Linea 6: | Linea 7: |
| = Introduzione = | |
| Linea 7: | Linea 9: |
| = Introduzione ad Hylafax = | 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. |
| Linea 9: | Linea 11: |
| 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: |
= Installazione = |
| Linea 12: | Linea 13: |
| * 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) |
[:AmministrazioneSistema/InstallareProgrammi:Installare] i pacchetti ''hylafax-server'' e ''hylafax-client'', reperibili dal [:Repository/Componenti:componente] '''universe''' dei [:Repository:repository ufficiali]. |
| Linea 20: | Linea 15: |
| = Configurazione = | |
| Linea 21: | Linea 17: |
| == Preparativi == | 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: {{{ echo "ATDT123456789" > /dev/ttyS0 }}} |
| Linea 23: | Linea 22: |
| 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. |
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 }}} |
| Linea 26: | Linea 28: |
| == Installazione == Per utilizzare '''Hylafax''' è necessario [:AmministrazioneSistema/InstallareProgrammi:installare] i pacchetti ''hylafax-server'' e ''hylafax-client'', reperibile 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: {{{ echo "ATDT123456789" > /dev/ttyS0 }}} Qualche attività delle spie del modem/fax confermerà che il dispositivo sia correttamente collegato alla `/dev/ttyS0 ` (equivalente alla COM1). [[BR]] 0. Come prima cosa è necessario configurare il modem/fax. Sarà sufficiente digitare da riga di comando del server: {{{ faxsetup[[Anchor(Fax_to_email_gateway)]] }}} 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 risposta al chiamante. |
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. |
| Linea 44: | Linea 34: |
| Local Identifier: "Nome Vs. Fax Server" # Stringa identificativa alfanumerica. Comparirà nei fax trasmessi e in risposta al chiamante. | Local Identifier: "Nome Vs. Fax Server" # Stringa identificativa alfanumerica. Comparirà nei fax trasmessi e in ricezione. RingsBeforeAnswer: 1 # Numero di squilli prima della risposta. |
| Linea 49: | Linea 40: |
| 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. | |
| Linea 51: | Linea 41: |
| Potrebbe essere utile modificare questo comportamento, aggiungendo il parametro « X3 » come nell' esempio seguente: {{{ | 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. 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 57: | Linea 49: |
| Nel caso si voglia riconfigurare il modem, o aggiungerne un'altro si potrà digitare: | Nel caso si voglia riconfigurare il modem, o aggiungerne un'altro si può digitare il seguente comando: |
| Linea 64: | Linea 56: |
| 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 69: | Linea 60: |
| L' utente verrà aggiunto nel file: {{{ /etc/hylafax/hosts.hfaxd |
Dove «nome_utente» va sostituito con il proprio nome utente e «password» con la propria password. == Comandi di controllo == Con il seguente comando è possibile controllare lo stato del fax server: {{{ faxstat -s |
| Linea 72: | Linea 67: |
== Comandi == [[Anchor(Fax_to_email_gateway)]] {{{ faxstat -s }}} Permette di controllare di controllare lo stato del fax server. {{{ |
Mentre per riavviare '''Hylafax''' digitare il seguente comando: {{{ |
| Linea 81: | Linea 69: |
| }}} Permette di riavviare Hylafax. Esistono dei moduli di controllo sviluppati per Usermin, Webmin e Nagios. Si possono trovare al seguente indirizzo: [[Anchor(Fax_to_email_gateway)]] [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] |
}}} |
| Linea 95: | Linea 73: |
---- |
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 }}} |
| Linea 101: | Linea 80: |
| 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 103: | Linea 82: |
| 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 ». Verranno utilizzati Dovecot e Procmail. |
| Linea 106: | Linea 85: |
| [[Anchor(alias)]] | |
| Linea 108: | Linea 88: |
| 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. {{{ |
'''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: {{{ |
| Linea 115: | Linea 93: |
| Linea 117: | Linea 94: |
Una volta che si è modificato il file `/etc/aliases` bisognerà comunicarlo a Postfix digitando il comando: {{{ |
Salvare e chiudere. Infine digitare in una finestra di terminale il seguente comando: {{{ |
| Linea 124: | Linea 99: |
| == Fax to email gateway [[Anchor(Fax_to_email_gateway)]] == | == Fax email gateway == |
| Linea 126: | 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 136: | Linea 108: |
| [[Anchor(Fax_to_email_gateway)]] | |
| Linea 140: | Linea 112: |
| Per ottenere questo risultato bisognerà modificare i seguenti file: | |
| Linea 142: | Linea 113: |
| 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 146: | Linea 115: |
| flags= user=fax argv=/usr/bin/faxmail -d -n ${user} | flags= user=fax argv=/usr/bin/faxmail -d -n ${user} # Rispettare il rientro ad inizio riga. |
| Linea 149: | Linea 118: |
| Rispettare il rientro alla riga `flags= ... ` 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 159: | 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 166: | Linea 127: |
| Digitare il comando: {{{ |
0. Infine digitare in una finestra di terminale i seguenti comandi: {{{ |
| Linea 170: | Linea 129: |
| }}} Riavviare Postfix: {{{ |
|
| Linea 180: | 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] | 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: |
| Linea 182: | Linea 137: |
| {{{ SENDTO=FaxMaster; FILETYPE=pdf; }}} |
|
| Linea 183: | Linea 142: |
| Dovecot | = Dovecot = |
| Linea 185: | Linea 144: |
| /etc/dovecot/dovecot.conf |
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 190: | Linea 148: |
| }}} | |
| Linea 191: | Linea 150: |
| Infine riavviare l' IMAP server digitando il seguente comando: {{{ | |
| Linea 192: | Linea 152: |
| }}} | |
| Linea 193: | Linea 154: |
| Procmailrc | = Procmail = |
| Linea 195: | Linea 156: |
| /etc/procmailrc | 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: {{{ |
| Linea 198: | Linea 159: |
| }}} | |
| Linea 205: | Linea 166: |
| * [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 Lista di desktop client] * [[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 su server Ubuntu, un programma per l'invio e la ricezione mezzo fax di documenti digitali di classe enterprise.
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 di Hylafax 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 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. 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.
No dialtone. |
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.
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
Nel caso si voglia riconfigurare il modem, o aggiungerne un'altro si può digitare il seguente comando:
faxaddmodem
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
Con il seguente comando è possibile controllare lo stato del fax server:
faxstat -s
Mentre per riavviare Hylafax digitare il seguente comando:
/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 ». Verranno utilizzati Dovecot e Procmail.
Alias
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:
postalias /etc/aliases
Fax email gateway
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 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 »
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
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:
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
Infine riavviare l' IMAP server digitando il seguente comando:
/etc/init.d/dovecot restart
Procmail
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:
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 Lista di desktop client]
[[http://www.hylafax.org/content/Management_Utilities Moduli di controllo]
