Mastering FreeSWITCH电子书

Mastering FreeSWITCH

Table of Contents

Mastering FreeSWITCH

Credits

About the Authors

About the Reviewers

Contributors

www.PacktPub.com

eBooks, discount offers, and more

Why subscribe?

Preface

What this book covers

What you need for this book

Who this book is for

Conventions

Reader feedback

Customer support

Downloading the example code

Errata

Piracy

Questions

1. Typical Voice Uses for FreeSWITCH

Understanding routing calls in FreeSWITCH

Wholesale (provider to providers)

Residential uses of FreeSWITCH

Routing with federated VoIP

Dialers/telemarketing

FreeSWITCH Products and Services

Business PBX services (hosted and on-premises)

Call centers

Value added services and games, prizes, and polls

"Class 4" vs "Class 5" operations (and SBCs)

WebRTC / web services / Internet-only services

Mobile "over-the-top" SIP

Development

Strict on output, broad on input

Very structured, very reusable techniques

Polyglot by vocation and destiny

Extreme scalability, from embedded to big irons

Born internationalist

Telcos internal integration ("FreeSWITCH is the Perl of VoIP")

Rapid new services prototyping

Accounting and billing

Call Detail Records (CDRs)

Mod_nibblebill / CGrateS

Other billing options (open source - commercial)

Summary

2. Deploying FreeSWITCH

Network requirements

Understanding QoS

LANs, WANs, and peering

Testing with SIPp

Running scenarios

Load testing

Logging with FreeSWITCH

Call Detail Records

Monitoring

SNMP

SNMP and FreeSWITCH

Installation and configuration (on Linux)

Getting more information

Monitoring tools

Monitoring with Nagios

Monitoring with Cacti

HA deployment

Storage, network, switches, power supply

Virtualization

Load balancing and integration with Kamailio and OpenSIPS

In the Web world

In the FreeSWITCH world

DNS SRV records for geographical distribution and HA

Summary

3. ITSP and Voice Codecs Optimization

ITSPs – what they do

Routes (to numbers)

DIDs (aka DDIs) – numbers

Quality of routes

White, black, and grey

Codecs and bandwidth

Infrastructure capability

Various important features

Support, redundancy, high availability, and number portability

Summary

4. VoIP Security

Latest versions of it all

Default configuration is a demo

Change passwords

Lock all that's not trusted

Dropping root privileges (file permissions)

Fail2ban on all services

FreeSWITCH jail

SIP(S) and (S|Z)RTP

Encrypting SIP with TLS (SIPS)

Encrypting (S)RTP via SDES (key exchange in SDP)

Encrypting (S)RTP via ZRTP (key exchange in RTP)

New frontiers of VoIP encryption (WebRTC, WebSockets, DTLS)

Summary

5. Audio File and Streaming Formats, Music on Hold, Recording Calls

Traditional telephony codecs constrain audio

HD audio frontiers are pushed by cellphones, right now

FreeSWITCH audio, file, and stream formats

Audio file formats

MP3 and streaming

Music on Hold

Playing and recording audio files and streams

Recording and modifying prompts and audio files

Recording calls

Tapping audio

Summary

6. PSTN and TDM

OpenZap

FreeTDM

I/O modules

Signaling modules

ISDN signaling modules

Analog modules

MFC-R2

SS7

Cellular GSM / CDMA (ftmod_gsm)

FreeTDM installation

Wanpipe drivers

DAHDI drivers

LibPRI

Sangoma ISDN stack

OpenR2

LibWAT

Analog modules

Configuring FreeTDM

Wanpipe

DAHDI

FreeTDM library configuration

FreeSWITCH configuration

Operation

Outbound calls

Inbound calls

Debugging

Checking the physical layer

Enabling ISDN tracing

Audio tracing

Summary

7. WebRTC and Mod_Verto

WebRTC

Browsers are already out there, waitin'

Web Real-Time Communication is coming

Under the hood

Encryption – security

Beyond peer to peer – WebRTC to communication networks and services

WebRTC gateways and application servers

Which architecture? Legacy on the Web, or Web on the Telco?

FreeSWITCH accommodates them ALL

What is Verto (module and jslib)?

Configure mod_verto

Test with Communicator

Build Your Own Verto App

Summary

8. Audio and Video Conferencing

Conference basics

Conference.conf.xml (profiles, DTMF interaction, and so on)

Configuration sections logic

Profile

Caller-Controls group

Conference invocation, dialplan, channel variables

Outbound conference

Moderating and managing conferences – API

Video conference

Video conference configuration

Mux profile settings

Video conference screen layouts

Screen sharing

Screen sharing dialplan extension

Managing video conferences

Conference performances

Summary

9. Faxing and T38

What is Fax on PSTN?

How it works

What is Fax over IP?

Enter T38

T38 terminals and gateways

Fax and FreeSWITCH

The mod_spandsp configuration

mod_spandsp usage

Debugging faxes

How to maximize reliability of fax traffic

PDF to fax and fax to PDF

Fax to mail

HylaFax and FreeSWITCH

ITSPs and Real World Fax Support

Summary

10. Advanced IVR with Lua

Installing IVR

Structure of welcome.lua

Incoming call processing

Before answering

First voice menu

Second and third voice menus

Fourth menu – asynch! Nonblocking! Fun with threads!

After hangup

Utility functions

Summary

11. Write Your FreeSWITCH Module in C

What is a FreeSWITCH module?

Developing a module

Mod_Example outline

Mandatory functions

Load function

Runtime function

Shutdown function

Configuration using XML

Reacting to channel state changes

Receiving and firing events

Dialplan application

API command

Summary

12. Tracing and Debugging VoIP

What can go wrong?

What else can go wrong? (NAT problems)

Other things can go wrong too

SIP, RTP, SDP, RTCP, OH MY!

Tools

Firewall

FreeSWITCH as SIP self tracer

Tcpdum – the mother of all packet captures

ngrep – network grep

tshark – pure packet power

pcapsipdump

sngrep – the holy grail

Sipgrep, Ngrep on steroids for VoIP

Wireshark – "the" packet overlord

Audacity – audio Swiss army knife

SoX – audio format converter

Summary

13. Homer, Monitoring and Troubleshooting Your Communication Platform

What is Homer?

Installing Homer and the Capture Server

Feeding SIP signaling from FreeSWITCH to Homer

Searching signaling with Homer

Feeding SIP signaling, QoS, MOS and RTP/RTCP stats from CaptAgent to Homer

Correlating A-leg and B-leg

Feeding logs and events to Homer

Logs to Homer

FreeSWITCH events to Homer

Summary

Index