100 likes | 255 Views
Iptel’s SIP Express Router (SER) SIP Proxy Server. SIP Workshop AARNet By Stephen Kingham Stephen.Kingham@aarnet.edu.au. Outline and Objectives. What is SER Installation Configuration (user and routing) Modules Authentication. What is SER?. S IP E xpress R outer
E N D
Iptel’s SIP Express Router (SER)SIP Proxy Server SIP Workshop AARNet By Stephen Kingham Stephen.Kingham@aarnet.edu.au
Outline and Objectives • What is SER • Installation • Configuration (user and routing) • Modules • Authentication
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
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.
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.
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
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 = • %% : '%' • %Ts : unix time stamp • %Tf : string formatted time • %ci : call-id • %cs : cseq • %ct : contact header • %fu : 'From' uri • %ft : 'From' tag • %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
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.
Sources for information • http://www.iptel.orgA lot of web sites have their own look and feel, this one is no different! • 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/ • Excellent set of documents and initiative: http://voip.internet2.edu/SIP.edu/ • http://www.aarnet.edu.au/engineering/projects/sip • Google to find what a command does.