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 60 e 84 (in 24 versioni)
Versione 60 del 04/04/2009 14.50.33
Dimensione: 7418
Commento:
Versione 84 del 11/04/2009 16.07.13
Dimensione: 7747
Commento: prima impostazione
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 ==

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.

== 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: {{{
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: {{{
Linea 34: Linea 20:
}}} 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.
}}}
  Configurare il modem/fax, digitando nella riga di comando del ser
ver 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.
Linea 44: Linea 31:
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 48: Linea 36:
##No dialtone=???
Linea 49: Linea 38:
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 51: Linea 40:
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 53: Linea 42:
}}}

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 potrà digitare:
{{{
faxaddmodem
Linea 64: Linea 46:
Per permettere l'uso di Hylafax bisogna aggiungere gli utenti tramite il comando: Per permettere l'uso di '''Hylafax''' bisogna aggiungere gli utenti tramite il comando:
Linea 69: Linea 51:
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 55:
{{{ Con il seguente comando è possibile il controllare lo stato del fax server: {{{
Linea 77: Linea 57:
}}} Permette di controllare di controllare lo stato del fax server.

{{{
}}}
Mentre per riavviare '''Hylafax''' digitare il seguente comando: {{{
Linea 81: Linea 60:
}}} 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 64:

----
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 71:
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 73:
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 76:
[[Anchor(alias)]]
Linea 108: Linea 79:
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.

{{{
Per impostare l'utente abilitato all'invio dei fax, aprire con un [:Ufficio/EditorDiTesto:editor di testo] con i [:AmministrazioneSistema/Sudo:privilegi di amministrazione] il file `/etc/aliases` e inserire l'utente presente in `/etc/group`.
Mettere l'utente e la mail per l'invio dei fax come idicato: {{{
Linea 117: Linea 86:

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 91:
== Fax to email gateway [[Anchor(Fax_to_email_gateway)]] == == Fax email gateway ==
Linea 126: Linea 93:
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 100:
[[Anchor(Fax_to_email_gateway)]]
Linea 140: Linea 104:
Per ottenere questo risultato bisognerà modificare i seguenti file:
Linea 142: Linea 105:
  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 107:
  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 110:
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 114:
  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 119:
Digitare il comando:

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

Riavviare Postfix:

{{{
Linea 180: Linea 126:
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 129:
{{{
SENDTO=FaxMaster;
FILETYPE=pdf;
}}}
Linea 183: Linea 134:
Dovecot = Dovecot =
Linea 185: Linea 136:
/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 140:
}}}
Linea 191: Linea 142:
Infine riavviare l' IMAP server digitando il seguente comando: {{{
Linea 192: Linea 144:
}}}
Linea 193: Linea 146:
Procmailrc = Procmail =
Linea 195: Linea 148:
/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 151:
}}}
Linea 205: Linea 158:
 * [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

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

Permessi

Per permettere l'uso di Hylafax bisogna aggiungere gli utenti tramite il 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 il 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

Per impostare l'utente abilitato all'invio dei fax, aprire con un [:Ufficio/EditorDiTesto:editor di testo] con i [:AmministrazioneSistema/Sudo:privilegi di amministrazione] il file /etc/aliases e inserire l'utente presente in /etc/group. Mettere l'utente e la mail per l'invio dei fax come idicato:

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
    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


CategoryHomepage