Asterisk/Instellen

Op deze pagina wordt uitgelegd hoe je je eigen Asterisk-server opzet en interconnect met Limesco/SpeakUp. Aanvullingen en wijzigingen op deze pagina zijn welkom: deze wiki is vrij wijzigbaar door leden. Eventuele twijfels of vragen kun je stellen op de Overlegpagina.

Waarschuwing: De informatie op deze pagina is nog lang niet af. Ga er nog niet vanuit dat iets op deze pagina werkt, er kunnen nog grote wijzigingen plaatsvinden terwijl de infrastructuur zich vormt.

Kom je afkortingen of woorden tegen die je niet kent? Kijk dan op de terminologie-pagina!

De infrastructuur

SpeakUp heeft de infrastructuur (via Elephant Talk, de MVNE) met het T-Mobilenetwerk zo geregeld dat alle verkeer vanaf de mobiele telefoons van SpeakUp-klanten direct uitkomt bij de PBX bij SpeakUp. Daar zal hun Asterisk-installatie controleren of er een alternatieve SIP-server is ingesteld voor het telefoonnummer in kwestie, en zo ja de SIP-verbinding doorsturen. Je Asterisk-server kan dan kiezen wat er met dat uitgaande gesprek gebeurt. De meest waarschijnlijke optie voor de meeste nummers is het gewoon weer terug doorsturen naar SpeakUp, die dan een route zal kiezen naar dat nummer. Zodra een PBX het gesprek accepteert, zal vanaf dan een RTP-stream worden opgezet tussen de servers van SpeakUp en de ontvanger (jouw server, een server bij SpeakUp, of een VoIP-eindpunt) waar de gespreksdata overheen kan gaan.

Op deze pagina wordt uitgelegd hoe je die eigen Asterisk-server opzet. We zullen ervoor zorgen dat gesprekken uitkomen op je server, en dan een regel definiëren waarmee je server alles terugstuurt naar SpeakUp (je PBX is daardoor 'transparant'). Daarna zorgen we ervoor dat ook inkomende gesprekken correct naar je telefoon terug komen. En daarna geven we wat voorbeelden van leuke dingen om te proberen :)

Asterisk installeren

Dit hangt natuurlijk af van je distro, maar ik heb dit onder Debian Testing geprobeerd met Asterisk 1:1.8.11.1~dfsg-1. De configuratiebestanden staan dan onder /etc/asterisk. De server zelf runt als de user "asterisk". Om een volledige console-log te krijgen heb ik logger.conf aangepast en daar onder [logfiles] een console-regel veranderd naar:

console => debug,notice,warning,error,verbose,dtmf,fax

Onder de meeste distro's zal Asterisk vanzelf gestart zijn; anders moet je 'm nu zelf even starten (bijvoorbeeld met service asterisk start). Nu kunnen we verbinden naar Asterisk, met een asterisk -R (bij een "unable to connect" even opnieuw proberen als de user waarmee asterisk runt, b.v. sudo -u asterisk asterisk -R, of als je het wel gelooft gewoon als root).

sjors@foo:~$ sudo asterisk -R
[...]
Connected to asterisk 1.8.11.1~dfsg-1 currently running on foo (pid = 8051)
Verbosity is at least 3
foo*CLI> core show version
Asterisk 1.8.11.1~dfsg-1 built by pbuilder @ boomtime on a x86_64 running Linux on 2012-04-25 17:59:19 UTC

Een kleine extensions-tutorial

We hebben nu een Asterisk-server runnen die nog niets doet, en waar nooit naartoe verbonden zal worden. Hier volgt eerst een kleine tutorial in dialplans, zodat we er zometeen eentje kunnen schrijven.

Waarschuwing: Terwijl ik dit schrijf ben ik hier net twee dagen mee bezig, dus de kans is groot dat ik dingen verkeerd heb begrepen. Ik schrijf dit als een best-effort om mijn huidige begrip over te brengen. Als je zeker weet dat hier iets niet klopt, verbeter het dan alsjeblieft!

Asterisk laadt bij het opstarten een "dial-plan" in het geheugen. Een dialplan is een set instructies voor een bepaald telefoonnummer (of extension), die Asterisk zal uitvoeren zodra dat telefoonnummer wordt gebeld. Iedere instructie heeft een regelnummer; Asterisk zal beginnen bij regelnummer 1 van de juiste extension en regelnummers zullen in volgorde worden afgehandeld tot het eerstvolgende regelnummer niet meer bestaat. Als een telefoongesprek tegen het einde van een set instructies niet (succesvol) is doorgeschakeld, aangenomen of geweigerd, zal Asterisk zelf de juiste foutcode proberen te raden (b.v. aan de hand van een gefaalde operatie). Er bestaat een opdracht GoTo om naar een andere extension of een ander regelnummer te springen. Dit is bijvoorbeeld een correcte set instructies om een geluidje af te spelen en op te hangen:

exten => 100,1,Answer
exten => 100,n,MP3Player(/tmp/Sad-Trombone.mp3)
exten => 100,n,Hangup

Alle regels beginnen met "exten =>" (of "exten ="); daarna volgt het telefoonnummer, daarna het regelnummer (of "n" voor next, het vorige regelnummer plus één), en daarna de instructie om uit te voeren.