Wiki Ubuntu-it

Indice
Partecipa
FAQ
Wiki Blog
------------------
Ubuntu-it.org
Forum
Chiedi
Chat
Cerca
Planet
  • Pagina non alterabile
  • Informazioni
  • Allegati
  • Differenze per "Server/HylaFax"
Differenze tra le versioni 61 e 90 (in 29 versioni)
Versione 61 del 04/04/2009 14.51.17
Dimensione: 7420
Commento:
Versione 90 del 12/04/2009 11.14.55
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 p 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.
Linea 75: Linea 64:
{{{ Con il seguente comando è possibile controllare lo stato del fax server: {{{
Linea 77: Linea 66:
}}} 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:

[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:
[[Anchor(Fax_to_email_gateway)]]
== Fax to email gateway ==
== Fax email gateway ==
Linea 127: 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 137: Linea 108:
[[Anchor(Fax_to_email_gateway)]]
Linea 141: Linea 112:
Per ottenere questo risultato bisognerà modificare i seguenti file:
Linea 143: 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 147: 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 150: 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 160: 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 167: Linea 127:
Digitare il comando:

{{{
 0. Infine digitare in una finestra di terminale i seguenti comandi: {{{
Linea 171: Linea 129:
}}}

Riavviare Postfix:

{{{
Linea 181: 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 183: Linea 137:
{{{
SENDTO=FaxMaster;
FILETYPE=pdf;
}}}
Linea 184: Linea 142:
Dovecot = Dovecot =
Linea 186: 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 191: Linea 148:
}}}
Linea 192: Linea 150:
Infine riavviare l' IMAP server digitando il seguente comando: {{{
Linea 193: Linea 152:
}}}
Linea 194: Linea 154:
Procmailrc = Procmail =
Linea 196: 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 199: Linea 159:
}}}
Linea 206: 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.

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.

Anchor(alias)

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.

Anchor(Fax_to_email_gateway)

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 »

  1. 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.
  2. 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 
  3. 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
  4. 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


CategoryHomepage