Ma il vostro sistema l’aggiornate con i classici apt-get update ed apt-get upgrade e quindi ad oggi, avrete una versione del kernel ben diversa da quando avete compilato la prima volta il modulo zaptel (io mi trovo alla 2.6.18-6) e può succedere che Asterisk non trova più il modulo chan_zap per interfacciarsi con la scheda ISDN e restituisca degli errori simili a questi:

Mar 25 09:03:55 ERROR[5750] chan_zap.c: Unable to register channel '1-2'
Mar 25 09:03:55 WARNING[5750] loader.c: chan_zap.so: load_module failed, returning -1
Mar 25 09:03:55 WARNING[5750] loader.c: Loading module chan_zap.so failed!
Mar 25 09:04:16 NOTICE[5779] cdr.c: CDR simple logging enabled.
Mar 25 09:04:16 NOTICE[5779] config.c: Registered Config Engine mysql
Mar 25 09:04:16 WARNING[5779] chan_zap.c: Unable to specify channel 1: No such device or address
Mar 25 09:04:16 ERROR[5779] chan_zap.c: Unable to open channel 1: No such device or address
here = 0, tmp->channel = 1, channel = 1

Come si risolve?

Alla Debian! Basta infatti un bel:

module-assistant a-i zaptel

Ed il sistema scaricherà il pacchetto più aggiornato di zaptel, degli headers del kernel, compilerà il nuovo modulo ed al riavvio avrete Asterisk funzionante.

Installiamo IAXModem ed i pacchetti da cui dipende con un semplicissimo:

apt-get install iaxmodem

Per configurare IAXModem bisogna creare il file /etc/iaxmodem/ttyIAX.
Il mio contiente:


device /dev/ttyIAX
owner uucp:uucp
mode 660
port 4570
refresh 300
server 127.0.0.1
peername iaxmodem
secret [PASSWORD]
cidname FAXServer
cidnumber [NUMERO_ISDN_FAX]
codec slinear


Facciamo partire IAXModem tramite:


/etc/init.d/iaxmodem start


Dalla console di Asterisk (asterisk -cr) verifichiama che il peer di IAXModem sia connesso:


iax2 show peers


Se l’output è qualcosa di simile a questo:

Name/Username Host Mask Port Status
iaxmodem/iaxmod 127.0.0.1 (D) 255.255.255.255 4570 OK (2 ms)
1 iax2 peers [1 online, 0 offline, 0 unmonitored]

Siamo fortunati!:)
Per uscire dalla console usare il comando quit

Procediamo adesso all’installazione e configurazione di Hylafax:


apt-get install hylafax-server


Per aggiungere lo IAXModem partiamo dal file di configurazione di esempio presente nel pacchetto Debian, quindi per prima cosa lo copiamo nella directory delle configurazioni di Hylafax:


cp /usr/share/doc/iaxmodem/examples/config.ttyIAX /var/spool/hylafax/etc/


Adesso modifichiamo il necessario:

CountryCode: 39
AreaCode: [PREFISSO]
FAXNumber: +39.[PREFISSO].[NUMERO_FAX]
TagLineFormat: "Ricevuto da %%l|%c|Pagina %%P of %%T"


Riavviamo Hylafax con /etc/init.d/hylafax restart e verifichiamo se tra i processi in esecuzione (ps -aux) c’è:

/usr/sbin/faxgetty ttyIAX

Molto probabilemente si!:)
Un ulteriore controllo è vedere se il Hylafax è in ascolto su IAXModem tramite il comando faxtstat -a, il cui output dovrebbe essere questo:


HylaFAX scheduler on [HOST_SERVER]: Running
Modem ttyIAX (+39.[PREFISSO].[NUMERO]): Running and idle


Ora configuriamo Hylafax a fare in modo che ogni FAX ricevuto sia spedito ad un indirizzo e-mail.
Per fare ciò è necessario editare il file /var/spool/hylafax/bin/faxrcvd e configurare questi parametri:


#FROMADDR=FaxMaster
FILETYPE=pdf
SENDTO=FaxMaster


Così facendo i FAX verranno traformati in pdf ed inviati all’indirizzo e-mail FaxMaster impostato in /etc/aliases:

FaxMaster: [TUA_MAIL]

Ovviamente perché tutto funzioni è necessario aver configurato un server di posta sul server.

A questo punto è necessario verificare che i programmi descritti in questa serie di articoli partano nel modo corretto.
Per una corretta esecuzione è necessario che lo start-up sia questo:

1. Asterisk
2. IAXModem
3. Hylafax

Per fare ciò usiamo il comodissimo update-rc.d:


update-rc.d -f asterisk remove
update-rc.d -f iaxmodem remove
update-rc.d -f hylafax remove


Così li ho rimossi tutti, mentre con:


update-rc.d asterisk defaults 19
update-rc.d iaxmodem defaults 21
update-rc.d hylafax defaults 22


Setto l’ordine con cui devono essere lanciati all’avvio.

Bene, siamo giunti alla fine!:)

Se avrò eventuali aggiornamenti non esiterò a pubblicarli e per domande e curiosità sono a disposizione.

Buon PBX a tutti!

La prima parte è consultabile cliccando qui.

Mi ero fermato all’installazione dei pacchetti Debian di Asterisk:


apt-get install asterisk asterisk-bristuff asterisk-config asterisk-dev asterisk-sounds-extra asterisk-sounds-main


Finita l’installazione, va configurato Asterisk.

Partiamo dal file /etc/asterisk/modules.conf che si occupa di caricare i moduli necessari per le varie feature messe a disposizione dal programma.
Per quanto riguarda la mia configurazione ho disabilitato alcune cose che non mi servicano, infatti nel file ho inserito:


noload => app_capiCD.so
noload => app_capiHOLD.so
noload => app_capiRETRIEVE.so
noload => app_capiECT.so
noload => app_capiMCID.so
noload => app_capiNoES.so
noload => res_config_odbc.so
noload => res_odbc.so
noload => cdr_odbc.so
noload => rate_engine.so
noload => chan_modem_aopen.so
noload => chan_modem_bestdata.so
noload => cham_modem_i4l.so
noload => chan_skinny.so
noload => chan_agent.so
noload => func_odbc.so
noload => cdr_sqlite.so
noload => cdr_sqlite3_custom.so
noload => res_musiconhold.so


Siccome la nostra scheda viene vista attraverso i moduli zaptel, è necessario configurare il file /etc/zaptel.conf per settare i parametri del modulo congrui alla nostra scheda ISDN.
Nel mio caso ho effettuato queste modifiche:


span=1,1,3,ccs,ami
bchan=1,2
loadzone=it
defaultzone=it


Salviamo questo file e rivviamo il modulo zaptel o meglio riavviamo il nostro home server.

Adesso passiamo al prossimo file: zapata.conf che contiene le impostazioni necessarie a far funzionare la nostra scheda ISDN vista tramite il modulo zaptel.

Le modifice da me inserite nel file sono solo queste:

language=it
context=isdn
switchtype=euroisdn
pridialplan=unknown
prilocaldialplan=unknown
internationalprefix=00
nationalprefix=0
signalling=bri_cpe_ptmp
echotraining=100
channel =>1-2
group=1


Language è abbastanza esplicito, context è il contesto di riferimento da gestire successivamente nel file extensions.conf, switchtype è settato euroisdn perché è lo standard usato in Italia da Telecom sulle borchie ISDN, signalling seleziona il tipo di connessione ISDN utilizzato, nel caso comune è point to multi-point.
Con channel diciamo ad Asterisk quanti canali abbiamo e a che gruppo appartengono (tramite group).

Passiamo adesso a configurare il file iax.conf, necessario per utilizzare IAXModem che serve ad avere un modem fax in Hylafax.

Questi sono i parametri necessari per un corretto funzionamento:

bindport=4569
bindaddr=127.0.0.1
iaxcompat=yes
nochecksums=no
delayreject=yes
amaflags=default
language=it
bandwidth=high
allow=all
;disallow=lpc10
jitterbuffer=yes
forcejitterbuffer=yes
dropcount=0
maxjitterbuffer=800
maxjitterinterps=400
resyncthreshold=1000
maxexcessbuffer=80
minexcessbuffer=10
jittershrinkrate=1
trunktimestamps=no
minregexpire = 300
maxregexpire = 300
mailboxdetail=no
regcontext=iaxregistrations

Dopo queste impostazioni è necessario creare l’utente per IAXModem.
Tale operazione va eseguita sempre nel file iax.conf ma prima è meglio cancellare gli account di default.
Per farfe questo ho rimosso tutte le righe presenti dopo ; The valid values are: ed a fine file ho creato l’utentenecessario:

[iaxmodem]
username=iaxmodem
secret=[PASSWORD]
accountcode=iaxmodem
type=friend
context=iax
;host=127.0.0.1
host=dynamic
notransfer=yes
qualify=yes
disallow=all
allow=alaw
allow=ulaw
allow=slinear


Fatto ciò è il turno di sip.conf, ed ecco infatti le modifiche da me apportate:

realm=Asterisk
srvlookup=no
tos=lowdelay
maxexpiry=3600
defaultexpiry=120
checkmwi=10
recordhistory=yes
disallow=all
allow=g729 ; questo codec va comprato a parte dal sito Digium
allow=alaw
allow=ulaw
language=it
rtptimeout=60
rtpholdtimeout=300
trustrpid = no
progressinband=never
useragent=Asterisk PBX
promiscredir = no
usereqphone = no
dtmfmode = info
compactheaders = yes
registertimeout=20
externhost=
externrefresh=10
localnet=[LAN]/[SUBNET_LAN]
nat=yes
rtcachefriends=yes
rtupdate=yes
;[authentication]


Alcuni parametri inseriti serviranno a superare l’ostacolo dovuto al NAT e quindi vanno settati con meticolosa cura appoggiandosi anche a servizi gratuti come quelli di Dyndns.org per avere un host che punta sempre al nostro IP pubblico dinamico.

Adesso bisogna creare una connessione verso Eutelia, per fare questo ecco la configurazione:

register=>[NUMERO_EUTELIA]:[PASSWORD_EUTELIA]:[NUMERO_EUTELIA]@eutelia/[NUMERO_EUTELIA]
[eutelia]
username=[NUMERO_EUTELIA]
context=portability-casa
type=peer
srvlookup=no
secret=[PASSWORD_EUTELIA]
realm=voip.eutelia.it
qualify=yes
nat=yes
insecure=very
host=voip.eutelia.it
fromuser=[NUMERO_EUTELIA]
fromdomain=voip.eutelia.it
disallow=all
allow=g729
allow=alaw
allow=ulaw


Modificate i parametri in base al vostro account ed occhio alla direttiva context, è importante perché viene richiamata all’interno del file extensions.conf che permette la comunicazione tra i vari peers collegati al PBX.

Adesso creiamo gli utenti SIP che costituiranno gli interni telefonici.
Io ho usato una parte diversa in base all’account:

[701]
type=friend
context=sip-ufficio
secret=[PASSWORD_701]
username=701
callerid=SIP Ufficio <701>
accountcode=701
[702]
type=friend
context=sip-fax
secret=[PASSWORD_702]
username=702
fromuser=SIP Fax <702>
callerid=SIP Fax <702>
accountcode=702
[703]
type=friend
context=sip-casa
secret=[PASSWORD_703]
username=703
callerid=SIP Casa <703>
accountcode=703

ed una parte comune che va incollata subito dopo accountcode:

amaflags=billing
port=5060
host=dynamic
nat=no
disallow=all
allow=alaw
allow=ulaw
allow=gsm
qualify=yes
canreinvite=no
dtmfmode=info
incominglimit=1


In pratica ho creato tre numeri interni del tipo 70X dove, il 701 è l’interno SIP sul quale verranno instradate le chiamate provenienti dal numero primario della linea ISDN, il 702 è quello riservato al FAX che si appoggerà al secondo numero ISDN ed il 703 è l’interno su cui verranno inoltrate le chiamate provenienti da Eutelia su cui ho effettuato la number portability del numero di casa.

Tutta la magia viene fatta tramite il file extensions.conf che ho modificato in questo modo:

;CONSOLE=Console/dsp
;IAXINFO=guest
;TRUNK=Zap/g2
;TRUNKMSD=1


Dopo ;[context] vanno inserite le rotte di comunicazione:

[default]
[portability-casa]
exten => _X.,1,Dial(SIP/703) ; numero di portability di casa
exten => _X.,2,Hangup
[sip-ufficio]
exten => [MIO_NUMERO_CASA],1,Dial(SIP/703) ; se viene chiamato il numero di casa non inoltro la chiamata su linee esterne
exten => _X.,1,set(CALLERID(number)=[NUMERO_ISDN_PRIMAIO]) ; e' superfluo visto perche' e' numero principale
exten => _X.,2,Dial(Zap/1/${EXTEN})
exten => _X.,3,Hangup
[sip-fax]
exten => _X.,1,set(CALLERID(number)=[NUMERO_ISDN_SECONDARIO])
exten => _X.,2,Dial(Zap/2/${EXTEN})
exten => _X.,3,Hangup
[sip-casa]
exten => [MIO_NUMERO_UFFICIO],1,Dial(SIP/701) ; se viene chiamato il numero dell'ufficio non inoltro la chiamata su linee esterne
exten => _X.,1,Dial(SIP/${EXTEN}@eutelia) ; per chiamare l'esterno uso Eutelia
exten => _X.,2,Dial(Zap/2/${EXTEN})
exten => _X.,3,Hangup
[isdn]
; Per le telefonate dell'ufficio
exten => [MIO_NUMERO_UFFICIO],1,Dial(SIP/701)
exten => [MIO_NUMERO_UFFICIO],2,Hangup
; Per i FAX
exten => [MIO_NUMERO_FAX],1,Dial(IAX2/iaxmodem/${EXTEN})
exten => [MIO_NUMERO_FAX],2,Hangup

Le righe successive alla parte dove avete inserito le vostre rotte sono di esempio e quindi le potete benissimo cancellare.

Adesso secondo me è il caso di spiegare cosa ho appena scritto.

Abbiamo:

• una ISDN con due numeri
• 3 interni SIP: 701,702,703
• un utente IAX per il modem fax

Bene, assodato questo il routing è così fatto:

• qualsiasi chiamata che arriva dall’account SIP di Eutelia verrà recapitato all’interno 703
• se arriva una chiamata al numero [MIO_NUMERO_UFFICIO], cioè proveniente dalla linea ISDN con numero primario, squillerà l’interno numero 701
• all’arrivo di un fax proveniente dal secondo numero ISDN identificato con [MIO_NUMERO_FAX], verrà contattato il canale IAX2 che funge da modem per Hylafax.
• se dall’interno numero 701 compongo il numero di casa [MIO_NUMERO_DI_CASA], non verrò usato il canale ISDN ma verrà direttamente contattato l’interno 703
• stessa cosa vista poco fa ma il chiamate è il 703 ed il chiamato sarà 701 così non passo per Eutelia nel voler contattare l’ufficio
• in uscita l’interno 701 passerà per l’ISDN con numero principale
• in uscita l’interno 702 passerà per l’ISDN con numero secondario
• in uscita l’interno 703 userà Eutelia (attualmente faccio passare anche questo su ISDN…)

Ovviamente dovete sostituire i campi di questo tipo: [MAIUSCOLO], con i numeri ISDN in possesso.

Per qualsiasi dubbio sull’instradamento delle chiamate potete contattarmi oppure consultare Voip-Info.org che è straricco di materiale utile alla corretta configurazione di Asterisk.

Adesso dovremmo avere un PBX funzionante.

Per far in modo che Asterisk si avvi bisogna modificare il file /etc/default/asterisk e settare:

RUNASTERISK=yes

Adesso lanciamo Asterisk con:

/etc/init.d/asterisk start

e corriamo a vedere il log per eventuali problemi:

tail -vf /var/log/asterisk/message

Tutto ok? Bene adesso è il turno del FAX…che vedremo nella terza parte.

• configurare un server Asterisk
• collegare il server ad una linea ISDN
• con scheda ISDN HFC
• utilizzare il numero secondario ISDN come fax
• inviare i fax ricevuti via mail
• utilizzare il numero primario ISDN per le normali telefonate

Ma non finisce qui…l’articolo spiega anche come:

• registare i CDR in un database MySQL
• utilizzare Eutelia VoIP
• smistare le chiamate a seconda della lora destinazione
• avere interni che parlano tra loro (gratis)

Tutto questo utilizzando pacchetti deb ricompilando a manina quasi niente.

Si parte da Debian Etch.

Io ho utilizzato la versione Netinstall perché il PC sarà dedicato a far eil centralino e quindi non mi occorre nient’altro che un sistema operativo di base ed i pacchetti necessari a creare un valido PBX.

Verifichiamo con lspci se la scheda ISDN è vista dal sistema:


02:0e.0 Network controller: Cologne Chip Designs GmbH ISDN network controller [HFC-PCI] (rev 02)


Se vedete qualcosa di simile si può andare avanti…

Siccome va compilato il modulo zaptel ci occorrono gli headers del kernel nonché zaptel, quindi procediamo all’installazione di questi pacchetti:


apt-get install linux-headers-2.6.18-5 linux-headers-2.6.18-5-686

Controllare con uname -a la versione del kernel in uso e quindi installare il corretto pacchetto linux-headers.

Creiamo un bel link simbolico sotto la directoru /usr/src/:


ln -s /usr/src/linux-headers-2.6.18-5-686/ /usr/src/linux

Adesso installiamo ZapTel:


apt-get install zaptel zaptel-source


Per creare il modulo ed installarlo si utilizza Module Assistant:

module-assistant a-i zaptel


Sia quest’ultimo comando che i precedenti possono portare all’installazione di ulteriori pacchetti, inutile dire di dare sempre il consenso!:)

Se tutto è filato liscio eseguendo un:


depmod -a


non ci dovrebbero essere anomalie.

Adesso abbiamo a disposizione il modulo zaptel, il modulo zaphfc e il modulo vzaphfc.
Quest’ultimo serve ad eliminare i problemi di interrupt che si possono venire ad evere se lo slot PCI in cui è la scheda condivide l’interrupt con qualche altro dispositivo.
Per fiducia noi utilizzeremo il modulo vzaphfc.

Proviamo a caricare il modulo:


modprobe vzaphfc


Con un

lsmod | grep "zap"

possiamo vedere questi moduli:


vzaphfc 27624 0
zaptel 183364 1 vzaphfc
crc_ccitt 2240 2 zaptel,hisax


Tutto positivo, tranne che il modulo hisax è up.
Hisax è il vecchio sistema per la gestione dell’ISDN da parte del kernel, sostituito attualmente da mISDN.
Per fare un modo che il modulo hisax non sia più caricato lo mettiamo nella blacklist di modprobe:


vi /etc/modprobe.d/blacklist


Alla fine del file aggiungiamo:


blacklist hisax


Dal prossimo riavvio il modulo Hisax resterà a casa.

Ma torniamo a Zaptel…
Con dmsg dovremmo vedere qualcosa di simile:


Zapata Telephony Interface Registered on major 196
Zaptel Version: 1.2.11 Echo Canceller: MG2
vzaphfc: HFC-S PCI A Zaptel Driver (V1.42) loading
ACPI: PCI Interrupt 0000:02:0e.0[A] -> GSI 17 (level, low) -> IRQ 201
vzaphfc: card 0: registered ZTHFC1/0/1
vzaphfc: card 0: registered ZTHFC1/0/2
vzaphfc: card 0: registered ZTHFC1/0/3
vzaphfc: card 0: resetting
vzaphfc: card 0 configured for TE mode at mem 0xfb300000 (0xe01c2000) IRQ 201


Bene con l’hardware abbiamo finito!:)
Adesso configuriamo il modulo, editando il file /etc/zaptel.conf, verifichiamo che ci sia:


span=1,1,3,ccs,ami
bchan=1,2
dchan=3
loadzone=it
defaultzone=it


In pratico diciamo al modulo che abbiamo 2 canali per la voce (l’1 ed il 2) ed 1 (il 3) di segnalazione, che siamo in Italia ed alcuni protoccoli standard di comunicazione (ccs,ami).

Ogni volta che verrà caricato il modulo vzaphfc, il sistema leggerà il file appena editato e configurerà la scheda a dovere.

Riavviamo la macchina per vedere se il modulo viene caricato automaticamente all’avvio.

Verifichiamo se c’è tutto il necessario:


#lsmod | grep "zap"
vzaphfc 27624 0
zaptel 183364 1 vzaphfc
crc_ccitt 2240 1 zaptel


Perfetto!:)

Adesso installiamo Asterisk.

Siccome Debian è la miglior distrubuzione Linux dell’universo, ha il pacchetto con la versione BRI Stuffed necessaria per utilizzare le schede ISDN HFC.

Installiamo i seguenti pacchetti:


apt-get install asterisk asterisk-bristuff asterisk-config asterisk-dev asterisk-sounds-extra asterisk-sounds-main

La seconda parte di questo articolo è consultabile cliccando qui.

I pacchetti Etch riguardanti Asterisk sono:

asterisk - Open Source Private Branch Exchange (PBX)
asterisk-app-dtmftotext - Text entry application for Asterisk
asterisk-app-fax - Softfax application for Asterisk
asterisk-bristuff - Open Source Private Branch Exchange (PBX) - BRIstuff-enabled version
asterisk-chan-capi - Common ISDN API 2.0 implementation for Asterisk
asterisk-classic - Open Source Private Branch Exchange (PBX) - original Digium version
asterisk-config - config files for asterisk
asterisk-dev - development files for asterisk
asterisk-doc - documentation for asterisk
asterisk-h323 - asterisk H.323 VoIP channel
asterisk-oh323 - oh323 channel driver for Asterisk
asterisk-prompt-de - German voice prompts for the Asterisk PBX
asterisk-prompt-es-co - Colombian Spanish voice prompts for Asterisk
asterisk-prompt-fr - French voice prompts for Asterisk
asterisk-prompt-it - Italian voice prompts for the Asterisk PBX
asterisk-prompt-se - Swedish voice prompts for Asterisk
asterisk-sounds-extra - Additional sound files for the Asterisk PBX
asterisk-sounds-main - sound files for asterisk
asterisk-web-vmail - Web-based (CGI) voice mail interface for Asterisk
destar - management interface for the Asterisk PBX
iaxmodem - software modem with IAX2 connectivity
kiax - IAX VoIP softphone
libiax-dev - implementation of the Inter-Asterisk eXchange protocol (devel)
libiax0 - implementation of the Inter-Asterisk eXchange protocol

Tanti vero?
Ne manca uno… Asterisk Addons.
Principalmente serve per configurare Asterisk in modalità Real Time o, ancor meglio, per memorizzare i CDR in un database MySQL.
Se si vuole utilizzare tale software è necessario compilarlo da sorgenti ma prima bisogna essere sicuri che il proprio sistema Debian abbia gia i seguenti pacchetti installati:

asterisk-dev
libmysqlclient15-dev
libmysqlclient15off
mysql-client-5.0
mysql-common
mysql-server-5.0

Oltre ovviamente ai pacchetti standard di Asterisk scelti in base alle proprie necessità. Io uso asterisk-bristuff con la scheda ISDN HFC e devo dire che non è stato mai così facile configurare un centralino su ISDN!.

Adesso bisogna scaricare il pacchetto dal sito di Asterisk:

http://ftp.digium.com/pub/asterisk/releases/asterisk-addons-1.4.2.tar.gz

E tramite le solite operazioni è necessario, decomprimerlo e compilarlo.
Per la configurazione di Asterisk rimando al materiale presente in rete ma segno in agenta di scrivere come ho configurato il mio PBX passo passo sperando che possa essere utile.

E’ la prima volta dopo anni che uso Debian che ho dovuto fare qualcosa a manina, fortunamente veniva dal mondo Slackware e quindi…