IP telefonipakke Quick guide Cand. It. Sune Kloppenborg Jeppesen Ingeniør. Claus Lavdal
IP telefonipakke: Quick guide af Cand. It. Sune Kloppenborg Jeppesen og Ingeniør. Claus Lavdal Ophavsret 2006, 2007 Ministeriet for Videnskab, Teknologi og Udvikling Åben dokumentlicens Version 1.0 - Licensen kan findes på: http://www.sslug.dk/linuxbog/licens.html [http://www.sslug.dk/linuxbog/licens.html] 1. Kopiering og distribution af værket i uændret form Du må frit kopiere dette værk uændret og distribuere det på ethvert medium, forudsat at du sammen med hver kopi bibeholder denne licens og en henvisning til værkets kilde. Du kan vælge at kræve penge for kopiering og distribution af indholdet, for undervisning i indholdet, for brugerstøtte og garantier i forbindelse med indholdet. Hvis du videregiver værket til andre, har du pligt til at se til, at du selv eller andre giver modtageren gratis adgang i minimum 3 år til en elektronisk udgave af indholdet - i et åbent redigérbart format - for eksempel via internettet, og at der i hvert eksemplar tydeligt angives, hvordan man kan få den elektroniske udgave. 2. Ændring af indhold Du må gerne ændre i dette værk eller dele af det (og dermed lave et nyt værk baseret på dette værk) og distribuere det som nævnt ovenfor, forudsat at du opfylder alle følgende krav: a. Du skal sørge for at det nye værk indeholder en tydelig anmærkning om at du ændrede det, hvad du ændrede og datoen for ændringerne. b. Det skal være omfattet af samme rettigheder og betingelser ("licens"), som det oprindelige værk. Alternativt kan det nye værk bære en anden licens eller almindelig ophavsretlig beskyttelse, forudsat at samtlige dele, der oprindeligt stammer fra dette værk, tydeligt er markeret (f.eks i sidefoden på hver side) som værende under denne licens, og at licensen følges for disse dele af værket, herunder at der gives gratis elektronisk adgang som nævnt under afsnittet om kopiering og distribution. 3. Pligter Enhver anvendelse, kopiering eller distribuering betragtes som en accept af denne licens og dens betingelser. Ved overtrædelse af licensbetingelserne, vil almindelig ophavsretlig beskyttelse være gældende for hele værket og vil dermed gøre person eller personer erstatningspligtige for enhver uautoriseret anvendelse. 4. Garanti Indholdet leveres "som det er", uden nogen form for garanti for købs-, brugs- eller nytteværdi, medmindre der er givet en særskilt skriftlig garanti herom.
1. Indledning... 1 1.1. Læsevejledning... 1 2. Forberedelser... 3 2.1. Indgangsvinkel... 3 2.2. Systemoversigt... 3 2.3. Server... 4 2.4. Netværk... 5 2.5. Telefoner... 5 3. Opsætning... 6 4. Afslutning... 15 Litteraturliste... 16 iv
1. Indledning Dette dokument vil give anvisninger til hvordan IP telefonipakke sættes op, sådan at man får en fungerende telefoncentral ved slutningen. Guiden sigter udelukkende på de grundlæggende funktioner, og mange af de avancerede muligheder er skåret væk, for at sikre en god introduktion. Når guiden er gennemført vil man have en multi protokol IP telefoncentral, der ikke bare understøtter IP telefoni baseret på SIP protokollen men også på andre IP telefoniprotokoller. Desuden kan den også håndtere analog telefoni med standard hardware. Løsningnen er baseret på Asterisk som har fået sit navn fra * 1 som indikere, at telefoncentralen kan matche alle protokoller. At gennemgå alle disse muligheder vil være for omfattende i en Quick guide - så derfor sigter vi på at sætte to softphones op som via Asterisk kan ringe til hinanden. Mange af de øvrige aspekter vil blive gennemgået i de andre dokumenter og primært i Howto guide som vil være emne baseret og f.eks. indholde et afsnit om ISDN gateway mulighederne. Målgruppe for dokumentet er teknikere som har forståelse for netværks teknologier, switch, routere og netværks drift samt server administration. Det er ikke en forudsætning at man har kendskab til Linux/ Unix, men det vil være en fordel. Opgaven vil primæt blive udført i en tekst konsol, som også i dag findes på meget netværksudstyr fra f.eks. 3Com og Cisco. 1.1. Læsevejledning Målet med denne guide ikke at lave et opslagsdokument, men et dokument man følger første gang, man sætter IP telefonipakken op og som sikrer at brugeren kan begynde at konfigurere en løsning. Dokumenentet vil derfor give én fast procedure som anviser hvordan man bruger IP telefonipakkeen i sin grundform. Denne gennemgang findes i Kapitel 3, Opsætning. Inden det tekniske afsnit vil vi gennemgå lidt af baggrunden, for at sikre forståelsen for den tekniske gennemgang. Desuden vil der blive givet anvisninger til valg af f.eks. hardware.kapitel 2, Forberedelser omhandler indgangsvinklen og systemets grænseflader. I teksten kan der forekomme forskellige former for kommentarer. Disse kommentarer er et forsøg på at give væsentlige informationer uden at forstyrre fokus på den øvrige gennemgang. Disse afsnit er følgende: Bemærk Indeholder baggrundsinformation som bidrager til overblikket og hjælper, hvis man vil uden for konteksten. Indholdet er altså ikke nødvendigt for at følge guiden punkt for punkt. Indeholder tip som giver informationer om processen. Informationerne kan hjælpe en, men er ikke nødvendige for gennemførslen af guiden Advarsel 1 * (asterisk) er et såkaldt wildcard som matcher alt. 1
Indledning Indeholder advarsler som er nødvendige for gennemførslen af guiden. Bør læses grundigt. 2
2. Forberedelser Vi ønsker med dette afsnit at skabe forståelse for den efterfølgende tekniske gennemgang. Vi mener, at den overordnede forståelse skal skabes før vi bruger tid på detaljerne. Man kan sammenligne dette afsnit med en opskrifts ingrediensliste: 1 server. 1 IP netværk. 2 klienter med tilhørende mikrofon og højtaler. I det følgende afsnit vil disse emner blive behandlet, sådan at de kan være parate inden Kapitel 3, Opsætning som vil svare til fremgangsmåden. 2.1. Indgangsvinkel Løsningen er baseret på en boot CD. Boot CD'en brændes fra en ISO fil som downloadse fra Ministeriet for Videnskab, Teknologi og Udvikling softwarebørs. CD'en kan boote de fleste x86 arkitektur 1 PC'er. CD'en sikrer at vi får et solidt system som er hurtigt at implementere, da man bare skal boote sin PC med CD'en i. Under opstarten lagres hele systemet i PC'ens RAM som sikrer at systemet ikke hele tiden skal læse fra CD'en 2. De unikke data gemmes via et script på et skrivebart medie f.eks. en harddisk, USB pen eller lignende. Løsningen er meget stærk og giver et sikkert system. Det er ikke umiddelbart muligt at installere et lille program, som kunne kompromittere sikkerheden. Opgradering og evt. nedgradering er en let sag, da system og data er pænt adskilt. Alle data ligger samlet og er lette at tage backup af. Løsningen dækker på denne måde serverdelen. Men serveren er den centrale del som tilbyder services til en række klienter. En typisk klient vil være en IP telefon som registrere sig hos serveren, men en klient kan også være en softphone eller et web interface som viser f.eks. køstatus. Løsningen er baseret på en Gentoo Linux som operativsystem og Asterisk. Den primære måde, at implementere og administrere løsningen, er via en tekst konsol. Der er ingen grafiske værktøjer af hensyn til driftstabilitet og det minimalistiske design. Tekst konsolen er et meget stærkt værkstøj, hvor samtlige driftopgaver kan udføres fra. Quick guiden vil komme omkring de mest nødvendige i denne samt efterfølgende dokumenter, men på internettet kan der findes utallige guides til, hvordan man vedligholder Linux operativsystemer. En af de rigtig gode referencer er [www.linuxbog.dk] som er frit tilgængelige på internettet. Vær dog opmærksom på at dette system er designet udelukkende til at opfylde de krav, der typisk er til en IP telefoncentral og ikke andet. Derfor er der skåret mange funktioner og programmer væk, hvilket betyder at det ikke er muligt, at udføre alle Linux komandoer på dette system. 2.2. Systemoversigt Systemet omfatter en server, samt eksempler på klienter i form af telefoner. For at binde klienter og ser- 1 De fleste standard PC'er er x86 kompatible f.eks. alle Pentium systemer. 2 Systemet bruger ca. 64 Mbyte RAM. 3
Forberedelser ver sammen skal der bruges et netværk med en række services. Grænseflader Pakken omhandler selve serveren (operativsystem og applikation) samt klienten. For at binde disse to sammen skal der bruges et IP netværk med en række specifikationer som vil blive behandlet senere. IP nettet kan også bruges til via en WAN forbindelse at komunikere med eksterne telefoner via en Service provider som f.eks. Musimi. Alternativt kan man selv lave denne trunkering via f.eks. et ISDN kort samt en ISDN forbindelse. Quick guide omhandler kun den røde boks. De øvrige elementer i systemet gennemgåes i Howto guide og Support guide. 2.3. Server Designet er udvilket med henblik på en appliance 3som kan rackmonteres og have et minimalt strømforbrug. Denne appliance er baseret på standard hardware og dermed kan de fleste standard PC'er bruges. Alt efter hvad slut målet er, bør man naturligvis vurdere, hvordan man skal bestykke sit hardware med hensyn til langtidsdrift, stabilitet, hukommelse, reservedelssituation mm. At beskrive disse emner vil være for omfattende for Quick guiden, men disse ting skal naturligvis overvejes i forbindelse med drift. I forbindelse med Quick guiden vil det være fordelagtigt at have tilsuttet tastatur og skærm til serveren og arbejde på denne lokalt. Efterfølgende kan man med fordel bruge et terminal program til at udføre vedligeholdelsesarbejde. Der er i Howto guiden et afsnit om, hvordan man bruger SSH til at administrer systemet. Serverne bør have minimum 256 Mbyte RAM og kan med fordel bestykkes med 1 Gbyte. RAM. Desuden bør der være en form for harddisk løsning. Der er flere muligheder, men det anbefalse at der 256 Mbyte harddisk i form af enten en traditionel harddisk 4, USB pen eller CF kort. Desuden bør der være et CD-rom drev og det skal være muligt at boote på CD-romen hvilket typisk sættes op via BIOS. Desuden vil det være en fordel at sætte maskinen op, sådan at den kan starte uden tastatur og mus. Disse options er typisk beskrevet i PC'ens manual. Desuden bør man, hvis man vil køre med ISDN hardware fra Digium, overveje at kontrollere kompatibi- 3 En specialdesignet server som kun indeholder hardware der er nødvendigt for opgaven. F.eks. er harddisken erstattet af et Compact Flash kort for at undgå bevægelige dele. 4 Harddisken skal være master disk på 2. IDE/ATA kanal, mens CD romen bør side på 1. IDE/ATA kanal. 4
Forberedelser litetsnoterne for de enkelte kort. 2.4. Netværk Serveren og telefonerne skal forbindes i et Ethernet netværk. Netværket skal køre TCP/IP og det vil være en fordel at have en DHCP server på netværket. Man bør være opmærksom på at SIP kaldsopsætning (UDP port 5060) og RTP stream (UDP f.eks. port 10000-20000) er tilladt på netværket. Der skal bruges op i mod 100 kbit/sek hver vej pr. samtale. En normal samtale indeholder mange pauser og stilhed, hvor der ikke transmiteres lyddata. At der skal bruges op i mod 100 kbit/sek. for for at overføre en 64 kbit talestrøm skyldes, at talen opdeles i meget små pakker (ca. 10 ms. talestrøm) som hver især skal udstyres med afsender- og modtager-information (header). 2.5. Telefoner I en traditionel telefoniløsning er alle telefoner forbundet til telefoncentral via to ledere, Dette betyder at hvis man flytter en telefoner får den også et nyt nummer, da dette er knyttet til stikket ikke telefonen. En IP telefon er mere intelligent i og med, at telefonen selv kontakter telefoncentral og registrer sig på denne med brugernavn og password. Disse tre instillinger skal kodes ind i telefonen, og når registringen er gennemført er der forbindese til telefoncentralen og dennes tjenester. Flyttes telefonen til et andet sted på netværket flytter nummeret med telefonen. I princippet kan telefonen flyttes et hvilket som helst sted hen på Internettet og stadig beholde sit nummer. Vi tager i Kapitel 3, Opsætning udgangspunkt i softphones. En softphone er en softwareklient som installeres på en PC. Med et headset kan PC'en bruges som telefon. Vi har valgt x-lite softphone til vores eksempler. En gratis version kan hentes på Internettet, og man kan hurtig begynde at teste løsningn uden at skulle købe hardwaretelefoner. Softphones er smarte, til brug på farten og til folk som er vant til at bruge deres computer til alt. Til professionel brug vil mange dog foretrække en hardwaretelefon, så man ikke skal starte PC'en, før man kan ringe. Vi vil forsøge at give alle de relevante informationer uden at binde os fast på x-lite, således at andre telefoner også kan bruges. Til vores eksempler med hardwaretelefoner har vi valgt telefoner fra SNOM. SNOM er valgt af primært 5 årsager: SNOM leverer professionelle forretningstelefoner og en professionel leverandør. SNOM har en fornuftigt portefølje fra små vægtelefoner til stor omstillingstelefoner med sidebord. SNOM's firmware er baseret på Open Source, hvilket betyder, at vi selv kan rette fejl og funktioner efter ønske. SNOM er en aktiv deltager i miljøet, og deres telefoner er derfor godt understøttet i Asterisk. SNOM har et simpelt system til at håndtere udrulning og vedligehold af mange telefoner (Auto provisioning). På samme måde som ved softphones sigter vi på at give en gennemgang som kan bruges på alle telefoner, uanset mærke og form, men tager udgangspunkt i ovenstående valg. 5
3. Opsætning Nu hvor forberedelserne er færdige skal vi endelig til at starte systemet. 1. For at gemme de konfigurationsændringer vi foretager i løbet af guiden, er det en fordel at have et skrivbart medie, hvor ændringerne gemmes. På CD'en er der et script, der gemmer konfigurationen. Det søger en række forskellige partitioner igennem i rækkefølge og den første FAT partition der findes vil blive brugt til at gemme konfigurationen på. Den prioriterede rækkefølge er som følger: 1. Første FAT partition på 1. USB/SCSI/SATA drev (/dev/sda) 2. Første FAT partition på 1. IDE drev (/dev/hda) 3. Første FAT partition på 2. IDE drev (/dev/hdb) 4. Første FAT partition på 3. IDE drev (/dev/hdc) Bemærk På Linux der betegnes Master disken på den primære IDE/ATA kanal /dev/hda, Slave disken som /dev/hdb, på den sekundære IDE/ATA kanal hedder diskene /dev/hdc og / dev/hdd. Partitions nummeret angives derefter, så den første partition på den Master disken på den primære ATA kanal hedder /dev/hda1. SCSI og SATA diske hedder /dev/sdxy, hvor x angiver om disken er Master/Slave og på hvilken kanal den sidder, den kan have værdierne a,b,c,d. y angiver partitionsnummeret, den første partition er normalt 1. Der undersøges kun for FAT partitioner - ikke NTFS. Indholdet på den pågældende partition bliver ikke slettet, der tilføjes blot to filer og først når scriptet køres. Vores anbefaling vil være at montere en harddisk som Master på den sekundære IDE kanal(/ dev/hdc1). Harddisken skal være formateret som FAT. Som Master på den primære IDE kanal (/dev/hda1) monteres CD-rom drevet. 2. For at komme rigtigt i gang, skal ISO filen brændes på en CD. På Windows kan det f.eks. gøres med NERO der følger gratis med mange CD-rom brændere. 3. CD'en sættes i CD-rom drevet, og der sørges for at computeren starter fra CD-rom drevet. 6
Opsætning Opstartsdrev kan typisk vælges ved hver start, på nogle computere ved at trykke F8 under opstart, på andre er det nødvendigt at ændre opstartsdrevet i BIOS. Typisk kan man komme ind i BIOS ved at trykke F1 lige efter at systemet er bootet. For nærmere instruktioner om hvordan dette foretages på dit system henvises til systemets/bundkortets manual. 4. Når maskinen er færdig med at boote skriver den: pbx login:. Her indtastes der root som brugernavn og afsluttes med Enter. Bemærk Brugeren root har normalt rettigheder til alt og svarer til Adminstrator kontoen på andre operativ systemer. Bemærk Hvis der ikke er nogen DHCP server på netværket konfigureres IP adressen manuelt. Se mere herom i Support guiden. 5. Som det første er det altid en god ide at skifte password for root brugeren. Ved New password og Re-enter new password indtastes et godt password: pbx ~ # passwd Changing password for root Enter the new password (minimum of 5, maximum of 127 characters) Please use a combination of upper and lower case letters and numbers. New password: Re-enter new password: Password changed. Password ændringen gemmes i Trin 26. Det vil sige, at hvis systemet genstartes før, vil passwordet være væk igen. Kommandoer i Linux konsollen kan auto completes med TAB. 6. Inden vi foretager nogle ændringer testes der for adgang til et skrivbart medie: pbx ~ # rw-sync.sh -t * Testing RW-partition... * RW-partition: /dev/hda1 * Total space: 103M * Free space: 102M * Use%: 1% * Mounted: (rw) * Backup file: 326kb * All tests passed successfully! 7
Opsætning Advarsel Hvis der opstår en fejl bør du sikre, at der er adgang til et skrivbart medie som beskrevet i Trin 1 og starte forfra. 7. Test så at der er forbindelse til Internet: pbx ~ # ping -c 1 www.google.com PING www.l.google.com (209.85.129.104) 56(84) bytes of data. 64 bytes from fk-in-f104.google.com (209.85.129.104): icmp_seq=1 ttl=243 time=28.9 ms --- www.l.google.com ping statistics --- 1 packets transmitted, 1 received, 0% packet loss, time 0ms rtt min/avg/max/mdev = 28.909/28.909/28.909/0.000 ms Forbindelse til Internet er ikke krævet for at gennemføre Quick guiden. 8. For at sætte Asterisk op skal vi have fundet ud af, hvilken IP adresse vi har fået af DHCP serveren: pbx ~ # ifconfig eth0 eth0 Link encap:ethernet HWaddr 00:00:24:C4:3F:24 inet addr:192.168.4.220 Bcast:192.168.4.255 Mask:255.255.255.0 UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 RX packets:114 errors:0 dropped:0 overruns:0 frame:0 TX packets:255 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:1000 RX bytes:16494 (16.1 Kb) TX bytes:64876 (63.3 Kb) Interrupt:10 Base address:0xa000 Noter IP adressen, der ses i anden linie af outputtet under inet addr:. 9. Da der kan være problemer med at få Asterisk til automatisk at finde IP adressen tilføjes den manuelt til /etc/asterisk/sip.conf. Dette gøres ved at starte nano editoren: pbx ~ # nano -w /etc/asterisk/sip.conf Rediger linien med bindaddr=0.0.0.0 og erstat 0.0.0.0 med IP adressen fra ifconfig outputtet under Trin 8: bindaddr=192.168.2.200 Dette fortæller Asterisk at den skal lytte på IP 192.168.2.200 efter SIP beskeder. Derefter skal SIP brugeren tilføjes til Asterisk konfigurationen, ved at tilføje følgende afsnit nederst i konfigurations filen: [sip-user1] type=friend host=dynamic context=incoming secret=very_secret_password Erstat very_secret_password med et passende password. Ovenstående opretter SIP brugeren sip-user1, af typen friend. Denne type kan både foretage 8
Opsætning opkald og modtage opkald. Brugeren har ikke nogen fast IP adresse og skal registrere sig på serveren. Ændringerne i nano gemmes ved at trykke CTRL-o efterfulgt af Return og redigeringen afsluttes med CTRL-x. Bemærk Brugere kan også oprettes vha. et simpelt webinterface. For at aktivere det skal der først genereres en password fil: pbx ~ # /root/bin/create_htdigest.sh admin 'Admin area' password > \ /etc/lighttpd/.passwd Dette opretter brugeren admin med passwordet password. Dernæst skal der redigeres i /etc/asterisk/sip.conf. Nederst i filen tilføjes følgende: #include sip_users.conf Dernæst skal der redigeres i /etc/asterisk/voicemail.conf. Nederst i filen tilføjes følgende: #include voicemail_users.conf Endelig skal webserveren startes op. Først i konfigurations filen til næste reboot, ved at redigere /etc/conf.d/gnap.conf. Til linien med START_SERVICES tilføjes lighttpd(flere services adskilles med mellemrum). Webserveren kan startes uden at genstarte hele serveren ved at køre: pbx ~ # /etc/init.d/lighttpd start Derefter kan webinterfacet tilgås på http://serverens.ip.addresse.her/upload_file.php. Se Support guiden for mere information om brugerhåndtering med webinterfacet. 10. Dernæst logges ind i Asterisk konsollen: pbx ~ # asterisk -r Asterisk 1.2.13, Copyright (C) 1999-2006 Digium, Inc. and others. Created by Mark Spencer ;<markster@digium.comi> Asterisk comes with ABSOLUTELY NO WARRANTY; type 'show warranty' for details. This is free software, with components licensed under the GNU General Public License version 2 and other licenses; you are welcome to redistribute it under certain conditions. Type 'show license' for details. ========================================================================= Connected to Asterisk 1.2.13 currently running on pbx (pid = 15965) Bemærk Hvis der er en fejl og Asterisk ikke er startet vil du få en besked i stil med unable to cennect to 9
Opsætning remote asterisk. Du kan prøve at bruge /etc/init.d/asterisk start. 11. Inden vi kan registrere softphonen på Asterisk serveren, skal vi have Asterisk til at genindlæse den opdaterede dialplan fra sip.conf: pbx*cli> sip reload Kommandoer i Asterisk konsollen kan auto completes med TAB. Bemærk Forskellen mellem Asterisk konsollen pbx*cli> og den almindelie konsol pbx ~ #. 12. Derfor forlades Asterisk konsollen med kommandoen: pbx*cli> quit Executing last minute cleanups pbx ~ # Og man er tilbage i den almindelige konsol. Flere gange i det kommende bliver der brug for at logge ind i Asterisk konsollen med asterisk -r og logge ud fra den igen med quit. 13. Installer x-lite 3.0. Programmet han hentes gratis fra www.exten.com [http://www.xten.com/index.php?menu=download] 14. Derefter sættes SIP kontoen op med oplysningerne fra Trin 9 og Trin 8. SIP konfiguration findes under menuen ved den lille trekant i toppen af X-Lite. SIP Account Settings dialog placering 10
Opsætning Athorization user name udfyldes med sip-user1 fra [sip-user1] i / etc/asterisk/sip.conf. Domain med IP adressen fra ifconfig outputtet under Trin 8. SIP Account Settings dialog konfiguration 15. I Asterisk er der allerede en demonstrations dialplan. Hvis din softphone er registreret på Asterisk serveren kan du ringe 1000 for at høre introduktion til Asterisk. I menuen kan du vælge mellem følgende: Tryk 2 Indtast 500 For at få mere information om Asterisk. For at ringe til en demonstrations server hos Digium i USA. 11
Opsætning Indtast 600 Indtast 1234 Indtast 8500 For at foretage en ekko test til en server hos Digium i USA. For at ringe til konsollen - Kræver bl.a. at Asterisk serveren har lydkort. For at ringe til telefonsvaren. 16. Efter at have prøvet demonstations dialplane er vi nu parate til at lave en simpel Asterisk dialplan selv. Asterisk konfigureres i en række konfigurations filer. Selve konfigurationen af hvordan enkelte opkald behandles, konfigureres i dialplanen. Denne findes typisk i filen / etc/asterisk/extensions.conf. Redigering af filen startes med: pbx ~ # nano -w /etc/asterisk/extensions.conf Derefter tilføjes følgende afsnit nederst i konfigurationsfilen: [incoming] exten => 4321,1,Echo() Dette gør det muligt at ringe 4321 fra softphonen og høre sit eget ekko. Extensions kan på dansk frit oversættes til lokale telefonnumre. Asterisk har en lang række applikationer som Echo der gør en lang række ting, som f.eks. afspille/optage lydfiler, databaseoperationer mv. 17. Log ind i Asterisk konsollen som beskrevt i Trin 10 og kontroller at x-lite har registreret sig på Asterisk serveren: pbx*cli> sip show peers Name/username Host Dyn Nat ACL Port Status sip-user1/sip-user1 192.168.0.123 D 2051 OK (25 ms) 1 sip peers [1 online, 0 offline] Hvis IP adressen på PC'en hvor X-Lite er installeret ikke fremgår af listen, så har den ikke registreret sig korrekt. Tjek at IP adresse, brugernavn og password er rigtigt sat op. Typisk vil det også fremgå af "displayet" på softphonen om den har registret sig. 18. Inden vi kan foretage det første prøveopkald skal vi have Asterisk til at genindlæse den opdaterede dialplan fra extensions.conf: pbx*cli> extensions reload 12
Opsætning 19. Nu er vi parate til at foretage det første prøveopkald, for at få lidt flere informationer om, hvad der sker kan verbose output slås til: pbx*cli> set verbose 5 Verbosity was 0 and is now 5 Derefter ringes der til 4321 fra softphonen. I Asterisk konsollen man følge med i, hvad der sker: -- Executing Echo("SIP/sip-user1-80107570", "") in new stack == Spawn extension (incoming, 4321, 1) exited non-zero on 'SIP/sip-user1-80107570' Først ses at Echo applikationen kaldes af SIP kanalen sip-user1 der er vores softphone. Tallet efter bindestregen er et unikt identifikationsnummer, der er nødvendigt, fordi den samme softphone kan have flere samtidige opkald. 20. Næste skridt er at sætte to softphones op og få dem til at ringe til hinanden. Derefter oprettes en ny SIP bruger med navnet sip-user2 i /etc/asterisk/sip.conf. Referer til Trin 9 for at se, hvordan den første SIP bruger blev oprettet. 21. Efter at SIP brugeren er oprettet skal vi have Asterisk til at genindlæse SIP konfigurationen. Det gøres med kommandoen: pbx ~ #> asterisk -rx "sip reload" -- Remote UNIX connection Reloading SIP == Parsing '/etc/asterisk/sip.conf': Found == Parsing '/etc/asterisk/sip_notify.conf': Found Bemærk Parameteret x til asterisk kommandoen gør at der forbindes til konsollen, kommandoen i gåesøjnene køres, og der logges ud af konsollen igen. 22. Dernæst skal softphonen sættes op med de nye brugeroplysninger. Referer til Trin 13 for at se, hvordan den første SIP bruger blev sat op. 13
Opsætning Kommandoen asterisk -rx "sip show peers" kan bruges til at se om den nye SIP bruger har registreret sig på Asterisk serveren. 23. Dialplanen skal ændres i [incoming] konteksten i /etc/asterisk/extensions.conf tilføjes følgende: exten => 1111,1,Dial(SIP/sip-user1) exten => 2222,1,Dial(SIP/sip-user2) Første linie gør at når der ringes 1111 vil der blive ringet op til den første SIP konto (sip-user1), og når der ringes 2222, ringes der op til den SIP konto, der lige er blevet oprettet (sip-user2). Referer til Trin 16 for at se, hvordan det blev gjort sidst. 24. Inden det første opkald kan foretages skal der logges in i konsollen igen med asterisk -r. I Asterisk konsollen skal den nye dialplan indlæses med extensions reload. 25. Fra den første softphone ringes der nu 2222. I Asterisk konsollen kan følgende output ses: -- Executing Dial("SIP/sip-user1-8011ff30", "SIP/sip-user2") in new stack -- Called sip-user2 -- SIP/sip-user2-80128330 is ringing -- SIP/sip-user2-80128330 answered SIP/sip-user1-8011ff30 -- Attempting native bridge of SIP/sip-user1-8011ff30 and SIP/sip-user2-80128330 == Spawn extension (incoming, 2222, 1) exited non-zero on 'SIP/sip-user1-8011ff30' Tillykke! Du kan nu foretage den første samtale med Asterisk IP telefoni. 26. Som beskrevet tidligere er det nu tid til at gemme de ændringer, vi har foretaget. Se mere under Trin 1 og Trin 6. Scriptet køres som følgende: pbx ~ # rw-sync.sh -w * Files Saved Som standard bliver alle filer i bibliotekerne /etc og /var/lib/asterisk og deres under biblioteker, gemt når scriptet køres. Asterisks konfigurationsfiler ligger i /etc/asterisk/. Derefter kan maskinen lukkes ned med kommandoen halt. For detaljeret output og en liste over de gemte filer kan verbose output slås til med rwsync.sh -v -w. Bemærk Hvis der skal tilføjes andre filer eller biblioteker gøres det f.eks. med /usr/bin/rw-sync.sh -a / root/ hvor /root/ erstattes med det filnavn eller bibliotek, man ønsker at gemme. 14
4. Afslutning Resultatet af Kapitel 3, Opsætning skulle gerne være en fungerende telefoncentral. Det kan måske ikke synes af meget, men en succes med Kapitel 3, Opsætning betyder at du nu sidder med en af verdens mest fleksible telefoncentraler. Mulighederne er uendelige - ikke bare kan I konfigurere alle tænkelige telefon tjenester, men du kan også selv udvikle nye og rette i den måde, som systemtet fungerer på, fordi kildekoden er fri tilgængelig. På almindelig hardware kan du uden problemer håndtere de fleste mellemstore virksomheder i Danmark og med almindelig enterprise hardware, vil du kunne håndtere op til 1000 brugere. Inden du kaster dig ud i en driftløsning vil vi dog anbefale en test fase. IP telefoni inddrager mange aspekter af organisationen - derfor anbefaler vi, at man prøver sig frem og opnår erfaringer med Asterisk, inden man sætter en løsning i drift. Løsningen rummer et utal af muligheder, og vi vil anbefale at du bruger tid på at sætter dig ind i dialplanen. I Howto guiden er der et afsnit, som omhandler dette emne. Der er også en række andre afsnit, som omhandler emner, som kan være relvante for netop jeres organisation. Figur 4.1. Dokumentaitonsoversigt Dokumentationsoversigten viser, at når testfasen nærmer sig sin afslutning vil vi anbefale, at Drift guiden gennemgåes. Her vil der være en række emner, som er relevante før en løsning kan sættes i drift. Support guiden indholder primært retningslinier om brugeroprettelse og er i forbindelse med forberedelser til drift. Bruger guiden indholder tips omkring dokumentation til telefonbrugerne. 15
Litteraturliste [www.linuxbog.dk] Peter Toft, Jacob Sparre Andersen, Hans Schou, Gitte Wange, Peter Makholm, Mads Dydensborg og Donald Axel. www.linuxbog.dk. Norman Walsh. The DocBook Schema. Working Draft 5.0a1, OASIS, 29 June 2005.. Bob Stayton. DocBook XSL: The Complete Guide. website [http://sagehill.net/docbookxsl/index.html]. David Rugge, Mark Galassi og ic Bischoff. Crash Course. website [http://opensource.bureau-cornavin.com/crash-course/index.html]. Tobias Reif. Vim as XML Editor. website [http://www.pinkjuice.com/howto/vimxml/index.xml]. [Asterisk - The Future of Telephony] Jim Van Meggelen, Jared Smith og Leif Madsen. Ophavsret 2005 O'Reilly Media, Inc. 0-596-00962-3. O'Reilly Media, Inc.. Asterisk. The Future of Telephony. 358. Mike Loukides. [Quick guide] Claus Lavdal og Sune Kloppenborg. Ophavsret 2007 Ministeriet for Videnskab, Teknologi og Udvikling. IP telefonipakke. Quick guide. [Resume] Claus Lavdal og Sune Kloppenborg. Ophavsret 2007 Ministeriet for Videnskab, Teknologi og Udvikling. IP telefonipakke. Resume. [Support guide] Claus Lavdal og Sune Kloppenborg. Ophavsret 2007 Ministeriet for Videnskab, Teknologi og Udvikling. IP telefonipakke. Support guide. [Drift guide] Claus Lavdal og Sune Kloppenborg. Ophavsret 2007 Ministeriet for Videnskab, Teknologi og Udvikling. IP telefonipakke. Drift guide. [Bruger guide] Claus Lavdal og Sune Kloppenborg. Ophavsret 2007 Ministeriet for Videnskab, Teknologi og Udvikling. IP telefonipakke. Bruger guide. [Howto guide] Claus Lavdal og Sune Kloppenborg. Ophavsret 2007 Ministeriet for Videnskab, Teknologi og Udvikling. IP telefonipakke. Howto guide. [The Linux Enterprise Cluster] Karl Kopper. Ophavsret 2005 NO STARCH PRESS. 1-59327-036-4. NO STARCH PRESS. The Linux Enterprise Cluster. Build a Highly Available Cluster with Commodity Hardware and Free Software. 464. 16