Trixbox without Tears.

The Other Dumb-Me Guide
FOREWORD
1  INTRODUCTION
	1.1  The Components
		1.1.1  The IP PBX
		1.1.2  Phones
		1.1.3  SIP Gateway
		1.1.4  Home Network
		1.1.5  VOIP Service Providers
2  IS VOIP FOR YOU?
	2.1  What is it going to cost?
	2.2  What will the Quality of the phone calls be?
3  INSTALLATION
	3.1  Change default Settings
		3.1.1  To get Help
		3.1.2  Change IP Address (set IP address to Static)
	3.2  Configure TRIXBOX using Web Browser
		3.2.1  Log in to System Administration
		3.2.2  Configuring Trixbox using freePBX
	3.3  General Settings
		3.3.1  Dial Command Options
	3.4  Extensions
		3.4.1  Extension numbers to avoid
		3.4.2  Create Extensions
	3.5  Follow Me
	3.6  Ring Groups
		3.6.1  Now it’s a good time to set up your softphone.
4  TRUNKS TO THE OUTSIDE WORLD
	4.1  What is a Dial Pattern?
	4.2  What is a Trunk?
	4.3  Let’s Create Some Trunks
		4.3.1  Pennytel
			Outgoing Settings
			Incoming Settings
			Registration
		4.3.2  Oztell (SIP)
			Outgoing Settings
			Incoming Settings
			Registration
		4.3.3  Oztell (IAX)
			Outgoing Settings
			Incoming Settings
			Registration
		4.3.4  Astratel
			Outgoing Settings
			Incoming Settings
			Registration
5  CALLS HANDLING
	5.1  Inbound Routes (Incoming Calls)
	5.2  Time Conditionds
		Simple Time Condition
		Complex Time Condition
	5.3  Outbound Routes
		5.3.1  What is an Outbound Route?
		5.3.2  How does it work?
		5.3.3  International
		5.3.4  Domestic
		5.3.5  MobileAust
		5.3.6  Oztellonly
		5.3.7  Astratelonly
	5.4  ENUM
		5.4.1  Setting up ENUM Trunk
		5.4.2  Setting up ENUM Outbound Route
	5.5  How to restrict Outgoing Calls
6  SYSTEM RECORDINGS
	6.1  Direct recording
	6.2  Upload Pre-recorded Material
7  DIGITAL RECEPTIONIST
	7.1  Setting Up Digital Receptionist
	7.2  Customising Individual Extension
	7.3  Multi-Language IVR
		7.3.1  Complimentary multi-language MOH
	7.4  Multi-Tenants IVR
8  GET UNDER THE BONNET
	8.1  Editing The .conf Files
		8.1.1  sip.conf
		sip_custom.conf
		8.1.2  iax.conf
		Iax_custom.conf
		8.1.3  Indications.conf
		8.1.4  enum.conf
		8.1.5  extensions_custom.conf
		8.1.6  features.conf
9  CHECK YOUR SYSTEM
	9.1  System Process Status
	9.2  Asterisk Info
10  INTERFACING ASTERISK TO PSTN
	10.1  Digium Wildcard X100P FXO PCI Card
		10.1.1  zapata.conf
		10.1.2  zapata-auto.conf
		10.1.3  zaptel.conf
	10.2  Digium TDM400P FXO/FXS Card
		10.2.1  zapata-auto.conf
		10.2.2  modprobe.conf
	10.3  Caller ID (CID) using ZAP device
		10.3.1  zapata.conf
		10.3.2  zapata-auto.conf
	10.4  Rebuild  Zaptel Driver
		10.4.1  IF ALL ELSE FAIL
	10.5  Sipura SPA3000 as a PSTN Interface
		10.5.1  Log in to SPA3000
		10.5.2  Change the settings
		10.5.3  Add SIP Trunk
		10.5.4  SPA3000 as an outbound PSTN Trunk
11  PSTN TO VOIP GATEWAY
12  DISA
	12.1  DISA - Hand Coding Method
	12.2  DISA – Using freePBX
13  SETTING UP A BOL SIPPHONE
	Profile Tab
		Audio & Video Tab
		Network Tab
		STUN Tab
		Call Forward
14  OPERATOR PANEL
	14.1  Flash Operator Panel (FOP)
		14.1.1  Setting the Admin Password
		14.1.2  Hang-up a Call
		14.1.3  Transfer a Call
		14.1.4  Initiate a Call
		14.1.5  Barge in or Create a Conference
	14.2  HUDLite
		14.2.1  Setting up HUD Manager
		14.2.2  Setting Up HUDLite
		14.2.3  What if it does not work?
15  CALL PARKING AND TRANSFER
	15.1  Call Transfer - Managed
		features.conf
		extensions.conf
		15.1.1  How is it done?
	15.2  Call Transfer – Blind
	15.3  Put a Call On Hold
	15.4  Call Pickup
	15.5  Filter Your Incoming Calls - Only Accept Known Calls
16  MEETME – TELECONFERENCE
	meetme.conf
		meetme_additional.conf
	16.1 Create Conference
		16.1.1  /var/spool/asterisk/meetme
	16.2  Invalid Conference number
17  VOICEMAIL
	17.1  Enabling Email Notification
		17.1.1  Installing sendmail
		17.1.2  /etc/hosts
	17.2  Use Postfix Instead of Sendmail
	17.3  How to Retrieve Voicemail from External Phone
		17.3.1  Method 1
		17.3.2  Method 2
	17.4  How to Change Voice Mail Greetings
18  FAX TO E-MAIL
	18.1  Installing Fax for TRIXBOX
19  WEATHER REPORTS
	19.1  Configure Weather Report – On Demand.
		19.1.1  Create Extension codes.
	19.2  Configure Weather Report – Background Method.
		19.2.1  Create Extension codes.
	19.3  Now put it in your Digital Receptionist
20  REMOTE MANAGEMENT
	20.1  httpd.conf
21  HOW TO SET UP A REMOTE EXTENSION
	21.1  Create a new extension
	21.2  IAX.Conf
	21.3  Sip_Nat.Conf
	21.4  Setting up an IAX Softphone
		21.4.1  First the general options
		21.4.2  Accounts options
22  CALLS RECORDINGS
	22.1  Record all calls by default
	22.2  Record calls on demand.
23  STUN SERVERS
24  DIALING THROUGH MS OUTLOOK®
	24.1  Download AstTapi
	24.2  Install AstTapi
	24.3  Configure Outlook Address Book
25  SPEED DIAL
	25.1  The Dumb-Me method
	25.2  TRIXBOX’s method
26  HOW TO USE WINDOW MESSENGER® 5.X
27  HOW TO INTERCONNECT 2 BOXES
	27.1  Method 1 - With the Peer Asterisk box as Extensions
		Register String
		Extension Number
	27.2  Method 2 - In a Peer/User Arrangement
	27.3  Method 3 – Friend/Friend Arrangement
	27.4  Thinking of more than 2 boxes?
	27.5  Redirect Incoming in Box A to Box B
28  CUSTOMISED VOICE
	28.1  Customising Voice Prompts
	28.2  Installing Other Languages
	28.3  Converting WAV files
		28.3.1  Converting WAV to GSM
		28.3.2  Converting WAV to SLN
29  MOH (MUSIC ON HOLD)
	29.1  Customising MOH
	29.2  MOH for different trunks
	29.3  Streaming Music on Hold
30  BACKUP AND RESTORE
	30.1  Schedule a Backup
	30.2  To Restore a Backup
31  SUGARCRM CONFIGURATION
32  USB PHONE SUPPORT
33  CODEC (CODER DECODER)
	33.1  Installing G729 and G723 CODECs
34  PSTN TRUNK – SPECIAL HANDLING
	34.1  Dial 0 for Outside Line
		34.1.1  Using Zaptel Card Method
		34.1.2  Using SPA3K Method
	34.2  Giving Priority to Emergency Numbers (E.g. 000)
35  PORT FORWARDING AND QOS – ROUTERS
	35.1  Port Forwarding
	35.2  QOS – Routers
36  UPDATING TRIXBOX
37  TOOLS
	37.1  Webmin
		37.1.1  To update WebMin
	37.2  Putty
	37.3  WinSCP
38  MY TRIXBOX®  PBX NETWORK
39  TROUBLE SHOOTING
	39.1  Asterisk Feature Codes not working
	39.2  Asterisk Drops Calls after a few seconds
	39.3  Pennytel Asterisk Problem
	39.4  Unable to receive Incoming Calls
	39.5  Sipura SPA3000 – Not hanging up after PSTN Calls
	39.6 Trixbox 1.2 will not play nicely
APPENDIX A
	A.1  Asterisk Feature Codes
	A.2  Asterisk CLI commands
		A.2.1  General commands
		A.2.2  AGI Commands
		A.2.3  Database Handling
		A.2.4  IAX Channel Commands
		A.2.5  SIP Channel commands
		A.2.6  Server management
	A.3  Asterisk Special Extensions
	A.4  Asterisk Common Variables
	A.5  Indications for Various Countries
APPENDIX B
	B.1 – Australian VSPs (trunks)
		B.1.1  BBPglobal
			Peer Details
			User Details
		B.1.2  Engin BYO
			Peer Details
			User Details
		B.1.3  Faktortel (IAX)
			Peer Details
			User Details
		B.1.4  iPrimus
			Peer Details
			User Details
		B.1.5  Koala
			Peer Details
			User Details
		B.1.6  MyNetFone
			Peer Details
			User Details
		B.1.7  Nehos (IAX)
			Peer Details
			User Details
		B.1.8  Nodephone
			Peer Details
			User Details
		B.1.9  SipMe
			Peer Details
			User Details
		B.1.10  TelephoneGlobal
			Peer Details
			User Details
	B.2 – New Zealand VSPs (trunks)
		B.2.1  iTalk
			Peer Details
			User Details
		B.2.2   Double Zero 64 (IAX)
			Peer Details
			User Details
	B.3 – Other VSPs (trunks)
		B.3.1  Broadvoice
			Peer Details
			User Details
		B.3.2  FWD aka Pulver(IAX)
			Peer Details
			User Details
		B.3.3  SipBroker
			Peer Details
		B.3.4  SipPhone
			Peer Details
			User Details
		B.3.5  VOIP Buster
			Peer Details
	B.4  Related Links – (for vsp TRUNK settings)
		B.4.1  Trunk and Route Settings
APPENDIX C
	C.1  Voice for Asterisk Messages
	C.2  Australian Voice and Language Set for Asterisk
	C.3  More Australian Voice for Asterisk
APPENDIX D (ATAS AND ROUTERS)
	D.1  Alcatel SpeedTouch 510/530 ADSL Router
	D.2  Billion 7402 VL
	D.3  Linksys PAP2 and Sipura SPA2000
APPENDIX E (USERS’ CONTRIBUTIONS)
	E.1  Suggestions for Dial Plan and configuration
		E.1.1  Astratel
		E.1.2  Further .conf modifications by Colin
	E.2  Multiple TDM400P Installation
	E.3  Eliminating Echo Problems in SPA-3000
	E.4  Immediate Answer of PSTN Calls
	E.5  Rebuild Zaptel Driver  (Users’ Suggestions)
		E.5.1  As experienced by marner – a Whirlpool Forum participant.
		E.5.2  As suggested by Rob Thomas (the FreePBX guru)
	E.6  Zaptel card configuration for Australia
	E.7  RAID1, LVM (logical volumes) - howto
APPENDIX F  (PUBLICATIONS AND REFERENCES)
	F.1  DUNDi – a guide to a Simple Setup
	F.2  The future of Telephony by O’Reilly Publishing
	F.3  Other Asterisk  Forums, Tutorials and Wikis
	F.4  Voice over IP – Per call bandwidth consumption
NOTES
	What version of Asterisk is installed?
	A2Billing
	Delete Call Records from CDR
	Extension Numbers to avoid using
	sip_nat.conf
	Trunks and Outbound Routes – a circus of confusion
		Outgoing Route Dial Pattern
		Trunk Outgoing Dial Rules
	Adding the missing Maintenance Modules to freePBX 2.1.0
BUGS REPORTS
	Missing Zaptel support
	Missing  /var/spool/asterisk/meetme
	Editing email notification message
	FreePBX 2.1.2 caused Asterisk not to load
	Trixbox 1.2 distribution major bug
	Asterisk re-load issue
	Are you still having problem?
	Hangs on shutdown
CHEAT SHEET
EXPLOIT ALERTS
LIVE CASE STUDY
BIBLIOGRAPHY
CHANGES MADE SINCE LAST UPDATE