1. © Copyright AARNet Pty Ltd Iptel’s SIP Express Router (SER) SIP Proxy Server SIP Workshop AARNet By Stephen Kingham Stephen.Kingham@aarnet.edu.au

2. © Copyright AARNet Pty Ltd Outline and Objectives What is SER Installation Configuration (user and routing) Modules Authentication

3. © Copyright AARNet Pty Ltd What is SER? SIP Express Router Open Source, and can be commercially supported. It is a Location Server, a Proxy Server, and a Redirect Server. Very popular in the Research and Education Sector. Very efficient, very fast, handle huge call loads (New Yorks busy hour on a medium sized Pentium with 1Gbyte of RAM) Has Voice Mail. Has (SIMPLE Protocol) to Jabber interface for Instant Messaging and Presence. Has Web programming interface Can write your own modules to add features. Uses SQL database

4. © Copyright AARNet Pty Ltd Installation Easy to install. Source is available, so are a wide range of packages for a very large range of Unix platforms. Warning: The “how to”s for “webser” do not match the installations. Check out the install guide on the AARNet workshop pages, but will be moved to under Engineering – Projects The MySQL datsbase is called “ser” and the “database root” password (“heslo”) is hard coded into the source. To change the password you must change it in the source first and recompile.

5. © Copyright AARNet Pty Ltd SER administration Standard error messages from SER go to /var/log/messages Take a look at the “xlog” command in the ser.cfg file to send more information to /var/log/messages. You can turn on debugging and run from the command line. The programme “serctl”. Use this very useful programme for maintenance, as well as moves adds and changes.

6. © Copyright AARNet Pty Ltd Configuration /etc/ser/ser.cfg Once the configuration is changed restart with /etc/rc.d/init.d/ser restart Look for configuration errors look in /var/log/messages Use log and xlog commands in /etc/ser/ser.cfg to send information to /var/log/messages First half of /etc/ser/ser.cfg is loading modules and setting some default. Second half is how every SIP Message is processed

7. © Copyright AARNet Pty Ltd SER debug: use xlog Take a look at the “xlog” command in the ser.cfg file to send more information to /vor/log/messages. Into ser.cfg add loadmodule "/usr/lib/ser/modules/xlog.so” xlog(level, format): level = L_ALERT | L_CRIT | L_ERR | L_WARN | L_NOTICE | L_INFO | L_DBG Format = %rm : request's method %ru : request's r-uri %tu : 'To' uri %tt : 'To' tag %mi : SIP message id %pp : process id (pid) %is : IP source address % : '%' %Ts : unix time stamp %Tf : string formatted time %ci : call-id %cs : cseq %ct : contact header %fu : 'From' uri %ft : 'From' tag

8. © Copyright AARNet Pty Ltd Hands on The remainder of this session will be to review a complex example. Make test calls and review logs and protocol traces. Configuration information for the workshop can be found in the APAN SIP-H323 Working group pages.

9. © Copyright AARNet Pty Ltd Sources for information http://www.iptel.org A lot of web sites have their own look and feel, this one is no different!http://www.iptel.org Documentation on the “modules” that enable the commands: http://www.voip-info.org/tiki- likepages.php?page=SER+module+group or here: http://www.iptel.org/ser/doc/modules/html/http://www.voip-info.org/tiki- likepages.php?page=SER+module+group http://www.iptel.org/ser/doc/modules/html/ Excellent set of documents and initiative: http://voip.internet2.edu/SIP.edu/ http://voip.internet2.edu/SIP.edu/ http://www.aarnet.edu.au/engineering/projects/sip Google to find what a command does.