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 49 e 89 (in 40 versioni)
Versione 49 del 04/04/2009 14.37.50
Dimensione: 7482
Commento:
Versione 89 del 12/04/2009 11.11.26
Dimensione: 8016
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 50: Linea 41:
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. 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 52: Linea 43:
Potrebbe essere utile modificare questo comportamento, aggiungendo il parametro « X3 » come nell' esempio seguente: {{{ 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 58: 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 65: 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 70: 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 73: Linea 67:

== Comandi di controllo == [[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 80: 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 94: 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 100: 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 102: 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 105: Linea 85:
[[Anchor(alias)]]
Linea 107: 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: {{{
Linea 114: Linea 92:
Linea 116: Linea 93:

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 123: Linea 98:
== Fax to email gateway [[Anchor(Fax_to_email_gateway)]] == == Fax email gateway ==
Linea 125: Linea 100:
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 135: Linea 107:
[[Anchor(Fax_to_email_gateway)]]
Linea 139: Linea 111:
Per ottenere questo risultato bisognerà modificare i seguenti file:
Linea 141: Linea 112:
  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 145: Linea 114:
  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 148: Linea 117:
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 158: Linea 121:
  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 165: Linea 126:
Digitare il comando:

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

Riavviare Postfix:

{{{
Linea 179: Linea 133:
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 181: Linea 136:
{{{
SENDTO=FaxMaster;
FILETYPE=pdf;
}}}
Linea 182: Linea 141:
Dovecot = Dovecot =
Linea 184: Linea 143:
/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 189: Linea 147:
}}}
Linea 190: Linea 149:
Infine riavviare l' IMAP server digitando il seguente comando: {{{
Linea 191: Linea 151:
}}}
Linea 192: Linea 153:
Procmailrc = Procmail =
Linea 194: Linea 155:
/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 197: Linea 158:
}}}
Linea 204: Linea 165:
 * [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:

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