Mastering FreeSWITCH

Transcription

1 Mastering FreeSWITCH Master the art of advanced VoIP and WebRTC communication with the most dynamic application server, FreeSWITCH Anthony Minessale II Giovanni Maruzzelli BIRMINGHAM - MUMBAI

2 Mastering FreeSWITCH Copyright 2016 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 2016 Production reference: Published by Packt Publishing Ltd. Livery Place 35 Livery Street Birmingham B3 2PB, UK. ISBN

3 Credits Authors Anthony Minessale II Giovanni Maruzzelli Copy Editors Dipti Mankame SaÞ s Editing Reviewers Ayobami Adewole Brian West Commissioning Editor Amarabha Banerjee Acquisition Editors Neha Nagwekar Rahul Nair Content Development Editor Kajal Thapar Technical Editors Pramod Kumavat Mohita Vyas Project Coordinator Shweta H. Birwatkar Proofreader SaÞ s Editing Indexer Tejal Daruwale Soni Graphics Disha Haria Production Coordinator Arvindkumar Gupta Cover Work Arvindkumar Gupta

4 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 Þ xes to that project. In 2005, Anthony started coding a new idea for an open source voice application. The FreeSWITCH project was ofþ cially open to the public on January 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, and FreeSWITCH 1.6 Cookbook. 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 Þ nally thank my coauthor Giovanni Maruzzelli for working on this book.

5 Giovanni Maruzzelli 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). 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 ( Back then, Giovanni was the supervisor of Internet operations and the architect of the Þ rst engine for paid access to the most-read Þ nancial newspaper in Italy, and its databases (migrated from the mainframe). After that, he was the CEO of the venture capital-funded company Matrice, developing tel uniþ ed messaging and multiple-language phone access to (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 all people who made writing this book a challenging journey for me, all who helped, all who supported, all who gave me obstacles to overcome. This book has been brought to you by the knowledge that was socially cumulated by humans through the centuries, let's praise them. I Þ nally want to thank my coauthor Anthony Minessale II for being so patient and "Always See Everything."

6 About the Reviewers Ayobami Adewole is a software engineer and technical consultant with experience spanning over 5 years. Ayobami has worked on mission critical systems; these include solutions for customer relationship management, land administration and geographical information systems, enterprise-level application integrations, and uniþ ed communication and software applications for the education and business sectors. Ayobami is very passionate about VoIP technologies, and he continues to work on cutting-edge PBX solutions built on FreeSWITCH. In his spare time, he enjoys experimenting with new technologies. His blog is at My unending gratitude goes to my parents for instilling in me the culture of discipline and hard work. Brian West is a founding member of the FreeSWITCH team. He has been involved in open source telephony since 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 Þ lls a vital role in the FreeSWITCH Community.

7 Contributors Moises Silva wrote the entire 6 th chapter, PSTN and TDM. The following people contributed substantially to this book: Darren Schreiber Benjamin Tietz Russell Treleaven Seven Du (Du Jinfang) Muhammad Naseer Bhatti Florent Krieg Michael Jerris Iwada Eja Martyn Davies Charles Bujold Christian Bergamaschi Alexandr Dubovikov Lorenzo Mangani Dan Christian Bogos

8 ebooks, discount offers, and more Did you know that Packt offers ebook versions of every book published, with PDF and epub Þ les available? You can upgrade to the ebook version at and as a print book customer, you are entitled to a discount on the ebook copy. Get in touch with us at customercare@packtpub.com for more details. At 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. TM Do you need instant solutions to your IT questions? PacktLib is Packt's online digital book library. Here, you can search, access, and readpackt's entire library of books. 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

9 Table of Contents Preface vii Chapter 1: Typical Voice Uses for FreeSWITCH 1 Understanding routing calls in FreeSWITCH 2 Wholesale (provider to providers) 3 Residential uses of FreeSWITCH 4 Routing with federated VoIP 5 Dialers/telemarketing 6 FreeSWITCH Products and Services 8 Business PBX services (hosted and on-premises) 8 Call centers 9 Value added services and games, prizes, and polls 10 "Class 4" vs "Class 5" operations (and SBCs) 11 WebRTC / web services / Internet-only services 12 Mobile "over-the-top" SIP 13 Development 15 Strict on output, broad on input 15 Very structured, very reusable techniques 15 Polyglot by vocation and destiny 15 Extreme scalability, from embedded to big irons 16 Born internationalist 16 Telcos internal integration ("FreeSWITCH is the Perl of VoIP") 16 Rapid new services prototyping 17 Accounting and billing 18 Call Detail Records (CDRs) 19 Mod_nibblebill / CGrateS 20 Other billing options (open source - commercial) 21 Summary 21 [ i ]

10 Table of Contents Chapter 2: Deploying FreeSWITCH 23 Network requirements 23 Understanding QoS 24 LANs, WANs, and peering 25 Testing with SIPp 27 Running scenarios 27 Load testing 30 Logging with FreeSWITCH 30 Call Detail Records 32 Monitoring 34 SNMP 34 SNMP and FreeSWITCH 35 Installation and conþ guration (on Linux) 35 Getting more information 36 Monitoring tools 37 Monitoring with Nagios 38 Monitoring with Cacti 41 HA deployment 42 Storage, network, switches, power supply 43 Virtualization 44 Load balancing and integration with Kamailio and OpenSIPS 47 In the Web world 47 In the FreeSWITCH world 48 DNS SRV records for geographical distribution and HA 51 Summary 52 Chapter 3: ITSP and Voice Codecs Optimization 53 ITSPs what they do 54 Routes (to numbers) 55 DIDs (aka DDIs) numbers 56 Quality of routes 57 White, black, and grey 57 Codecs and bandwidth 58 Infrastructure capability 59 Various important features 60 Support, redundancy, high availability, and number portability 61 Summary 62 Chapter 4: VoIP Security 63 Latest versions of it all 63 Default conþ guration is a demo 64 Change passwords 64 Lock all that's not trusted 64 [ ii ]