Table Of ContentFreeSWITCH 1.8
VoIP and WebRTC with FreeSWITCH: The definitive source
Anthony Minessale II
Giovanni Maruzzelli
BIRMINGHAM - MUMBAI
FreeSWITCH 1.8
Copyright © 2017 Packt Publishing
All rights reserved. No part of this book may be reproduced, stored in a retrieval system, or
transmitted in any form or by any means, without the prior written permission of the
publisher, except in the case of brief quotations embedded in critical articles or reviews.
Every effort has been made in the preparation of this book to ensure the accuracy of the
information presented. However, the information contained in this book is sold without
warranty, either express or implied. Neither the authors, nor Packt Publishing, and its
dealers and distributors will be held liable for any damages caused or alleged to be caused
directly or indirectly by this book.
Packt Publishing has endeavored to provide trademark information about all of the
companies and products mentioned in this book by the appropriate use of capitals.
However, Packt Publishing cannot guarantee the accuracy of this information.
First published: July 2017
Production reference: 1120717
Published by Packt Publishing Ltd.
Livery Place
35 Livery Street
Birmingham
B3 2PB, UK.
ISBN 978-1-78588-913-4
www.packtpub.com
Credits
Authors Copy Editor
Anthony Minessale II Safis Editing
Giovanni Maruzzelli
Reviewer Project Coordinator
Brian West Judie Jose
Acquisition Editor Indexer
Rahul Nair Aishwarya Gangawane
Content Development Editor Graphics
Abhishek Jadhav Kirk D'Penha
Technical Editor Production Coordinator
Aditya Khadye Aparna Bhagat
Manish Shanbhag
About the Authors
Anthony Minessale II is the primary author and founding member of the
FreeSWITCH Open Source Soft-Switch. Anthony has spent around 20 years working
with open source software. In 2001, Anthony spent a great deal of time contributing
code to the Asterisk PBX and has authored numerous features and fixes to that
project. In 2005, Anthony started coding a new idea for an open source voice
application. The FreeSWITCH project was officially open to the public on January 1
2006. In the years that followed, Anthony has been actively maintaining and leading
the software development of the FreeSWITCH project. Anthony also founded the
ClueCon Technology Conference in 2005, and he continues to oversee the production
of this annual event.
Anthony has been the author of several FreeSWITCH books, including FreeSWITCH
1.0.6, FreeSWITCH 1.2, FreeSWITCH Cookbook, FreeSWITCH 1.6 Cookbook, and Mastering
FreeSWITCH
I'd like to thank my wife Jill and my kids, Eric and Abbi, who were in grade school when
this project started and are now grown up. I'd also like to thank everyone who took the
time to try FreeSWITCH and submit feedback. I finally thank my coauthor Giovanni
Maruzzelli for working on this book.
Giovanni Maruzzelli ([email protected]) is heavily engaged with
FreeSWITCH. In it, he wrote a couple of endpoint modules, and he is specialized
in industrial grade deployments and solutions. He's the curator and coauthor of
FreeSWITCH 1.6 Cookbook (Packt Publishing, 2015), and of Mastering FreeSWITCH (Packt
Publishing, 2016)
He's a consultant in the telecommunications sector, developing software and
conducting training courses for FreeSWITCH, SIP, WebRTC, Kamailio, and OpenSIPS.
As an Internet technology pioneer, he was the cofounder of Italia Online in 1996,
which was the most popular Italian portal and consumer ISP. Also, he was the
architect of its Internet technologies Italia Online (IOL). Back then, Giovanni
was the supervisor of Internet operations and the architect of the first engine
for paid access to il Sole 24 Ore, the most-read financial newspaper in
Italy, and its databases (migrated from the mainframe). After that, he was the
CEO of the venture capital-funded company Matrice, developing telemail unified
messaging and multiple-language phone access to e-mail (text to speech). He was
also the CTO of the incubator-funded company Open4, an open source managed
applications provider. For 2 years, Giovanni worked in Serbia as an Internet and
telecommunications investment expert for IFC, an arm of the World Bank.
Since 2005, he has been based in Italy, and he serves ICT and telecommunication
companies worldwide.
I'd like to thank the Open Source VoIP and RTC Community (that's our ecosystem, where
FreeSWITCH is thriving because of the others). The whole FreeSWITCH Community, and
each single individual that day in and day out tests, documents, and helps each other in
implementing FreeSWITCH.
And I like to thank Tony, Brian, Mike, Ken, Italo, and Seven for the incredible efforts they
put into FreeSWITCH, and for the incredible results those efforts bears for us all to enjoy.
Thanks my guys!
Anthony Minessale II, you get a special personal thank you for bearing your role with so
much grace.
About the Reviewer
Brian West is a founding member of the FreeSWITCH team. He has been involved
in open source telephony since 2003. Brian was heavily involved in the Asterisk
open source PBX Project as a Bug Marshal and developer. In 2005, Brian joined the
initiative that eventually lead to the FreeSWITCH Open Source Soft-Switch. Today,
Brian serves as the general manager of the FreeSWITCH project and keeps the
software moving forward. Brian has countless skills as a developer, tester, manager,
and technologist, and he fills a vital role in the FreeSWITCH Community
www.PacktPub.com
For support files and downloads related to your book, please visit www.PacktPub.com. Did
you know that Packt offers eBook versions of every book published, with PDF and ePub
files available? You can upgrade to the eBook version at www.PacktPub.com and as a print
book customer, you are entitled to a discount on the eBook copy. Get in touch with us at
[email protected] for more details. At www.PacktPub.com, you can also read a
collection of free technical articles, sign up for a range of free newsletters and receive
exclusive discounts and offers on Packt books and eBooks.
https://www.packtpub.com/mapt
Get the most in-demand software skills with Mapt. Mapt gives you full access to all Packt
books and video courses, as well as industry-leading tools to help you plan your personal
development and advance your career.
Why subscribe?
Fully searchable across every book published by Packt
Copy and paste, print, and bookmark content
On demand and accessible via a web browser
Customer Feedback
Thanks for purchasing this Packt book. At Packt, quality is at the heart of our editorial
process. To help us improve, please leave us an honest review on this book's Amazon page
at https://www.amazon.com/dp/1785889133.
If you'd like to join our team of regular reviewers, you can e-mail us at
[email protected]. We award our regular reviewers with free eBooks and
videos in exchange for their valuable feedback. Help us be relentless in improving our
products!
Table of Contents
Preface
1
Chapter 1: Architecture of FreeSWITCH
7
Real-time communication without mysteries 7
The FreeSWITCH design - modular, scalable, and stable 9
Important modules - Endpoint and Dialplan 11
Complex applications made simple 15
Voicemail 15
Multi-party audio/video conferencing 18
FreeSWITCH API commands (FSAPI) 19
The XML registry 21
Scripting language modules 22
The demo configuration 22
Summary 24
Chapter 2: Building and Installation
25
Where to Install FreeSWITCH 26
Choice of Operating System 26
Linux 27
Windows 27
OS X (Mac) 27
*BSD 28
Packages or Source? 28
Installing FreeSWITCH 28
Debian 8 Jessie 28
From Packages 31
From Source 32
Windows 35
Summary 39
Chapter 3: Test Driving the Example Configuration
40
Important concepts to understand 41
XML Configuration 42
Regular Expressions 42
Call Legs 43
IVRs, Interactive Voice Response (Systems) 44
Extensions, Contexts and Profiles 45
