ConMan. A Web based Conference Manager for Asterisk. How I Managed to get Con'd into skipping my summer vacation by building this thing

Size: px

Start display at page:

Download "ConMan. A Web based Conference Manager for Asterisk. How I Managed to get Con'd into skipping my summer vacation by building this thing"

Charity Floyd
6 years ago
Views:

1 ConMan A Web based Conference Manager for Asterisk -or- How I Managed to get Con'd into skipping my summer vacation by building this thing $90503&07 $: ,-47,94708 $90503&078:3.42 Sun Labs, slide 1

2 Program Goals Build a Web Interface to Asterisk management, monitoring, and control Feature Java & Solaris "Meetme" conferencing example: Existing conferencing GUI's for reference We need it Real-time asynchronous nature stresses the Web part of the system Sun Labs, slide 2

3 Key Components Sun Labs, slide 3

4 ConMan Design Goals Graceful in failure No impact on existing or future conferences if the web interface is unavailable Self contained meeting "appliance" Minimize external dependencies A small number of small conferences "90% have 12 or fewer participants" Design for 15, Test for 50 About a dozen simultaneous conferences Scalable by replication Sun Labs, slide 4

5 Design Strategy Static configuration files Asterisk Database for all dynamic data Manager interface Manage the Asterisk Database Control the meeting Process Asterisk events Sun Labs, slide 5

6 Asterisk-Web Communication Templates? Asterisk Database Dialplan Sun Labs, slide 6

7 Asterisk-Web Communication Manager Events Manager Commands AGI Manager Events Initiated from Asterisk No response Dialplan keeps going Manager Commands Initiated from Webserver Asynchronous to the Dialplan AGI (Asterisk Gateway Interface) Initiated from the Dialplan Synchronous: the Dialplan waits for response Sun Labs, slide 7

8 Asterisk Web Templates Manager Events Manager Commands AGI Manager Events <register key=meetme exp=${conf} queue=dst> <dequeue name=dst > <unregister key=meetme> Manager Commands <amicommand action="ami action" > AGI exten => s,1,agi(agi://my.host.com/sample.agi) <agi command="set extension ${ext}"> Sun Labs, slide 8

9 Manager Event issues ;0390.,330!7;00.,, %2089,25,3302,8907 $9,90#3,07 $905033,07,20$9050 &&336:0 6:0// 32 events ; $9,, $9!7;00.,, %2089, Problem ; !7;00.,, %2089,25,3302,8907 &&336:0 6:0// &8073:2 Key information is missing from some events Solution Events are connected by uniqueid Automatic information aggregation based on uniqueid Sun Labs, slide 9

10 System scaling and Redundancy Meetings may be distributed among many servers Web interface can connect to multiple meeting servers Retries and keepalives for intermittent connections Sun Labs, slide 10

11 Web Part Sun Labs, slide 11

12 Realtime Browser Architecture /232: :90;039 Page Template Form Processing Other events Events Markup Dynamic Updates Sun Labs, slide 12

13 Dynamic Update Processing XMLHttpRequest Waits for server event Server generates tuples: element id style class html replacement content JavaScript parses tuples updates content and styles Issues next XMLHttpRequest Sun Labs, slide 13

14 Brazil Template System (thumbnail sketch) Templates are HTML documents with extra tags Each extra tag is processed by the server, and replaced by HTML Information gathered during template processing is stored in variables The HTML result is sent to the browser* *approximately Sun Labs, slide 14

15 Sample HTML Template Browser View Sun Labs, slide 15

16 Sample HTML Template 0, 0,// , 0,// --4/ 4/ : :93, :93, ,220010/8 ;;,:,:00:8073:23:2-073,20.,3308,/ /82:90/9,24/ ,22002,9.;, ;,: :00)()()3(3,2.422,3/570503/6,, ,3/.422,3/ :0 : < ,.9 3,22006/,9, /09 2,9.2,9.< 2,510/8<, 99,-, /0-47/077.,., ,2,2006: ,., ,. 33,2,20010/ / ,2,20010/ , ,. 33,2, , ,. 33,2,20010/ /8 9/ 9/09 33,, <10/<9/ 9/ 1470, ,. 99,, / 4/ Sun Labs, slide 16

17 Sample HTML Template <head> <title>list conference Members</title> </head> <body> <form>conference number:<input name="conf" size="4"></form> <set name="fields" value="usernum number name channel isadmin ismonitored ismuted talkmode time > <set name="match value="([^!]*)!([^!]*)!([^\n]*)\n > <amicommand prepend="q" action="command command="meetme list ${query.conf} concise > <extract name="q.data" prepend="get" match="${match}" map="${fields}" all> <table border> <caption>conference <get name="query.conf"></caption> <tr> <foreach name="field" property="fields"> <th><get name="field"></th> </foreach> </tr> <foreach name="row" property="get.matchlist"> <tr> <foreach name="field" property="fields"> <td><get name="get.${row}.${field}"></td> </foreach> </tr> </foreach> </table> </body> Get conference number from form, put into template variable Sun Labs, slide 17

18 Sample HTML Template <head> <title>list conference Members</title> </head> <body> <form>conference number:<input name="conf" size="4"></form> <set name="fields" value="usernum number name channel isadmin ismonitored ismuted talkmode time > <set name="match value="([^!]*)!([^!]*)!([^\n]*)\n > <amicommand action="command" server="${asterisk}" command="meetme list ${query.conf} concise > <extract name="q.data" prepend="get" match="${match}" map="${fields}" all> <table border> <caption>conference <get name="query.conf"></caption> <tr> <foreach name="field" property="fields"> <th><get name="field"></th> </foreach> </tr> <foreach name="row" property="get.matchlist"> <tr> <foreach name="field" property="fields"> <td><get name="get.${row}.${field}"></td> </foreach> </tr> </foreach> </table> </body> Run Manager Command to get meeting participants Sun Labs, slide 18

19 Sample HTML Template <head> <title>list conference Members</title> </head> <body> <form>conference number:<input name="conf" size="4"></form> <set name="fields" value="usernum number name channel isadmin ismonitored ismuted talkmode time > <set name="match value="([^!]*)!([^!]*)!([^\n]*)\n > <amicommand prepend="q" action="command" command="meetme list ${query.conf} concise > <extract name="q.data" prepend="get" match="${match}" map="${fields}" all > <table border> <caption>conference <get name="query.conf"></caption> <tr> <foreach name="field" property="fields"> <th><get name="field"></th> </foreach> </tr> <foreach name="row" property="get.matchlist"> <tr> <foreach name="field" property="fields"> <td><get name="get.${row}.${field}"></td> </foreach> </tr> </foreach> </table> </body> Extract the output into template variables Sun Labs, slide 19

20 Sample HTML Template <head> <title>list conference Members</title> </head> <body> <form>conference number:<input name="conf" size="4"></form> <set name="fields" value="usernum number name channel isadmin ismonitored ismuted talkmode time > <set name="match value="([^!]*)!([^!]*)!([^\n]*)\n > <amicommand prepend="q" action="command" command="meetme list ${query.conf} concise > <extract name="q.data" prepend="get" match="${match}" map="${fields}" all> <table border> <caption>conference <get name="query.conf"></caption> <tr> <foreach name="field" property="fields"> <th><get name="field"></th> </foreach> </tr> <foreach name="row" property="get.matchlist"> <tr> <foreach name="field" property="fields"> <td><get name="get.${row}.${field}"></td> </foreach> </tr> </foreach> </table> </body> Generate the table Sun Labs, slide 20

21 Asterisk Part Sun Labs, slide 21

22 ' B A #, Meetme Options < 7 )? D 8 : Some are per-conference Some are per user 9 = They can only be specified in the Dialplan 0,( /578%4 Sun Labs, slide 22

23 MeetMe Issues Not all state changes generate events Lock / Unlock Entire conference state not provided with meetme list Resolution: Add missing manager events Extend meetme list A Submit changes to bug tracker, B < Sun Labs, slide 23

24 Managing Meetme Dialplan Commands MeetMeAdmin(eklLmMnNrsStTuUvV) CLI commands meetme list lock unlock mute unmute Manager Commands meetme mute unmute DTMF B A <? Sun Labs, slide 24

25 Managing Meetme Only MeetMeAdmin exposes all of the meetme options Run MeetMeAdmin from the Manager Interface with originate Use local channels, the extension, and channel variables to pass parameters A, <? B Sun Labs, slide 25

26 Putting it Together Sun Labs, slide 26

27 MeetMe Setup Meeting configuration entered from web page Stored in ASTDB via AMI in a ready-to-use format 5- /,9,-, , ,:.431,/238 8,: /% /%4,8.4312,: ;0 5:-. Referenced in dialplan to set meeting options 82510//,5, #0,/ #0,/5, *$%$ <5,88<4598< < < Sun Labs, slide 27

28 Meetme Control <amicommand action=originate Variable=cmd=${action}${user} Application=Noop > action: originate channel: variable: command=m1 application: Noop Web Template Manager Command Dialplan [ami-admin] exten => _X.,1,MeetMeAdmin(${EXTEN},${cmd:0:1},${cmd:1}) exten => _X.,n,Hangup() Sun Labs, slide 28

29 ConMan Dialplan 2 3 * +! 3 2 & # % 1 0 /. -, * +$ ) ' (! L K E C J & # $% Z > 4 " = H AI X Y O! < 7: A 7 ; G? W : ; B F U V E F P T S T 9 D R 8 C Q ` e d c b b a ` _ ^ 6 47 A?B O MP ] \ N 4? M [ ò ö ä ý ç ø ÿ þ ä æ û ö ý ä ü š Ã Â Á Õ À â Äá w Ž ¾ á Ä { ¼ ½ Æ àþ ð ôô { Æ ß u x Í Þ û äñ ú u» Ý ø u Ê ç º Ü ä x ù ¹ Û ç Æ ä Î { Œ Î Ö ð äñ Õ ç Æ Í ù x Š { Ù ³ µ ÚÖ ñ ø u Ó ² Ó Å ö w ± w Ø È æ äñ ç Ó ä u ˆ Æ ä Î q u Î Ö ê n t ƒ w { ª«Ñ ÔÕ ô äõ Û ó Ó Å Ð Þ ò æ ê rss q m u Ò Ñ h u Ï Ð ãíí Û Ë ä Î Íð ñä p Í ß ï o n lh } ~ i l m x Æ { ž Ì Í Ç Ë Î ÇÆ î ì í Ð Ê Ë Ç Ê Ë ç ë ê ë k z É É é j y Ÿ È È è h fi w ux ž Æ ÄÇ Æ ÄÇ æ äç g v œ Å Å å f u Ä Ä ä Prompt for Conference number and password (if required) Extract meeting options from Asterisk Database using conference number and password $ # S 9 4 R 4S Q P 9 A 9 O ~ } ~ } x { z y x w v q ] $ t pu W $ $! Z # n rs q + $ H Y ] 8 3 E 2 E F B GH p ` 9 5 Ab no A # 1 / "0 B GH M N9 C D@ Z ` L 4d b 9 9 A : 4. C D@ m` Z G % 8 B GL B 4S c k 9 l A k E ' % E F a A j &"" - % +,, C D5 H B : 8 : C D@ i K 4e fg h E $ $! " 9 * # E F C B? V d 5 J? >4 b c a? A U "! ( ) 8 > = > 4 8 < = 9 = I A < = 9 = T AA Ỳ _` < = 9 = Z^ < = ]^ ; ; ; ; \ : : : : [ Š Š Ž ˆ Œ ˆ Š ˆ Y WZ X W ƒ Ì Ë Ê É È Ç Æ Å Ä Ã À ÁÂ ½ «¾ ¼ µ» º «± ³ º ¹ ³ µ ³ ± ² ð Ü ì ê Ü ç ï Ü ê æ ì Þ ý ñ ú ô ÿ û ñ ó ú ñ ÿ ÿ ô ÿ ñ ô ñ ñ ô ÿ ý U S E T H CO G Q H Q œ Ÿ ï æç ó ûü ÿ C «î & R } S Ž ê ý á ó C N e í ä ÿû T C } h e e œ Ì Þ S ¼»Ø æ Ý ÿ ü M g eš g h Ø ª «í ú ñ û R p p h C ó? D { ³ ì ÿ Ù Þ 5 > Q } z e y ž 4 ë š»ø ü ú P = - E g m š x w g Ý û ê % :. C J ƒ u v é ô 4 K } hr st Ö ã ÿ ÿ = p Õ Õ Ë ç Î æ ó ñ < { - z 8 I O y r s e œ g ô ; N m x h ô ñ Õ ù ÿ M w : L ² â è 1 u vn p g p e ñ # ç $ 9 K 8 ¹ æ ý ù ¹ å û ñü ý # 7 K ù û " š ¼ ä û ý ä Õ Þ þÿÿ Ô ± Ó ã ý ø ó þÿÿ ý ø! 6 * E r st m o { m c J ^ 5 ý ó õ ) -? I d`` a g ki p e x Œ q p ñ Ò â Ÿ ž á ú ûü ñ ù ú ûü ù ûü ù ' ) 4> H G c ] g oe r s tu v g k š ú 3 4' 2 4' E \ e F ú ÿù 2 = œ ñ à ü Ñ Þ š Ð ß ù ôñ Ð ô Þ ø ô ø ù ñ ñü ó ø ô ø ô ø ÿ ó ø ô ø # ñ 1 ø ô ø / 0 ) ø = E X ab n oe n e Še pn g -. *. m C ^_` e g -. Y F E \ ] h l ~ p ˆ k l h l k l h l k l Ï ö ö ö ö ö ö,, D [ j j j Î Ý õ õ õ õ õ õ + + Z i i i Ü «Û ó ñô ó ñô ó ñô ó ñô ó ñô ó ñô ) '* ) '* B C X VY g eh g eh g eh Í ò ò ò ò ò ò ( ( W f f f «Ú ñ ñ ñ ñ ñ ñ ' ' A V e e e } g oe e o Ð Ú Í Ð Ì Ù Ð Í Ë Ú ö õ ç ôé Þ ë ò óñ Î } k Ç Ð Û ñ Š Í Þ e ± k f Å Æ «Û Ö ç Ûè È o Ä Ì Þ ƒ Ã Â Á Ù Ë ë ñ h À ç Ý p Ø r s ½ ¾ ð ³ Û ± h ³ ¼ n p µ Ö ï ë Þ m ª Ë Õ Û { m ³ µ Í í ãî } ² Ð n ± q x ³ µ pp } l s tu v ² ³ µ Ô ê ëì Ó é r e g n ±» ³ p ² Ó Ï Ý á ö Ý ß ö þ ë è Û å º Ò Ñ ç èû å ä å ÞÝ ø æ Ð æ æ ë ÿ g g n hp ~ p h k l h l ¹ å Ý ² Î Ï ä ã k l «««Þ â Û Ý Ë Í á â Þ â ù ë á â Þ â ý ÿ á â j j ª ª ª à à à þ ÿ i i g eh g eh Ê Ë Ì ß ß ß ý ü Ý ÛÞ Ý ÛÞ Ý ÛÞ û f f Ü Ü Ü e e É Û Û Û ú Start the conference! " 1 ( + 0 ( / & ) *,,., - * * + * * & ) ( ' & % $ # > : 4@ Q A E I W E C M EG E P[ 9 > = 4 O PC L M Y N PC N N Z M : ;< K L E F J X C E R Z I J F J I J F J I J W V M I O MF C U T CE S R CC H G E CF D C H G E CF D C H G E CF D C h b c b g ` b c b f e d ` b _ ` b c b a ` ^ _ ^ ] \ v { iy l i ƒ l i x iy l r ƒ y r } lr k r l s r r ~ } { z k o k i n m k il j i x yi q t w u v p v t k k y u q yi t r s k q lr r l o p l p o p n m k il j i Ž Œ Ž Œ Š ˆ Â «ª º ¹ ¹ ÀÁ ¾ ¼± Í ¼ ² È ² ± ³ µª ² É Æ«± Ì ³ ³ µª Ë ª ª ³ ² ª± ¾ ± à ß Þ ½ ¾ Ý ¼ Ü ª ª» ¼ Â Ê Ä Ú ÛÕ œ «««Õ Ù Ÿ Ø Ù ž œ š ª «¼ ± Â «ª ª ² É ª ª ¼ Â «Ä Ç «È Å ÆÇ ¾ ± ¼ Ä Ã º Â «Ä ¼ ± Í ª «º Ï Ð Æ² Ç Â «Æ É ÆÑ Ð «Æ Î Ï «¼ Ç É ª ª «Ö Ô ÒÕ Ó Ò Sun Labs, slide 29

30 ConMan Conference Features User Administration Creation & Management Selection Monitoring & control Sun Labs, slide 30

31 Summary Sun Labs, slide 31

32 Connector Summary Event aggregation Keyword mapping Event Broadcast and filtering Multiple servers Keep-alives Connection retries Sun Labs, slide 32

33 The Numbers Client Content Generation 9 HTML templates, 1626 code lines 120 lines of JavaScript code Asterisk Manager Connector 1260 lines of Java code Dialplan 60 lines in extensions.conf Web Performance 240 pages/second (Pentium 4, 2.8GHZ) Sun Labs, slide 33

34 Key Insights Model-View-Controller Effective for asynchronous web updates The Asterisk Database built-in Easy web access Easy dialplan access The "473,90" command permits arbitrary dialplan access Sun Labs, slide 34

35 Lessons Learned Manager API OK, a few tweaks would make it even better Meetme works great, lacks parsimony in command set Getting the GUI right is hard Ajax Sucks! Sun Labs, slide 35

36 ConMan Demo Mini Solaris Server: - Running Asterisk (meetme) - Running Brazil Web Framework Sun Labs, slide 36

37 Resources experimentalstuff.com/technologies/brazil Brazil Framework Solarisvoip.com Solaris Asterisk Packages svn.sunlabs/com/svn/solaris-asterisk Patched version of MeetMe experimentalstuff.com/technologies/asterisk ConMan demo Sun Labs, slide 37

Pointers & Arrays. CS2023 Winter 2004

Pointers & Arrays. CS2023 Winter 2004 Pointers & Arrays CS2023 Winter 2004 Outcomes: Pointers & Arrays C for Java Programmers, Chapter 8, section 8.12, and Chapter 10, section 10.2 Other textbooks on C on reserve After the conclusion of this