Differences between revisions 1 and 2
Revision 1 as of 2010-11-08 21:35:36
Size: 28202
Editor: ?skizzhg
Comment:
Revision 2 as of 2010-11-09 02:58:20
Size: 28216
Editor: ?skizzhg
Comment:
Deletions are marked like this. Additions are marked like this.
Line 91: Line 91:
  * You'll then be asked to confirm the values that you entered. Press '''Enter''' to accept them.
  * setupfaxmodem will now talk to the fax-modem to determine the best speed to talk to it, and the fax classes that it supports.
   * If this step fails, there is a likely a communication problem with your modem. Examine possible remedies in the '''Common Errors''' Section.
  * Even if your modem supports both Class 1 and Class 2 you should set it to Class 1 to ensure compatibility with all fax machines.
  * You will then be asked for values specific to the modem. Just press '''Enter''' to accept the default values as they are a result of the modem query and the class you selected. You'll then be prompted to confirm these values by pressing '''Enter.'''
  * The non-default scheduler values will then be displayed followed by a confirmation prompt.
   * Make sure all these values are correct. If they are not, answer '''No''' and correct any erroneous values.
   * Note that you may want to increase the time value for "Timeout when converting PostScript documents" if you fax long documents.
   * You can just press '''Enter''' to accept the default values.
  * assuming all of the above went smoothly, faxaddmodem will now return control to faxsetup, and you are done configuring your first modem.
 * If you are only configuring one fax-modem, answer '''no''' when asked if you want to configure another modem. Otherwise, answer '''yes''', and perform the above faxaddmodem related steps again.
 * Next, accept the default '''yes''' answer to run faxmodem on your newly configured modem to verify settings.
 * You should now be returned to the shell prompt.
 * If you want to manually edit the files that contain these settings, use your favorite editor on the 'config' and 'config.MODEMDEVICE' files in /etc/hylafax (where MODEMDEVICE is the device the modem is attached to)

 * Next we'll set up HylaFAX to run automatically when you boot the system. Use your favorite text editor to examine the contents of the /etc/default/hylafax configuration file.
 * Make sure there's no '''#''' character at the beginning of the line containing '''RUN_HYLAFAX=1.'''

Assuming the above steps went well, running '''/etc/init.d/hylafax restart''' should result in hylafax listening to the modem for incoming faxes, and allowing local command line fax sending.

= Sending a fax from the command line =

To test our newly installed fax server, we're going to send a text file to a remote fax machine.

To send a fax from the command line, run the following command:
{{{
sendfax -n -d <PHONENO> /etc/issue.net
}}}

where <PHONENO> is the phone number of a fax machine you can receive a fax at (that is not on the same phone line as your hylafax server).

assuming all went well, you should now have a fax waiting on you at the phone number you entered.

= Configuring Network Faxing =
Now we're going to let HylaFAX know who on the local network is allowed to send faxes. If you are not allowing local network users to use this fax server, you can skip this section.

== Access Controls ==
To allow users on the local network access to the fax server, you can use a subnet wide rule to let everyone use it, or select individual addresses.

 * Edit the '''/etc/hylafax/hosts.hfaxd''' file with your favorite text editor.
  * For example, if your using a network has addresses in the range 192.168.10.0, and your subnet is 255.255.255.0, you would enter the following line into the hosts.hfaxd file:

  * Verrà quindi chiesto di confermare i valori inseriti, premere '''invio''' per accettare.
  * setupfaxmodem dialogherà ora con il modem fax per determinare la velocità migliore per comunicare con esso e le classi fax che gestisce.
   * Se questo passaggio non riesce vi è un probabile problema di comunicazione con il modem, esaminare i rimedi possibili nella sezione '''Errori comuni'''.
  * Anche se il modem supporta sia la Classe 1 che la Classe 2, andrebbe impostato in Classe 1 per assicurare la compatibilità con tutte le macchine fax.
  * Verranno ora richiesti valori specifici per il modem, basta premere '''invio''' per accettare i predefiniti in quanto sono il risultato dell'interrogazione al modem e la classe selezionata.
  * Verranno visualizzati i valori di schedulazione non predefiniti seguiti da una richiesta di conferma.
   * Assicurarsi che siano corretti, se non lo sono rispondere '''No''' e correggerli.
   * Si noti che è possibile aumentare il valore di "Timeout durante la conversione di documenti PostScript" se si inviano documenti lunghi.
   * Premere semplicemente '''invio''' per accettare i valori predefiniti.
  * Assumendo che tutto quanto sopra descritto è andato a buon fine faxaddmodem restituirà ora il controllo a faxsetup, la configurazione del primo modem è terminata.
 * Se si sta configurando solo un modem fax, rispondere '''No''' alla richiesta di configurarne un altro; in caso contrario rispondere '''yes''' ed eseguire nuovamente i passi sopra descritti relativi a faxaddmodem.
 * Per verificare le impostazioni accettare la risposta predefinita '''yes''' per eseguire faxmodem sul modem appena configurato.
 * Si dovrebbe ora tornare al prompt shell.
 * Se si desidera modificare manualmente i file che contengono queste impostazioni, utilizzare il proprio editor preferito sui file "config" e "config.MODEMDEVICE" in {{{/etc/hylafax}}} (dove MODEMDEVICE è il device al quale il modem è connesso).
 * Configurare HylaFAX affinché venga eseguito automaticamente all'avvio del sistema, esaminare il contenuto del file {{{/etc/default/hylafax}}}.
 * Assicurarsi che non ci siano caratteri '''#''' all'inizio della riga che contiene '''RUN_HYLAFAX=1.'''

Se tutto è andato bene, l'esecuzione di '''/etc/init.d/hylafax restart''' dovrebbe dare come risultato che hylafax ascolti il modem per i fax in entrata, permettendo l'invio di fax da riga di comando.

= Invio di un fax da linea di comando =

Per testare il fax server appena installato si invierà un file di testo a un apparecchio fax remoto.

Per inviare un fax dalla riga di comando, eseguire il seguente comando:
{{{
sendfax -n -d <NUMEROTEL> /etc/issue.net
}}}

dove <NUMEROTEL> è il numero telefonico dell'apparecchio fax su cui si può ricevere un fax (che non è sulla stessa linea telefonica del server hylafax).

se ha funzionato correttamente si dovrebbe avere un fax in attesa sul numero inserito nel comando.

= Configurazione della rete fax =

Si farà in modo che HylaFAX sappia chi sulla rete locale è autorizzato a inviare fax, se non si intende consentire l'utilizzo del server agli utenti della rete locale è possibile ignorare questa sezione.

== Controlli di accesso ==

Per permettere l'accesso agli utenti sulla rete locale è possibile utilizzare una regola estesa di sottorete per consentire l'uso a tutti oppure selezionare singoli indirizzi.

 * Modificare il file '''/etc/hylafax/hosts.hfaxd''' con un editor.
  * Ad esempio, se si usa una rete con indirizzi nel range 192.168.10.0 e la sottorete è 255.255.255.0, inserire la seguente direttiva:
Line 135: Line 137:
  * Likewise, if your using a network containing addresses in the range 172.16.0.0, and your subnet is 255.255.0.0, your hosts.hfaxd file entry would be:   * Allo stesso modo se si usa una rete con indirizzi nel range 172.16.0.0 e la sottorete è 255.255.0.0, la voce sarebbe:
Line 140: Line 142:
 * You can enter as "wide" of a network address as you like, or multiple narrower address entries. If you'd like to restrict access to specific users you can enter their individual IP addresses. When done, save the file and exit the editor.

After editing this file, it is necessary to re-start the hylafax server by issuing the command '''/etc/init.d/hylafax restart'''

== Creating Users ==

For each user on the network you want to print to your fax server, you need a user on your system
 * Si possono inserire sia range di indirizzi che indirizzi multipli mirati, se si desidera limitare l'accesso a utenti specifici si possono inserire i loro indirizzi IP individuali. Al termine salvare il file e uscire dall'editor.

Riavviare il server hylafax con il comando '''/etc/init.d/hylafax restart'''-

== Creazione di utenti ==

È necessario creare un utente sul sistema per ogni utente della rete al quale si desidera far usare il server fax:
Line 150: Line 152:
 *Fill in the username and password, etc
 *Then add user to hylafax. First find out what is your new user UID
 * Inserire nome utente e password
 * Aggiungere quindi l'utente a hylafax, scoprendo prima qual è l'UID del nuovo utente:
Line 155: Line 157:
 *Find your user. It should be something like '''dept1:x:1001:''' so this user UID is 1001
 *Now tell hylafax about it
{{{
faxadduser -p password -u 1001 username
}}}

= Configuring Fax to Email =

To route incoming faxes to a destination other than sitting in the recvq, we're going to create a FaxDispatch script in /etc/hylafax.

== Fax Dispatch ==
 * Fax dispatch is a custom script that one can create for Hylafax to specify nonstandard delivery options. Normally, incoming faxes are dropped into the /var/spool/hylafax/recvq/ directory.
 * Sample Fax Dispatch file might look like this: http://www.infocopter.com/know-how/hylafax/fax-dispatch.html (broken link). Can retrive it from: http://web.archive.org/web/20080531000241/http://www.infocopter.com/know-how/hylafax/fax-dispatch.html
 * Use your favorite text editor to create a '''/etc/hylafax/FaxDispatch''' file containing the following:

 * Dovrebbe essere qualcosa come '''dept1:x:1001:''', perciò l'UID sarà 1001.
 * Comunicarlo ora a hylafax:
{{{
faxadduser -p password -u 1001 nome_utente
}}}

= Configurazione di fax a email =

Si creerà ora uno script !FaxDispatch in {{{/etc/hylafax}}} per indirizzare i fax in entrata a una destinazione diversa che risiedere in recvq.

== !FaxDispatch ==

 * !FaxDispatch è uno script personalizzato che si può creare per Hylafax per specificare le opzioni di consegna non standard, normalmente i fax in entrata vengono inseriti nella directory {{{/var/spool/hylafax/recvq/}}}.
 * Un esempio di file !FaxDispatch potrebbe somigliare a questo: http://www.infocopter.com/know-how/hylafax/fax-dispatch.html (collegamento non funzionante, recuperabile [[http://web.archive.org/web/20080531000241/http://www.infocopter.com/know-how/hylafax/fax-dispatch.html|qui]].
 * Creare un file '''/etc/hylafax/FaxDispatch''' contenente questo:
Line 175: Line 179:
SENDTO=myemail@emailaddy.com; SENDTO=mia_email@mio_dominio.com;
Line 179: Line 183:
Please note that using filetypes other than tiff are allowed, but tiff is the native language spoken by the fax system, and therefore requires the least ammount of work to handle, on the fax server.

= Automatically Printing Incoming Faxes =
 * If you would like to print and then move incoming faxes out of the /var/spool/hylafax/recvq/ directory, you would create a FaxDispatch file this below:
Si noti che sono consentiti tipi di file diversi da tiff ma questo è il formato nativo usato dal sistema di fax, pertanto richiede minor quantità di lavoro da gestire sul server.

= Stampare automaticamente fax in entrata =

 * Se si desidera stampare e quindi spostare i fax in arrivo fuoiri dalla directory {{{/var/spool/hylafax/recvq/}}}, si può creare un file !FaxDispatch come questo:
Line 188: Line 193:
ttyS14) /usr/bin/tiff2ps -w 8.5 -h 11 -a $FILE |lpr -P kyocera; mv $FULLPATH /var/spool/hylafax/recvq/dept1/;; # all faxes received on ttyS14
ttyS15) /usr/bin/tiff2ps -w 8.5 -h 11 -a $FILE |lpr -P kyocera; mv $FULLPATH /var/spool/hylafax/recvq/dept2/;; # all faxes received on ttyS15
ttyS14) /usr/bin/tiff2ps -w 8.5 -h 11 -a $FILE |lpr -P kyocera; mv $FULLPATH /var/spool/hylafax/recvq/dept1/;; # tutti i fax ricevuti su ttyS14
ttyS15) /usr/bin/tiff2ps -w 8.5 -h 11 -a $FILE |lpr -P kyocera; mv $FULLPATH /var/spool/hylafax/recvq/dept2/;; # tutti i fax ricevuti su ttyS15
Line 193: Line 198:
Please note that specifying the size of a page is recommended to make sure 11x14 pages are printed properly.

= Viewing faxes through internet browser =
 * To do that install apache web server
Notare che specificare le dimensioni di una pagina è consigliato per assicurarsi che le pagine 11x14 vengano stampate in modo corretto.

= Visualizzare fax tramite un browser internet =

 * Per questo si installi il server web apache
Line 201: Line 207:
 *Now add a link to your faxes
 * Aggiungere un collegamento alla directory dei fax:
Line 206: Line 213:
 * Now open a broswer and go to '''http://localhost/fax/''', or by your ip address http://10.10.10.10/fax

= Fax Sending Clients =
In general the list of all the software is here, but you can just go to the following URL.
http://www.hylafax.org/content/Client_Software

 * Ora aprire il broswer all'indirizzo http://localhost/fax/ o con il proprio indirizzo IP http://10.10.10.10/fax

= Client di invio fax =

La lista di tutti i software è al seguente indirizzo: http://www.hylafax.org/content/Client_Software
Line 213: Line 221:
You can use Gfax or Kde Print Fax. You install it Gfax by: Si può usare Gfax o Kde Print Fax. Gfax è installabile con:
Line 218: Line 226:
Then Go to '''Application''' then '''Office''' then Gfax.
 *This needs to be tested but:
{{{
Now i can do fax from OpenOffice, TextEditor, etc..

1. Install GFax from apt-get install gfax
2. Configure GFax with your Fax Server (HylaFAX).. I hope you know how to do it..
   Ok, you can test your GFax configuration by test send a fax with Text Editor (Applications -
Accessories)
3. To make it work with openoffice, run /usr/lib/openoffice/program/spadmin (with root access), you
 do sudo -i, or whatever.
4. You add fax / pdf converter from spadmin GUI, fill the command with: gfax (TMP)
5. That's it... you save the configuration
6. Try fax an openoffice document

1st time i try fax with Fax Printer, it hang..
then i tried fax with PDF Converter and set the PDF Folder, then after fax, i close the GFax and not
hang.
}}}

Quindi andare nel menu '''Applicazioni''' > '''Ufficio''' > Gfax.
 * Questo necessita di essere testato:
{{{
Spedire fax da OpenOffice, TextEditor, ecc.

1. Installare GFax (apt-get install gfax)
2. Configurarlo con il server fax (HylaFAX); si può provare la configurazione di GFax inviando un fax con TextEditor (Applicazioni > Accessori)
3. Per OpenOffice eseguire {{{/usr/lib/openoffice/program/spadmin}}} da root
4. Dalla GUI di spadmin aggiungere un convertitore fax/pdf e inserire gfax come comando
5. Salvare la configurazione
6. Provare a spedire un documento OpenOffice via fax

L'invio con Fax Printer non ha funzionato, mentre con il convertitore PDF e impostando una cartella PDF non si è bloccato.
}}}
Line 238: Line 243:
 * On windows you would use this Win print Hylafax software. You can download it at http://winprinthylafax.sourceforge.net/
 *'''ADMINISTRATION''':Download program called '''WHFC''' which will tell you the status of the hylafax servers.

= Known Working Hardware =

== Serial Modems ==
 1. US Robotics 56K External Fax Modem; 5686E (Does not come with cable)

 * Su windows si può usare il software Winprint HylaFAX, scaricabile all'indirizzo http://winprinthylafax.sourceforge.net/
 *'''AMMINISTRAZIONE''': Scaricare il programma chiamato '''WHFC''' che notificherà lo stato del server hylafax.

= Hardware conosciuto come funzionante =

== Modem seriali ==
 1. US Robotics 56K External Fax Modem; 5686E (fornito senza cavo)
Line 246: Line 252:
 1. Amigo AME-CA95, External V.92 DATA/FAX/TAM Modem -(newegg.com)

== Multiport Serial Adapters ==
 1. Amigo AME-CA95, External V.92 DATA/FAX/TAM Modem - (newegg.com)

== Adattatori seriali multiporta ==
Line 252: Line 258:
== USB Modem ==
Link that sells the USB modem (sorry it's in greek, I couldn't find any other site for it):
== Modem USB ==

Sito web che vende il modem USB (in greco):
Line 256: Line 263:
lsusb recognizes it as: {{{ lsusb lo riconosce come:
{{{
Line 262: Line 270:
The driver known to work with it is the 'slusb' !SmartLink driver, see [[slmodem]].

The modem is installed under {{{/dev/ttySL0}}}. Special Hylafax configuration does not appear to be necessary.
Il driver funzionante è lo "slusb" !SmartLink, vedere [[it/slmodem|slmodem]].

Il modem viene installato sotto {{{/dev/ttySL0}}}, non sembra necessaria alcuna configurazione particolare per Hylafax.

Translation(s): English - Italiano

(!) ?Discussion


HylaFAX, un server fax open source avanzato.

Basato su http://lucasmanual.com/mywiki/FaxServer e http://www.aboutdebian.com/fax.htm

Installazione

apt-get install hylafax-server
  • Assicurarsi che il modem sia connesso, i modem esterni possono essere collegati tramite porta seriale o USB (quando si utilizza un convertitore seriale USB).

Configurazione iniziale

Per iniziare la configurazione di hylafax eseguire l'utilità faxsetup.

faxsetup
  • Premendo invio si vedrà parecchio testo, faxsetup controlla le impostazioni di sistema.
  • Supponendo che non ci siano errori verrà visualizzato un menu simile al seguente:

        HylaFAX configuration parameters are:

        [1] Init script starts faxq:            yes
        [2] Init script starts hfaxd            yes
        [3] Start old protocol:                 no
        [4] Start paging protocol:              no
Are these ok [yes]? 
  • premere invio per rispondere yes

  • faxsetup creerà alcuni file di configurazione e chiederà il permesso di arrestare il processo faxq.

Modem support functions written to /var/spool/hylafax/etc/setup.modem.
Configuration parameters written to /var/spool/hylafax/etc/setup.cache.

Restarting HylaFAX server processes.

You have a HylaFAX scheduler process running.  faxq will be
restarted shortly, as soon as some other work has been completed.
Can I terminate this faxq process (24932) [yes]? 
  • Premere invio per rispondere yes

  • faxsetup chiederà il permesso di riavviare il processo hylafax server, premere invio per rispondere yes

  • Dal momento che non è ancora stato configurato un modem, faxsetup chiederà di eseguire "faxaddmodem", premere invio per rispondere yes

    • Inserire il nome del device di porta seriale al quale è collegato il modem-fax (assicurarsi che il modem sia collegato alla porta seriale e non alla parallela). Suggerimento: ttyS0 è per la prima porta seriale (COM1 sotto Windows/DOS) e ttyUSB0 è il primo adattatore USB-seriale.
    • Verranno ora richiesti alcuni valori, per la maggior parte di essi è possibile accettare i predefiniti premendo invio. I valori da inserire sono:

        * Prefisso della nazione (1 per gli USA)
        * Prefisso della regione (inserire quello della propria zona)
        * Numero telefonico del modem fax (nel formato +1.xxx.xxx.xxxx, per gli USA)
        * Stringa di identificazione locale (dovrebbe essere qualcosa di simile a 'Mio Server Fax' che verrà stampato sulla citazione dei fax in uscita)
        * Prefisso a lunga distanza (1 negli USA)
        * Prefisso internazionale (011 negli USA)
        * File di regole di composizione (accettare il predefinito)
        * Tracciamento durante le normali operazioni server (accettare il predefinito)
        * Tracciamento durante le operazioni di invio e ricezione (accettare il predefinito)
  • I prossimi valori hanno a che fare con i permessi di alcuni file creati. Per un fax al gateway di posta le impostazioni predefinite sono accettabili, ma se si desidera condividere i file della coda fax direttamente con un server FTP o HTTP sono necessarie altre autorizzazioni.
  • Continuare a inserire valori:

        * Modalità di protezione per fax ricevuti - se si desidera condividere i file direttamente inserire 0644, altrimenti accettare l'impostazione predefinita 0600 
        * Modalità di protezione per la sessione dei registri - se si desidera condividere i file direttamente inserire 0644, altrimenti accettare l'impostazione predefinita 0600
        * Modalità di protezione per ttySx - per condividere il modem inserire 0666, 0600 se lo si utilizza solo con hylafax
        * Numero di squilli prima di rispondere - il valore predefinito è 1, impostarlo a 0 configura il server come un sistema fax di "solo invio"
        * Volume dell'altoparlante del modem, i valori validi sono OFF QUIET LOW MEDIUM HIGH, lo si può impostare su HIGH per fare delle prove e cambiarlo in OFF successivamente)
        * Argomenti da riga di comando per il programma getty (accettare il predefinito)
        * Percorso del file di controllo degli accessi TSI (accettare il predefinito)
        * Percorso del file di controllo degli accessi Caller-ID (accettare il predefinito)
        * File del carattere della citazione (accept the default)
        * Stringa del formato della citazione (accept the default)
        * Tempo prima di eliminare un file UUCP interrotto e bloccato (accettare il predefinito)
        * Mantenere un file di lock UUCP durante le chiamate dati in entrata (accettare il predefinito)
        * Mantenere un file di lock UUCP durante le chiamate vocali in entrata (accettare il predefinito)
        * Percentuale di linee valide da accettare durante il controllo qualità della copia (accettare il predefinito)
        * Numero massimo di linee non valide da accettare durante il controllo qualità della copia (si consiglia di ridurre il valore predefinito da 5 a 3)
        * Numero massimo di pagine da accettare in un fax ricevuto (si consiglia di aumentare il valore predefinito a 25)
        * Nome del servizio syslog per i messaggi di tracciamento del server (il predefinito è "daemon" ma lo si può cambiare in "local7" se si invia il registro ad un server syslog remoto e si vuole separare il registro dei fax da altri messaggi)
        * Imposta l'UID a 0 per gestire CLOCAL (accettare il predefinito)
        * Usa il meccanismo di schedulazione disponibile per la priorità dei compiti (accettare il predefinito)
  • Verrà quindi chiesto di confermare i valori inseriti, premere invio per accettare.

  • setupfaxmodem dialogherà ora con il modem fax per determinare la velocità migliore per comunicare con esso e le classi fax che gestisce.
    • Se questo passaggio non riesce vi è un probabile problema di comunicazione con il modem, esaminare i rimedi possibili nella sezione Errori comuni.

  • Anche se il modem supporta sia la Classe 1 che la Classe 2, andrebbe impostato in Classe 1 per assicurare la compatibilità con tutte le macchine fax.
  • Verranno ora richiesti valori specifici per il modem, basta premere invio per accettare i predefiniti in quanto sono il risultato dell'interrogazione al modem e la classe selezionata.

  • Verranno visualizzati i valori di schedulazione non predefiniti seguiti da una richiesta di conferma.
    • Assicurarsi che siano corretti, se non lo sono rispondere No e correggerli.

    • Si noti che è possibile aumentare il valore di "Timeout durante la conversione di documenti ?PostScript" se si inviano documenti lunghi.

    • Premere semplicemente invio per accettare i valori predefiniti.

  • Assumendo che tutto quanto sopra descritto è andato a buon fine faxaddmodem restituirà ora il controllo a faxsetup, la configurazione del primo modem è terminata.
  • Se si sta configurando solo un modem fax, rispondere No alla richiesta di configurarne un altro; in caso contrario rispondere yes ed eseguire nuovamente i passi sopra descritti relativi a faxaddmodem.

  • Per verificare le impostazioni accettare la risposta predefinita yes per eseguire faxmodem sul modem appena configurato.

  • Si dovrebbe ora tornare al prompt shell.
  • Se si desidera modificare manualmente i file che contengono queste impostazioni, utilizzare il proprio editor preferito sui file "config" e "config.MODEMDEVICE" in /etc/hylafax (dove MODEMDEVICE è il device al quale il modem è connesso).

  • Configurare HylaFAX affinché venga eseguito automaticamente all'avvio del sistema, esaminare il contenuto del file /etc/default/hylafax.

  • Assicurarsi che non ci siano caratteri # all'inizio della riga che contiene RUN_HYLAFAX=1.

Se tutto è andato bene, l'esecuzione di /etc/init.d/hylafax restart dovrebbe dare come risultato che hylafax ascolti il modem per i fax in entrata, permettendo l'invio di fax da riga di comando.

Invio di un fax da linea di comando

Per testare il fax server appena installato si invierà un file di testo a un apparecchio fax remoto.

Per inviare un fax dalla riga di comando, eseguire il seguente comando:

sendfax -n -d <NUMEROTEL> /etc/issue.net

dove <NUMEROTEL> è il numero telefonico dell'apparecchio fax su cui si può ricevere un fax (che non è sulla stessa linea telefonica del server hylafax).

se ha funzionato correttamente si dovrebbe avere un fax in attesa sul numero inserito nel comando.

Configurazione della rete fax

Si farà in modo che HylaFAX sappia chi sulla rete locale è autorizzato a inviare fax, se non si intende consentire l'utilizzo del server agli utenti della rete locale è possibile ignorare questa sezione.

Controlli di accesso

Per permettere l'accesso agli utenti sulla rete locale è possibile utilizzare una regola estesa di sottorete per consentire l'uso a tutti oppure selezionare singoli indirizzi.

  • Modificare il file /etc/hylafax/hosts.hfaxd con un editor.

    • Ad esempio, se si usa una rete con indirizzi nel range 192.168.10.0 e la sottorete è 255.255.255.0, inserire la seguente direttiva:

192\.168\.10\.:::
  • Allo stesso modo se si usa una rete con indirizzi nel range 172.16.0.0 e la sottorete è 255.255.0.0, la voce sarebbe:

172\.16\.:::
  • Si possono inserire sia range di indirizzi che indirizzi multipli mirati, se si desidera limitare l'accesso a utenti specifici si possono inserire i loro indirizzi IP individuali. Al termine salvare il file e uscire dall'editor.

Riavviare il server hylafax con il comando /etc/init.d/hylafax restart-

Creazione di utenti

È necessario creare un utente sul sistema per ogni utente della rete al quale si desidera far usare il server fax:

adduser dept1
  • Inserire nome utente e password
  • Aggiungere quindi l'utente a hylafax, scoprendo prima qual è l'UID del nuovo utente:

cat /etc/group
  • Dovrebbe essere qualcosa come dept1:x:1001:, perciò l'UID sarà 1001.

  • Comunicarlo ora a hylafax:

faxadduser -p password -u 1001 nome_utente

Configurazione di fax a email

Si creerà ora uno script FaxDispatch in /etc/hylafax per indirizzare i fax in entrata a una destinazione diversa che risiedere in recvq.

!FaxDispatch

  • FaxDispatch è uno script personalizzato che si può creare per Hylafax per specificare le opzioni di consegna non standard, normalmente i fax in entrata vengono inseriti nella directory /var/spool/hylafax/recvq/.

  • Un esempio di file FaxDispatch potrebbe somigliare a questo: http://www.infocopter.com/know-how/hylafax/fax-dispatch.html (collegamento non funzionante, recuperabile qui.

  • Creare un file /etc/hylafax/FaxDispatch contenente questo:

## FaxDispatch file - routes all inbound faxes to myemail@emailaddy.com as TIFF files
##
## Consult the faxrcvd(8C) man page for more information
##

SENDTO=mia_email@mio_dominio.com;
FILETYPE=tiff;

Si noti che sono consentiti tipi di file diversi da tiff ma questo è il formato nativo usato dal sistema di fax, pertanto richiede minor quantità di lavoro da gestire sul server.

Stampare automaticamente fax in entrata

  • Se si desidera stampare e quindi spostare i fax in arrivo fuoiri dalla directory /var/spool/hylafax/recvq/, si può creare un file FaxDispatch come questo:

## and/or by device
FOLDER="/var/spool/hylafax/recvq/"
FULLPATH="${FOLDER}${FILENAME}.tif"
case "$DEVICE" in
ttyS14)   /usr/bin/tiff2ps -w 8.5 -h 11 -a $FILE |lpr -P kyocera; mv $FULLPATH /var/spool/hylafax/recvq/dept1/;;    # tutti i fax ricevuti su ttyS14
ttyS15)   /usr/bin/tiff2ps -w 8.5 -h 11 -a $FILE |lpr -P kyocera; mv $FULLPATH /var/spool/hylafax/recvq/dept2/;;    # tutti i fax ricevuti su ttyS15
esac

Notare che specificare le dimensioni di una pagina è consigliato per assicurarsi che le pagine 11x14 vengano stampate in modo corretto.

Visualizzare fax tramite un browser internet

  • Per questo si installi il server web apache

apt-get update
apt-get install apache2
  • Aggiungere un collegamento alla directory dei fax:

cd /var/www
ln -s /var/spool/hylafax/recvq fax

Client di invio fax

La lista di tutti i software è al seguente indirizzo: http://www.hylafax.org/content/Client_Software

Linux

Si può usare Gfax o Kde Print Fax. Gfax è installabile con:

apt-get update
apt-get install gfax

Quindi andare nel menu Applicazioni > Ufficio > Gfax.

  • Questo necessita di essere testato:

Spedire fax da OpenOffice, TextEditor, ecc.

1. Installare GFax (apt-get install gfax)
2. Configurarlo con il server fax (HylaFAX); si può provare la configurazione di GFax inviando un fax con TextEditor (Applicazioni > Accessori)
3. Per OpenOffice eseguire {{{/usr/lib/openoffice/program/spadmin

da root4. Dalla GUI di spadmin aggiungere un convertitore fax/pdf e inserire gfax come comando 5. Salvare la configurazione 6. Provare a spedire un documento OpenOffice via fax

L'invio con Fax Printer non ha funzionato, mentre con il convertitore PDF e impostando una cartella PDF non si è bloccato. }}}

Windows

  • Su windows si può usare il software Winprint HylaFAX, scaricabile all'indirizzo http://winprinthylafax.sourceforge.net/

  • AMMINISTRAZIONE: Scaricare il programma chiamato WHFC che notificherà lo stato del server hylafax.

Hardware conosciuto come funzionante

Modem seriali

  1. US Robotics 56K External Fax Modem; 5686E (fornito senza cavo)
  2. USRobotics Courier V.Everything External Fax Modem
  3. Amigo AME-CA95, External V.92 DATA/FAX/TAM Modem - (newegg.com)

Adattatori seriali multiporta

  1. Startech.com 4 Multi Port Serial PCI Card
  2. Startech.com 2 Port Serial PCI Card

Modem USB

Sito web che vende il modem USB (in greco): http://www.e-shop.gr/show_per.phtml?id=PER.533709

lsusb lo riconosce come:

Bus 001 Device 002: ID 0483:7554 SGS Thomson Microelectronics 56k SoftModem
  idVendor           0x0483 SGS Thomson Microelectronics
  idProduct          0x7554 56k SoftModem

Il driver funzionante è lo "slusb" SmartLink, vedere slmodem.

Il modem viene installato sotto /dev/ttySL0, non sembra necessaria alcuna configurazione particolare per Hylafax.

Adding a Dial Prefix

To configure HylaFax to dial a number and pause before dialing the requested number, use your favorite text editor to add the following line to your config.<DEVICE> files:

ModemDialCmd: ATDT9,%s
  • Pause: The comma (,) dial modifier causes the modem to pause while dialing ATD9,17731231234

  • Pause and wait for dial tone: The W causes most modems to wait for a dial tone before dialing the number following it. ATDT 9 W 17731231234

  • Final Modem Dial Command on the system could look like this:

ModemDialCmd: ATDT9,W%s
  • 9 says dial 9; comma says wait; W says wait for dial tone; %s says dial this number
  • If you experience no dial tone in your logs try something like:

ModemDialCmd:     ATX3DT8,,,%s

AT - picks up the phone, X3- disables dial tone check, DT tells it to use tone, dial 8, then ",,," for wait, then the phone number.

Multiple Incoming Fax Lines

Configuring a multi-port serial PCI card

  • There's really no limit to the number of serial cards Linux can support, but there is a kernel configuration parameter for the number of supported serial ports.(CONFIG_SERIAL_8250_NR_UARTS)
  • Currently the limit in Debian supported ports is 4. (read on for more then 4 port support)
  • So if you have a 2 port serial card you want to add to your pc, here is what you do.
  • If you connect more modems or when you buy a serial pci card you will want to know which ttyS port they are using. You can do it by :

dmesg |grep tty
  • You should see something like:

faxserver:~# dmesg |grep ttyS
ttyS0 at I/O 0x3f8 (irq = 4) is a 16550A
ttyS14 at I/O 0xdf08 (irq = 209) is a 16550A
ttyS15 at I/O 0xdf10 (irq = 209) is a 16550A
  • If you installed another serial pci card (2 port or 4 port), you can see if it was detected by typing:

lspci -v

This should list something like:

0000:02:00.0 Serial controller: NetMos Technology PCI 9835 Multi-I/O Controller (rev 01) (prog-if 02 [16550])
        Subsystem: LSI Logic / Symbios Logic 2S (16C550 UART)
        Flags: medium devsel, IRQ 209
        I/O ports at df08 [size=8]
        I/O ports at df10 [size=8]
        I/O ports at df18 [size=8]
        I/O ports at df20 [size=8]
        I/O ports at df28 [size=8]
        I/O ports at df30 [size=16]
  • As you can see the IRQ should be the same as the one specified in dmesg.
  • Install setserial. This program will let you control serial port better.

apt-get update
apt-get install setserial
  • Then try:

setserial -g /dev/ttyS*
  • If you don't see a ttyS#(ex. ttyS14) in /dev/ you will need to create ttyS14 device.

ls /dev/ttyS*
  • So in my case I am missing ttyS14, ttyS15 in /dev/ folder

MAKEDEV ttyS14
MAKEDEV ttyS15
  • Now run setserial -g /dev/ttyS* again and you should see your new serial ports.

  • Plug in your modems and Run:

faxaddmodem
  • Select the new ttyS and you are done setting up multiple fax machines.

FaxNotify

  • When fax fails to send, user gets an email notifying of a failure. Default is to just sent an email with a job number. To make sure they get a copy of what they actually sent we need to add ?FaxNotify to /etc/hylafax.

  • Create FaxNotify in /etc/hylafax/

  • Inside put

RETURNFILETYPE=tiff;

Common Errors

Minicom works, but faxaddmodem does not see a modem

  • Minicom automatically uses an init string that turns Numeric Result Codes off (ATV1). If you have an US Robotics Courier V.Everything External, check the position of jumper switch #2.

Failure to receive silence

Class1SwitchingCmd: "<delay:7>"

T.30 T2 timeout, expected signal not received

  • Switching to calls 1, and adding the "delay" will solve the problem.
  • Run the faxaddmodem command again and add the delay.

Unspecified Phase C error, including too much delay between TCF and +FDR command

  • Switching to Class 1 solved the problem.

No Dial Tone

No carrier Detected

  • Adding longer wait has solved the problem of no dial tone, but you might still get the no carrier detected. Look into logs to determine if this is the case in your setup. See if these are busy signal. For some reason busy signal gets labeled as no carrier detected.

cat /var/spool/hylafax/log/xferfaxlog

Modem Wedged

After a month of good work (11,000 faxes) suddenly the modem become wedged. Because USR modem doesn't have the un-wedged option as the Mainpine modem, you have to tell hylafax to try to set it up more then (default)2 times. Add this to your config.tty#

MaxSetupAttempts:    10

4 ports serial card, more then 4 modem support

  • There's really no limit to the number of serial cards Linux can support, but there is a kernel configuration parameter for the number of supported serial ports.(CONFIG_SERIAL_8250_NR_UARTS)
  • To find out how many serial port your kernel is configured for do:

dmesg |grep Serial
  • And look for line like:

 Serial: 8250/16550 driver $Revision: 1.90 $ 4 ports, IRQ sharing enabled
  • Shows that the driver is compiled to support only 4 ports.
  • I was getting following logs which I will include here for reference.

serial8250: ttyS2 at I/O 0x3e8 (irq = 4) is a 16550A
 00:08: ttyS2 at I/O 0x3e8 (irq = 4) is a 16550A
 0000:05:04.0: ttyS0 at I/O 0x1010 (irq = 201) is a 16550A
 0000:05:04.0: ttyS1 at I/O 0x1018 (irq = 201) is a 16550A
 0000:05:04.0: ttyS3 at I/O 0x1020 (irq = 201) is a 16550A

Couldn't register serial port 0000:05:04.0: -28

shows that ttyS2 is on the motherboard.  ttyS0, S1, and S3 are
on the 9845 card.  The driver found the fourth port on the 9845 card,
but couldn't use it because all four ports (ttyS0-ttyS3) were already
in use (that's what the "-28" error means).
  • You can list your pci cards by doing the following. This will show you all pci cards. Look for the one that mentions serial

lspci -v
  • These are mine:

 2 port:
 02:00.0 Serial controller: NetMos Technology PCI 9835 Multi-I/O
 Controller (rev 01) (prog-if 02 [16550])
         Subsystem: LSI Logic / Symbios Logic 2S (16C550 UART)
         Flags: medium devsel, IRQ 209
         I/O ports at df08 [size=8]
         I/O ports at df10 [size=8]
         I/O ports at df18 [size=8]
         I/O ports at df20 [size=8]
         I/O ports at df28 [size=8]
         I/O ports at df30 [size=16]


 4 port:
 02:02.0 Serial controller: Unknown device 9310:9845 (rev 01) (prog-if 02
 [16550])
         Subsystem: LSI Logic / Symbios Logic Unknown device 0004
         Flags: medium devsel, IRQ 201
         I/O ports at 1000 [size=8]
         I/O ports at 1008 [size=8]
         I/O ports at 1010 [size=8]
         I/O ports at 1018 [size=8]
         I/O ports at 1020 [size=8]
         I/O ports at 1030 [size=16]
  • Lets add a more serial ports to our system. We do it by adding the 8250.nr_uarts=16 at end of kopt line in the grub menu configuration file.

  • Edit /boot/grub/menu.lst and change the following lines by adding the 8250.nr_uarts=16 at the end of kopt.

## DO NOT UNCOMMENT THEM, Just edit them to your needs

## ## Start Default Options ##
## default kernel options
## default kernel options for automagic boot options
## If you want special options for specific kernels use kopt_x_y_z
## where x.y.z is kernel version. Minor versions can be omitted.
## e.g. kopt=root=/dev/hda1 ro
##      kopt_2_6_8=root=/dev/hdc1 ro
##      kopt_2_6_8_2_686=root=/dev/hdc2 ro
# kopt=root=/dev/sda1 ro 8250.nr_uarts=16
  • Then

update-grub
  • Reboot
  • When you log in run the command:

setserial -g /dev/ttyS*
  • This will show you list of all serial ports addresses and corresponding ttyS
  • Mine looks like:

faxserver:/home/lucas# setserial -g /dev/ttyS*
/dev/ttyS0, UART: 16550A, Port: 0x03f8, IRQ: 4
/dev/ttyS1, UART: 16550A, Port: 0x1010, IRQ: 201
/dev/ttyS10, UART: unknown, Port: 0x0000, IRQ: 0
/dev/ttyS11, UART: unknown, Port: 0x0000, IRQ: 0
/dev/ttyS12, UART: unknown, Port: 0x0000, IRQ: 0
/dev/ttyS13, UART: unknown, Port: 0x0000, IRQ: 0
/dev/ttyS14, UART: unknown, Port: 0x0000, IRQ: 0
/dev/ttyS15, UART: unknown, Port: 0x0000, IRQ: 0
/dev/ttyS2, UART: 16550A, Port: 0x1018, IRQ: 201
/dev/ttyS3, UART: 16550A, Port: 0x1020, IRQ: 201
/dev/ttyS4, UART: 16550A, Port: 0x1010, IRQ: 201
/dev/ttyS5, UART: 16550A, Port: 0x1018, IRQ: 201
/dev/ttyS6, UART: 16550A, Port: 0x1020, IRQ: 201
/dev/ttyS7, UART: 16550A, Port: 0x1028, IRQ: 201
/dev/ttyS8, UART: unknown, Port: 0x0000, IRQ: 0
/dev/ttyS9, UART: unknown, Port: 0x0000, IRQ: 0
  • So now from lspci -v I know that first port on my 4 port serial card is 1010 which is ttyS1, second 1018 is ttyS2....etc
  • Its really easy.
  • The maximum number of the serial ports you can set the kernel boot to is 16,if you need more, kernel 2.6.24 wil have 32 as upper limit.see Debian Bug 440807.

Tools

Archive Faxes

crontab -e
  • Now set up the time it will run. The extension it should use. And a folder where the faxes are.

1 0 * * * python /usr/local/bin/archive.py /var/spool/hylafax/recvq tif
  • Above line will run the program every day at 00:01 am. Change the "/usr/local/bin/archive.py" to where you have downloaded the program. Change "/var/spool/hylafax/recvq" to where your faxes are located. Change "tif" to the extension you are using for storing your faxes.
  • If you just need to run it once. This command will do.

python /usr/local/bin/archive.py /var/spool/hylafax/recvq tif

Send batch faxes

  • To send multiple faxes, first you need to create a file that will have fax numbers per one line. Type it or do a database query.

17731231234
13121231234
  • If you need to add 1 in front of the number you could use vim to do it with this code: press ESC

:%s/^/1/g
  • This will replace ^(beginning of a line) with 1
  • After your file is ready and you have a pdf of what you want to send. Issue this command

sendfax -z batchfaxnumbers.csv FILE2007NEWS.pdf
  • To make only one modem be responsible for sending that job. And to enable enough time for it to send we can issue this command which will use ttyS0 modem and will expire in 24 hours.

sendfax -h ttyS0@localhost -n -k 'now + 24 hours' -z batchfaxnumbers.csv FILE2007NEWS.pdf

Maintenance

  • To see a status of the fax service on the local machine, Type

faxstat -s

Restart Hylafax

/etc/init.d/hylafax restart

Checking Fax Status

To check the status of hylafax, we use the faxstat command:

faxstat
  • Type in the password(if it asks for one) and you should see something similar to the following:

faxserver:~# faxstat
Password:
HylaFAX scheduler on localhost.localdomain: Running
Modem ttyS15 (1.773.123.1234): Running and idle
Modem ttyS14 (1.773.123.1234): Running and idle

Removing a fax job

to remove a sent fax from the queue, issue the following command:

faxrm  jobid

Where JOBID is the ID of the job in question.

You can also remove multiple faxes at once, like the following:

faxrm 1011 1012 1013

If you have more then a 100 faxes to remove

  • Open excel/openoffice calc file
  • Create a range of 1...100; save as csv; Open in vim; Issue a command :%s/"//g to remove quotes; Issue a command %s/\n/ /g to replace new line with space; Add at the beginning faxrm ; On your server issue a command bash filename.csv

Printer not printing

  • If you followed DebianPrinting, log into the cups software via the http:localohost:631 and you can resume printing from there or see the status of the printer.

Country Specifc

France

  • The only difference is the country code and the prefix for international.