trixbox CE 2.6 Implementing, managing, and maintaining an Asterisk-based telephony system Kerry Garrison BIRMINGHAM - MUMBAI This material is copyright and is licensed for the sole use by Mauricio Esquenazi on 21st July 2009 10 Kenmare St. #4, , New York, , 10012 trixbox CE 2.6 Copyright © 2009 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 author, Packt Publishing, nor its dealers or 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 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: February 2009 Production Reference: 1190209 Published by Packt Publishing Ltd. 32 Lincoln Road Olton Birmingham, B27 6PA, UK. ISBN 978-1-847192-99-8 www.packtpub.com Cover Image by Damian Carvill ([email protected]) This material is copyright and is licensed for the sole use by Mauricio Esquenazi on 21st July 2009 10 Kenmare St. #4, , New York, , 10012 Credits Author Editorial Team Leader Kerry Garrison Akshara Aware Reviewers Project Manager Alan H Miller Abhijeet Deobhakta Bruce Letterle David Merel Project Coordinator Jan Bjorkhaug Lata Basantani Kristian Kielhofner Michael D Mosier Indexer Monica Ajmera Acquisition Editor Rashmi Phadnis Proofreader Chris Smith Development Editor Dhiraj Chandiramani Production Coordinator Aparna Bhagat Technical Editor Mithun Sehgal Cover Work Aparna Bhagat This material is copyright and is licensed for the sole use by Mauricio Esquenazi on 21st July 2009 10 Kenmare St. #4, , New York, , 10012 About the author Kerry Garrison has spent over 20 years in the IT industry and was introduced to Asterisk by a long-time friend. After getting Asterisk running at home and finding the Asterisk@Home project to make doing installations even easier, Kerry began writing technical articles about using the system to run a business-grade phone system. After seeing the response to his talk about Asterisk@Home at Astricon in 2005, Kerry decided to write the first book about the system. Before the book went to print, the project was renamed to trixbox. After many rewrites to try to stay current, the first Trixbox Made Easy book was finally published with some additional help from Barry Dempster. Shortly after the first book was published, Fonality, the sponsor of the trixbox project, hired Kerry as the trixbox project manager to work alongside Andrew Gillis to keep the project moving forward, and he worked as the Community Director at Fonality until January of 2009. Today, Kerry is doing consulting work again, and working on his new project (http://pbxtutorials.com). This material is copyright and is licensed for the sole use by Mauricio Esquenazi on 21st July 2009 10 Kenmare St. #4, , New York, , 10012 The following people have contributed code, their writing, and/or their inspiration to help make this new book possible: My Family Without the support of my wife and family putting up with my rants about "I swore I would never write another book", this new book would never have happened. Credits to the family would not be complete without mentioning my dog Lola, who sat by my side during the entire writing of the book and provided a nice break whenever she needed to go for a walk. Andrew Gillis While not his intention to help create a revolution in the telephony market, Andrew's little basement project made it simple for millions of users to learn how to use these powerful tools. Tim Yardley Known to the world as "Engineer Tim", Tim worked on the trixbox CE project during 2008 as the build engineer. His contribution of information on how to secure a trixbox system was a huge contribution to this book. This material is copyright and is licensed for the sole use by Mauricio Esquenazi on 21st July 2009 10 Kenmare St. #4, , New York, , 10012 About the reviewers Alan H Miller earned a Bachelor's degree in Chemistry from Northwestern University, Evanston, IL. He worked briefly in the materials science research field before moving into the area of computer application design, development, and product management. The telecommunications industry has provided him with stimulating and rewarding opportunities for the majority of his professional career. The following is the Alan's list of employers: • Tel Aviv University, Ramat Aviv, Israel • Northwestern University, Chicago, IL, US • Scientific Information Retrieval, Inc., Evanston, IL, US • ROLM Corporation, Chicago, IL • IBM Corporation, Chicago, IL • Siemens, Chicago, IL; San Jose, CA; Munich, Germany Bruce Letterle has worked in the technology industry since 1979 with a variety of system integration firms. He founded Creative Web Technologies in 1996, a software integration firm that specializes in open source products. This material is copyright and is licensed for the sole use by Mauricio Esquenazi on 21st July 2009 10 Kenmare St. #4, , New York, , 10012 David Merel is the founder and CEO of ThinkBright LLC (www.thinkbright.net), a cutting-edge Voice over IP carrier providing businesses of all sizes with sophisticated and low cost VoIP solutions. David started ThinkBright in 2005 and continues to manage the company and its employees, all of whom are dedicated IT professionals. He acts as the company's chief architect, designing new technologies that have added significant revenues to the company's operations. During his years at ThinkBright, David has worked with the latest Voice over IP technology, including all VoIP equipment from major manufacturers such as Cisco, Polycom, Grandstream, and Aastra. He also works with customers ranging from small businesses to Fortune 500 companies, and interacts with system integrators and IT consultants who call ThinkBright on a daily basis for assistance with all of the VoIP solutions that Thinkbright offers. ThinkBright manages hundreds of PBX systems, providing customers with PBX features such as Auto Attendants, Waiting Rooms, and Ring Groups, and also provides SIP or IAX services for customers managing their own PBX system. David has many years of experience with trixbox and Asterisk, and has installed countless custom configurations and deployments using those solutions. David earned a Bachelor of Arts triple majoring in philosophy, politics, and law from SUNY Binghamton. David holds a CCNA (Cisco Certified Network Associate) certificate and is proficient in over 10 programming languages and databases, various operating systems, VoIP and related communication solutions, and other open-source business applications. Jan Bjorkhaug was born in Bergen on the west coast of Norway, 49 years ago. He is happily married with four children ranging from 17 months to 25 years of age. He is the CEO of Omnipro, Netsecur, and VoIPtel. During the last 15 years, Jan has established five IT ventures located in Norway, the Philippines, and most recently the VoIPtel Distribution Central located in Breda, the Netherlands. He, Bruce, and Adelina, they are currently responsible for the VoIPtel CE and SE firmware used by the embedded open-source series of IP PBXs manufactured by Atcom Technology Co. Ltd. These small but powerful PBXs are made available through their webshop as well their network of international retailers. This material is copyright and is licensed for the sole use by Mauricio Esquenazi on 21st July 2009 10 Kenmare St. #4, , New York, , 10012 For more information, please visit http://voiptel.no or http://blog.voiptel.no. I would like to thank my son Bruce for his invaluable input during my review of this book, as well as my wife Aileen Joy and the rest of my family for their enormous patience and understanding when my work kept me away from them. Kristian Kielhofner is VP, Systems Engineering for Star2Star Communications, developer of an end-to-end VoIP architecture. Kristian is responsible for the design and implementation of Star2Star's VoIP services. When he's not consulting or working for Star2Star, he enjoys tinkering with one of his FOSS projects—AstLinux, Runnix, or Recqual. You can find out what else Kristian is up to on his blog at http://blog.krisk.org. Michael D Mosier started messing around with computers when he was 8 years old, on a TRS 80. He has a BFA in both Drawing/Painting and Graphic Arts and a minor in Computer Science. He has been in the IT business for over 20 years, working with setting up the first networks in several Graphic Design firms and Printing companies. He started learning Asterisk and trixbox about four years ago as a way to teach himself IP-based phone systems. Knowing that technology was moving toward all IP-based systems, he thought it would be a great way to get his company and himself a jump on the new technology. He is one of the Principals at Select Phone Solutions in Houston, Texas. They have trixbox work all over the states of Texas and Louisiana. They have been successfully installing trixbox CE for over two years. He also holds the technician FtoCC. This material is copyright and is licensed for the sole use by Mauricio Esquenazi on 21st July 2009 10 Kenmare St. #4, , New York, , 10012 Table of Contents Preface 1 Chapter 1: Introduction to open source PBX systems 7 What is a PBX? 7 Traditional PBX 8 Hybrid PBX 8 Open telephony projects 9 The open source dilemma 10 The PSTN 10 Voice over IP 11 Asterisk—the brain of the PBX 12 What Asterisk isn't 14 Config files—the barrier to entry 14 Additional Asterisk information 15 The history of Asterisk 16 Summary 17 Chapter 2: What is trixbox? 19 Asterisk@Home to trixbox—the name change 19 trixbox, trixbox CE, Pro, SE, EE, CCE? 20 Prerequisite skills 20 trixbox components 20 What is trixbox CE all about? 21 Difference between Asterisk and trixbox 22 The limitations of trixbox 22 Fonality support of trixbox CE 22 trixbox CE features 23 User functions 23 FOP (Flash Operator Panel) 23 MeetMe 24 ARI 25 This material is copyright and is licensed for the sole use by Mauricio Esquenazi on 21st July 2009 10 Kenmare St. #4, , New York, , 10012 Table of Contents Admin mode 25 System Status 26 Package Manager 26 PBX menu 27 System menu 28 Settings menu 28 The history of trixbox 28 Is trixbox CE for me? 29 The future of trixbox CE 30 Hardware we will need to have 30 Connecting a phone 31 Hard phones 31 ATAs 32 Softphones 33 Connecting to an analog phone line 33 FXO versus FXS ports 33 FXO (Foreign Exchange Office) 34 FXS (Foreign Exchange Station) 34 Add-In cards 34 SIP gateways 35 VoIP providers 35 Where to get more information 36 Where to buy 37 Summary 37 Chapter 3: Installing trixbox 39 Download the ISO image 39 Burning the CD 39 Preparing for installation 41 Installing trixbox CE 41 Basic system configuration 45 Updating trixbox CE from the command line 45 Getting all yummy with it 45 trixbox CE command-line tools 46 Using the web interface 47 User mode 48 Asterisk Recording Interface (ARI) 48 Web MeetMe (MeetMe) 51 Flash Operator Panel (FOP) 53 Admin mode 55 System Status 56 Package Manager 57 PBX menu 58 [ ii ] This material is copyright and is licensed for the sole use by Mauricio Esquenazi on 21st July 2009 10 Kenmare St. #4, , New York, , 10012