Versione adatta alla stampa

Alcuni giorni fa un visitante di questo sito cercava una guida per l’installazione di IAXmodem e Hylafax per Asterisk. Risposi dicendogli che c’è n’erano un paio buone: una presa dal libro Practical Asterisk e un’altra di un blog spagnolo. Purtroppo nessuna delle due gli funzionava o sicuramente, come ho scritto nel blog proprio ieri, erano abbastanza datate.

Facendo un po’ di ricerche su internet, mi sono accorto che era un tema molto trattato in siti, forum e blog. Così ho deciso di provare questa soluzione e vi annuncio fin da adesso che mi ha funzionato. Spero che la guida sia il più chiara possibile, se non lo fosse  potete sempre lasciare un commento. Solo una raccomandazione: indicate sempre la distribuzione linux che state usando e le versioni di Asterisk, IAXmodem e Hylafax che avete installato.

Premetto che la libreria SpanDSP giá l’avevo installata al momento della compilazione di Asterisk. Per quelli che hanno seguito la guida che ho scritto sull’installazione di Asterisk su Centos, non dovrebbero avere problemi. Per gli altri leggete bene il README presente con i sorgenti di IAXmodem.

Iniziamo con l’installazione di alcuni pacchetti necessari:

yum install libtiff libtiff-devel libtool

 

 

IAXmodem

 

IAXmodem è un modem software, scritto in C che usa un canale IAX (uno dei protocolli usati da Asterisk) a posto di una linea telefonica e usa un DSP software a posto di un chip DSP  (Digital Signal Processing). Scarichiamo i sorgenti di iaxmodem:

cd /usr/src

wget http://switch.dl.sourceforge.net/sourceforge/iaxmodem/iaxmodem-1.2.0.tar.gz

li scompattiamo

tar -xf iaxmodem-1.2.0.tar.gz

entriamo nella cartella:

cd iaxmodem-1.2.0

e compiliamo:

./configure
make

Copiamol’eseguibile in un’altra cartella:

cp iaxmodem /usr/local/sbin

Creiamo alcune cartelle e files indispensabili per il buon funzionamento di IAXmodem:

mkdir /etc/iaxmodem
mkdir /var/log/iaxmodem
touch /var/log/iaxmodem/ttyIAX
touch /var/log/iaxmodem/iaxmodem

Modifichiamo il file di configurazione predefinito presente con i sorgenti:

nano iaxmodem-cfg.ttyIAX

Questa è la mia configurazione che vi consiglio di lasciare così (tranne peer e password che sono quelle che andrete a configurare sul file IAX.conf di Asterisk):

device          /dev/ttyIAX
owner           uucp:uucp
mode            660
port            4570
refresh         300
server          127.0.0.1
peername        iaxmodem
secret          password
cidname         Asterisk-it
cidnumber       XXXXXXXXXX
codec           ulaw

Questa configurazione è valida se avete installato IAXmodem sulla stessa macchina dove è presente Asterisk. Nel caso di due macchine diverse dovrete indicare in server l’indirizzo IP della macchina dov’è installato Asterisk. In cidnumber indicate il numero di telefono della linea dove andrete a ricevere i FAX. Chiaramente possiamo creare un file di configurazione per ogni fax software che vogliamo installare. Li potremmo chiamare ttyIAX2 ttyIAX3, ecc.

Salviamo le modifiche e continuiamo copiando il file nella cartella /etc/iaxmodem che abbiamo creato

cp iaxmodem-cfg.ttyIAX /etc/iaxmodem/ttyIAX

A questo punto configuriamo IAX.conf per inserire la troncale iaxmodem:

nano /etc/asterisk/iax.conf

[general]
disallow=all
allow=ulaw
allow=g729
allow=gsm
bindport=4569
bindaddr=0.0.0.0
language=es
srvlookup=yes

[iaxmodem]
type=friend
context=fax
disallow=all
allow=ulaw
username=iaxmodem
secret=password
qualify=yes
notransfer=yes
host=dynamic
callerid="Fax" <XXXXXXXXXX>

Questo è tutto quello che ho nel file iax.conf. L’ho copiato intero per quanti non abbiano dimestichezza con la configurazione della parte generale.

Salviamo le modifiche e attualizziamo la configurazione di IAX in Asterisk. Entriamo nella console:

asterisk –rvvvvvvvvvvvvvvvvvvv

e scriviamo:

CLI> iax2 relaod
CLI> quit

Adesso possiamo fare una prima prova per vedere se il collegamento tra IAXmodem e Asterisk funziona.

cd /usr/local/sbin

./iaxmodem ttyIAX

dovrebbe apparire:

[2009-06-08 12:03:39] Modem started
[2009-06-08 12:03:39] Setting device = '/dev/ttyIAX'
[2009-06-08 12:03:39] Setting owner = 'uucp:uucp'
[2009-06-08 12:03:39] Setting mode = '660'
[2009-06-08 12:03:39] Setting port = 4570
[2009-06-08 12:03:39] Setting refresh = 300
[2009-06-08 12:03:39] Setting server = '127.0.0.1'
[2009-06-08 12:03:39] Setting peername = 'iaxmodem'
[2009-06-08 12:03:39] Setting secret = 'password'
[2009-06-08 12:03:39] Setting cidname = 'Asterisk-it'
[2009-06-08 12:03:39] Setting cidnumber = 'XXXXXXXXX'
[2009-06-08 12:03:39] Setting codec = ulaw
[2009-06-08 12:03:39] Opened pty, slave device: /dev/pts/4
[2009-06-08 12:03:39] Created /dev/ttyIAX symbolic link

Per fermarlo premiamo CTRL-C

[2009-06-08 12:03:45] Terminating on signal 2...

Prima di farlo controllliamo che nella console di asterisk avvenga la registrazione di IAXmodem (in un’altra finestra di terminale):

Dovrebbe apparire:

Bene. Abbiamo risolto già una parte del “problema”.

Adesso installiamo lo script presente nella cartella dei sorgenti di IAXmodem per fare in modo che si inizi automaticamente al boot di Linux:

cd /usr/src/iaxmodem-1.2.0

mv iaxmodem.init.fedora /etc/init.d/iaxmodem

lo rendiamo eseguibile:
chmod +x /etc/init.d/iaxmodem

e lo configuriamo per l’inizio automatico:

chkconfig --add iaxmodem
chkconfig iaxmodem on

e lo facciamo partire:

/etc/init.d/iaxmodem start

 

Hylafax

Iniziamo con Hylafax

Prima di tutto installiamo alcuni pacchetti necessari per il buon funzionamento di Hylafax:

yum install ghostscript ghostscript-devel sharutils ghostscript-fonts

Nella pagina di Hylafax sono i pacchetti per diverse distribuzioni:

Scarichiamo quello per Centos:

cd /usr/src

wget http://yum.trixbox.org/centos/5/RPMS/hylafax-4.4.4-1rhel5.i386.rpm

Lo installiamo:

rpm -iv hylafax-4.4.4-1rhel5.i386.rpm

Aggiungiamo faxgetty al inittab (faxgetty è il programma che permette di rispondere alle chiamate dirette a IAXmodem per poi passarle a Hylafax)

nano /etc/inittab

aggiungiamo questa linea:

7:2345:respawn:/usr/sbin/faxgetty ttyIAX

Salviamo e reiniziamo inittab

init q

Adesso possiamo iniziare con la configurazione di Hylafax (un po’ tediosa ma necessaria). Prestate attenzione alle parti in neretto:

faxsetup

Update /var/spool/hylafax/status/any.info.

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

Rispondiamo yes

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

No scheduler config file exists, creating one from scratch.
Country code [1]? 39
Area code []? 02
Long distance dialing prefix [1]? 0
International dialing prefix [011]? 00
Dial string rules file (relative to /var/spool/hylafax) ["etc/dialrules"]?
Tracing during normal server operation [1]?
Default tracing during send and receive sessions [0xffffffff]?
Continuation cover page (relative to /var/spool/hylafax) []?
Timeout when converting PostScript documents (secs) [180]?
Maximum number of concurrent jobs to a destination [1]?
Define a group of modems []?
Time of day restrictions for outbound jobs ["Any"]?
Pathname of destination controls file (relative to /var/spool/hylafax) []?
Timeout before purging a stale UUCP lock file (secs) [30]?
Max number of pages to permit in an outbound job [0xffffffff]?
Syslog facility name for ServerTracing messages [daemon]?

The non-default scheduler parameters are:

CountryCode:            39
AreaCode:               02
LongDistancePrefix:     0
InternationalPrefix:    00

Are these ok [yes]? yes

Creating new configuration file /var/spool/hylafax/etc/config...

Restarting HylaFAX server processes.
Should I restart the HylaFAX server processes [yes]?

/etc/rc.d/init.d/hylafax start
Starting HylaFAX queue manager (faxq):                     [  OK  ]
Starting HylaFAX server (hfaxd):                           [  OK  ]
Restarting HylaFAX modem manager (faxgetty):               [  OK  ]

Do you want to run faxaddmodem to configure a modem [yes]?
Serial port that modem is connected to []? ttyIAX

Ok, time to setup a configuration file for the modem.  The manual
page config(5F) may be useful during this process.  Also be aware
that at any time you can safely interrupt this procedure.

Reading scheduler config file /var/spool/hylafax/etc/config.

No existing configuration, let's do this from scratch.

Country code [1]? 39
Area code [415]? 02
Phone number of fax modem [+1.999.555.1212]? +3902XXXXXXXX
Local identification string (for TSI/CIG) ["NothingSetup"]?
Long distance dialing prefix [1]? 0
International dialing prefix [011]? 00
Dial string rules file (relative to /var/spool/hylafax) [etc/dialrules]?
Tracing during normal server operation [1]?
Tracing during send and receive sessions [11]?
Protection mode for received facsimile [0600]?
Protection mode for session logs [0600]?
Protection mode for ttyIAX [0600]?
Rings to wait before answering [1]? 2
Modem speaker volume [off]?
Command line arguments to getty program ["-h %l dx_%s"]?
Pathname of TSI access control list file (relative to /var/spool/hylafax) [""]?
Pathname of Caller-ID access control list file (relative to /var/spool/hylafax) [""]?
Tag line font file (relative to /var/spool/hylafax) [etc/lutRS18.pcf]?
Tag line format string ["From %%l|%c|Page %%P of %%T"]?
Time before purging a stale UUCP lock file (secs) [30]?
Hold UUCP lockfile during inbound data calls [Yes]?
Hold UUCP lockfile during inbound voice calls [Yes]?
Percent good lines to accept during copy quality checking [95]?
Max consecutive bad lines to accept during copy quality checking [5]?
Max number of pages to accept in a received facsimile [25]?
Syslog facility name for ServerTracing messages [daemon]?
Set UID to 0 to manipulate CLOCAL [""]?
Use available priority job scheduling mechanism [""]?

CountryCode:            39
AreaCode:               02
FAXNumber:              +3902XXXXXXXX
LongDistancePrefix:     0
InternationalPrefix:    00
DialStringRules:        etc/dialrules
SessionTracing:         11
RingsBeforeAnswer:      2
SpeakerVolume:          off
GettyArgs:              "-h %l dx_%s"
LocalIdentifier:        "NothingSetup"
TagLineFont:            etc/lutRS18.pcf
TagLineFormat:          "From %%l|%c|Page %%P of %%T"
MaxRecvPages:           25

Are these ok [yes]?

Now we are going to probe the tty port to figure out the type
of modem that is attached.  This takes a few seconds, so be patient.
Note that if you do not have the modem cabled to the port, or the
modem is turned off, this may hang (just go and cable up the modem
or turn it on, or whatever).

Probing for best speed to talk to modem: 38400 OK.

About fax classes:

The difference between fax classes has to do with how HylaFAX interacts
with the modem and the fax protocol features that are used when sending
or receiving faxes.  One class isn't inherently better than another;
however, one probably will suit a user's needs better than others.

Class 1 relies on HylaFAX to perform the bulk of the fax protocol.
Class 2 relies on the modem to perform the bulk of the fax protocol.
Class 2.0 is similar to Class 2 but may include more features.
Class 1.0 is similar to Class 1 but may add V.34-fax capability.
Class 2.1 is similar to Class 2.0 but adds V.34-fax capability.

HylaFAX generally will have more features when using Class 1/1.0 than
when using most modems' Class 2 or Class 2.0 implementations.  Generally
any problems encountered in Class 1/1.0 can be resolved by modifications
to HylaFAX, but usually any problems encountered in Class 2/2.0/2.1 will
require the modem manufacturer to resolve it.

Use Class 1 unless you have a good reason not to.

This modem looks to have support for Class 1 and 1.0.
How should it be configured [1]?

Hmm, this looks like a Class 1 modem.
Product code (ATI0) is "spandsp".
Other information (ATI3) is "www.soft-switch.org".
DTE-DCE flow control scheme [default]?
Modem manufacturer is "spandsp".
Modem model is "IAXmodem".

Using prototype configuration file iaxmodem...

The modem configuration parameters are:

ModemResetCmds:         "ATH1\nAT+VCID=1"

Are these ok [yes]?

Creating new configuration file /var/spool/hylafax/etc/config.ttyIAX...
Done setting up the modem configuration.

Checking /var/spool/hylafax/etc/config for consistency...
...some parameters are different.

The non-default scheduler parameters are:

CountryCode:            39
AreaCode:               02
LongDistancePrefix:     0
InternationalPrefix:    00
DialStringRules:        etc/dialrules

Are these ok [yes]?

Creating new configuration file /var/spool/hylafax/etc/config...
...saving current file as /var/spool/hylafax/etc/config.sav.

Don't forget to run faxmodem(8C) (if you have a send-only environment)
or configure init to run faxgetty on ttyIAX.
Do you want to run faxaddmodem to configure another modem [yes]? no

Looks like you have some faxgetty processes running (PIDs are):

    13236

It is usually a good idea to restart these processes after running
faxsetup; especially if have just installed new software.  If these
processes are being started by init(8C) then sending each of them a
QUIT message with the faxquit command should cause them to be restarted.
Is it ok to send a QUIT command to each process [yes]?
/usr/sbin/faxquit ttyIAX

Adesso facciamo ripartire hylafax

/etc/init.d/hylafax restart

Shutting down HylaFAX queue manager (faxq):                [  OK  ]
Shutting down HylaFAX server (hfaxd):                      [  OK  ]
Starting HylaFAX queue manager (faxq):                     [  OK  ]
Starting HylaFAX server (hfaxd):                           [  OK  ]
Restarting HylaFAX modem manager (faxgetty):               [  OK  ]

Tutti i files di configurazione appena creati li troveremo nella cartella /var/spool/hylafax/etc. Quindi in qualsiasi momemto li possiamo modificare a nostro piacimento.

 

Prova su Strada

Iniziamo con le prove.

Ho un numero geografico di EuteliaVoIP e la possibilità di inviare fax con  Cheapnet.

Il trunk Eutelia per le chiamate in entrata è configurato con il contesto from-eutelia

Nel file di configurazione extensions.conf ho aggiunto le seguenti linee:

[from-eutelia]
exten => s,1,NoOp( Call from Eutelia )
exten => s,n,Dial(IAX2/iaxmodem)
exten => s,n,Hangup

Secondo Julian J. Menéndez (l’autore del post in spagnolo) è possibile scrivere la parte dell’extensions.conf in questo modo:

[from-pstn]
exten => s,1,Answer
exten => s,n,Wait(3)
exten => s,n,Dial(SIP/101)
exten => fax,1,Dial(IAX/300)

Se Asterisk riconosce che dall’altro lato c’è un fax va all’estensione fax altrimenti chiama l’interno SIP/101. Non l’ho provato però se qualcuno vuole farlo “deve” raccontarci l’esito.

Ho salvato le modifiche e riavviato asterisk

/etc/init.d/asterisk restart

Dalla pagina per l’invio di fax di cheapnet mi sono inviato un pdf al numero di Eutelia. Non sempre funziona al primo colpo. Forse perche passa per il server PBX di Eutelia e poi per il mio Asterisk. Sarebbe buona cosa fare delle prove direttamente con una linea PSTN connessa a Asterisk (io non ce l’ho). Questo è il risultato della prova:

Lato Asterisk:

e-Mail ricevuto:

Si, lo so, ho l’Outlook Express in spagnolo :)

FaxMaster è l’utente predefinito al quale Hylafax invia il fax. Se volete cambiarlo dovete modificare il file FaxDispatch che trovate nella cartella /var/spool/hylafax/etc

Se volete ricevere il messaggio con il testo in italiano sempre nel file FaxDispatch aggiungete la seguente linea:

TEMPLATE=it

E salvate le modifiche.

Per l’invio dei fax:

• creare in extension.conf un contesto [fax] (quello che abbiamo configurato in iax.conf per iaxmodem e inserire queste linee:

[fax]
exten => _X.,1,Dial(SIP/Provider/${EXTEN})
exten => _X.,n,Hangup

Attualizzare il dialplan:

/etc/init.d/asterisk reload

e da una finestra terminale scrivere:

sendfax -n -d <faxnumber> <file.txt>

Esempio:

sendfax –n –d 02XXXXXXXX /tmp/pippo.pdf

Mi sembra che sia tutto.