WorldXChange VFX SIP Trunk & Trixbox 2.2 (Asterisk) - A Step By Step Dummies Install Guide for Kiwis
(It was 'less than sixty minutes' when I did it at 2am - but at 3pm, I find its more like 29 minutes!)
Heres a complete idiots step by step guide (i.e. I wrote it for myself), on how to install and configure Trixbox 2.2 (Built on the Asterisk open source PBX system), and configure a WorldXChange VFX VoIP trunk. It should take you far less than one hour to install from scratch, and make a test call out, and a test call in.
About This Guide
This guide was written while installing on Microsoft Virtual PC on a Compaq V5000 with 1GB of RAM (256MB allocated to the Virtual PC) with a Turion 2GHz CPU, loading from the .iso sitting on the hard drive. I also ran it up natively on an AMD Athlon 1700MHz (2100+) with 2GB of DDR400 RAM, and an 8xDVDROM as the install media. Most people will install from a CD-ROM.
My production Trixbox also runs happily for me on an AMD Duron 800 with 256MB of RAM (the PC cost me $50).
Its a pretty no frills guide, and if your install throws up something different - deal with it! It wont be too different, and nothing should have you straying too far from this guide.
My original Trixbox 2.0 Install Guide For Dummies can be found here and it contains heaps of info around setting up Gizmo, Freecall, SIPphone and others for free calling, USA 1800 from New Zealand and much more. I suggest reading that guide if you DONT wish to use VFX. If you ARE going to use VFX, do this guide first, then skim through the other one for extra tips.
This guide assumes the following:
- You know what Trixbox is.
- You have a softphone, or an unlocked PAP2T or other unlocked SIP adapter. If your SIP adapter is locked (even to VFX) it wont work here, as we need it to connect to our Trixbox software, not an external provider. Instructions for unlocking a PAP2T are provided in this article.
- You have an account with WorldXChanges' VFX Service (or some other SIP service you want to configure, like Gizmo or iTalk etc)
- You have phoned WorldxChange and had your line moved to the Asterisk platform, and you got an AuthID and Password.
This guide does NOT cover other aspects of setting up Trixbox - it will merely give you the capability to call
out, and recieve calls in, just like a plain old telephone does now! There are plenty of other guides out there for other aspects of Trixbox setup, and Trixbox can do a LOT of cool things. Check my older guide for some more detailed setup.
If you just want the WorldxChange trunk setup details, click here.
WorldXChange is a New Zealand VoIP SIP trunk provider. They do NOT offer helpdesk support for Asterisk/Trixbox, they only provide the SIP trunk itself.
Also note that Trixbox in a Virtual Machine is also NOT recommended, and can be the source of problems (In fact I wasted about 4 hours after writing this guide using Trixbox in a Virtual PC, before giving up and
going to the garage to install on a physical box, only to find out it was user error anyway!! Arrgghh - at least my frustration has lead to you reading a working guide).
The VFX service is geared up for non-technical home users, and they typically use locked down SIP adapters to provide access to their systems. You will need to contact WxC and request to be moved to the Asterisk
system. If you do not contact them and ask for this, they will not migrate you, and you will not have the right details to make this work.
Once you migrate to the Asterisk system on VFX, your SIP adapter WILL NOT connect directly to VFX, unless you get migrated back.
I would like to acknowledge the effort that WorldXChange (especially Phil Moore) and the Geekzone.co.nz community has put into bringing VFX to the Asterisk platform for the users who are using this technology. I am merely translating their efforts into Trixbox. Also special huge thanks to Steve Biddle for helping me do the obvious stuff that I have struggled with (who woulda thought you have to follow instructions!!!???)
For the standard lets-dedicate-a-machine-to-the-task approach, you will need...
- A Trixbox 2.2 ISO image burnt to CD http://www.trixbox.org/download (Its around 537MB or so).
- The .iso file needs to be written using an application like Nero or DVD Decrypter that can burn images. Simply burning a plain copy of the whole file to a disk wont work.
- A PC dedicated to Asterisk/Trixbox with following specs:
400MHz (500MHz +) CPU
128MB (256MB +) RAM
2GB (6GB +) HDD
Bootable CD-ROM (temporary)
An unlocked 'extension' ATA (to plug your home telephone into!) or a softphone
A telephone (your normal home phone) (if using an ATA)
Lets Get Installing
Follow this stuff to the letter, and you should be fine. But that doesnt mean you can’t use your brain and some common sense along the way!
Running the Trixbox install CD in a PC will wipe that PCs hard drive and install a complete new operating system (once you tell it to). If this surprises you, and you are worried about your Windows install, this guide is NOT for you. You are on the wrong track. Stop now. Do not proceed.
* Boot from the Trixbox 2.2 CD (turn the pc on, open the cd drive, insert cd, press reset in case you missed the CD autodetect)
* Press enter at the first prompt to begin the install (then wait a bit)
* Keyboard type: US (tab > enter will do fine, then wait a bit more)
* Timezone: Pacific/Auckland (hold down arrow till you get to Pacific/Auckland, then tab > enter)
* Pick a password. Usual password caveats apply! In this guide I will use the password: tonyiscool (By the way, this is NOT one of my private passwords!) (Enter password, then enter, then enter the password again, then press enter twice) - use the same password for every password request in this guide, and you will make your life a little easier. This of course isnt wise if you need to allow others access to various parts of the system, in say a business environment. In that case, you would use different passwords, and always keep your root password safe!!
* Go and order a pizza / kick a ball around / read Geekzone.co.nz / send a TIA note to tony[at]tall.co.nz / wash your car / seduce your significant other (just come back later okay!)
* File system will be formatted automatically (takes some time)
* Install image will be transferred automatically (takes some time)
* Linux package installation and other cool stuff will occur automatically (takes some time)
* The PC will eject the CD - please remove it
* System will reboot automatically - this first real boot will take a while as Asterisk / Trixbox / FreePBX / AMP etc packages are installed
Getting to here took me exactly 10 minutes.
Some Commandline Geekiness For Newbies (Dont panic, its not scary… well, maybe a bit)
Your PC may reboot several times. Permission to panic is denied. Wait until your PC has stopped doing crazy looking things, and says ‘asterisk1 login:’
* Login: root (type r, o, o, t, then press enter - without the commas…)
* Password: tonyiscool (type t, o, n, y, i, s, c…… oh nevermind, im sure you have this by now…)
* Type ‘passwd-maint’ (no quotes) and enter, create master password for web-gui (same as root password is okay if you are the only person logging in)
* Type ‘passwd-amp’ (never with the quotes) and enter, create password for the Asterisk management portal (AMP)
* Type ‘passwd-meetme’ (what did I say about the quotes?) and enter, create password for the Web Meetme function
* Run ‘netconfig’ (go on, I dare you to type the quotes one time) and set a meaningful IP, netmask and default gateway (DHCP will give you trouble later when you try and connect SIP phones, because your IP address could easily change!). My IP was 10.1.1.124, my netmask 255.0.0.0, and the gateway and DNS were both 10.1.1.1 - this should work for you if you have a DLINK router from Xtra. Email me if you dont know what to set your IP info to, and I will walk you through it.
* Run ‘vi /etc/hosts’ (there is a space after vi, but guess what - there are still no quotes)
* Move cursor to end of last line and press ‘o’ to create a new line (this is NOT your average notepad)
* Move cursor to new line and type ‘188.8.131.52 as.wxcnz.net’ without quotes
* Press ESC
* Type ‘:w’ then press enter, then type ‘:q’ and enter (no quotes) (Really Tony? Still on about the quotes? Jeeez man, let go already, you are just making a fool of yourself…)
Note: That whole vi thing is reasonably Geeky, so if you want to impress your Geek/Linux friends, then next time they ring, you could say something like “Oh, hey dude - I was just editing my hosts file in vi on my nix box - so anyway, WAZZZZZZZUUUUUUUUUUUUUP?“
Type ‘reboot’ in the commandline and press enter.
Getting here took another 13 minutes, thats 23 in total so far…
Some GUI Configuration To Lower Your Blood Pressure After That Big Scary Linux Commandline
* Using a web browser on another machine on your network, browse to the IP address you assigned to Trixbox (in my case http://10.1.1.125)
* In the top right corner of the page that loads, it says User Mode, and a link called ’switch’ - click the link
* Click the ‘X’ if Trixbox registration appears (or do it - now…. or later…. or like, yeah, whatever)
* Username: maint
* Password: tonyiscool
* Hover over ‘Asterisk’ and scroll down and click on ‘FreePBX’
This is where pretty much all the action will happen from here on in whenever you want to tweak your PBX setup.
All The Hard Geeky Bits Are Done (Is that comforting?) - Lets Add A SIP Trunk
* Click on ‘Trunks’ in the sidebar
* Click on ‘Add a SIP trunk’
* Outbound caller ID: (e.g. 091234567)
* Never Override CallerID: Tick this
* Maximum channels: 2 (VFX allows 2 simultaneous calls)
* Trunk name: VFX 1 (Can be anything you want)
* PEER details:
fromuser=9xxxxxxx ;this is your VFX number with no leading zero
secret=PASSWORD ;that VFX gave you when you phoned and got switched to VFX Asterisk platform
username=AuthID ;from VFX as above
* USER context: AuthID
* USER details: (leave empty)
* Register string: yourVFXNumber:PASSWORD:AuthID@as.wxcnz.net/yourVFXNumber
(YourVFXnumber = 9xxxxxxx -no leading zero)
(Password/AuthID from the new details WxC gave you - definitely not your VFX website login details).
* Click ‘Submit Changes’
* Click ‘Extensions’ in the sidebar
* Select ‘Generic SIP Device’ then click ‘Submit’
* User Extension: 100
* Display Name: test
* Secret: tonyiscool
Newbies leave everything else alone for now please!
* Click ‘Submit’
* Click General Settings in the sidebar
* Scroll to Security Settings
* Select ‘Yes’ for ‘Allow Anonymous Inbound SIP Calling
* Click Submit
Lets Cook Up An Outbound Route
This is a really powerful part of Asterisk/Trixbox. We will keep it simple here, but note that you can set it up to dial directly (no ‘9’ to get out), and do so many cool things in terms of call routing.
* Click ‘Outbound Routes’ in the sidebar
* Click ‘0 9_outside’ on the right hand side.
* Scroll down to Trunk Sequence, and where it says ZAP/g0, click, and select SIP/whatever.
* Click ‘Submit Changes’
Lets Keep The Whole Yin/Yang Balance Thing In Cosmic Harmony & Create An Inbound Route Too
Without a valid inbound route, your phone wont ring!
* Click ‘Inbound Routes’ on the sidebar
* Description: ‘All_calls’
* Set Destination - Extensions > <100> test
* Click ‘Submit’
* Click ‘Apply Configuration Changes’ then ‘Continue with reload’
* Download and install X-Lite
* Add a new SIP account in X-Lite
* Display name: test
* User name: 100
* Password: tonyiscool
* Authorisation user name: 100
* Domain: 10.1.1.125 [or whatever IP address you set in Trixbox setup]
* Domain proxy - tick ‘register with domain and recieve incoming calls’
* Select ‘proxy’ and enter Trixbox static ip address [10.1.1.125]
* Click ‘Ok’ - Thats the softphone all set to go
And that’s it! You can now dial 9 to get out, and whatever number you want to dial, and any calls into your VFX number will call your extension.
Configure a Linksys PAP2T To Plug Your Telephone Into
* Plug the PAP2T into your network with an ethernet cable
* If you need to reset or unlock it, plug a phone into line 1 on the back, and pick up and dial ‘****RESET#’ (’****73738#’), and press ‘1′ to confirm, then hangup. THIS WIPES OUT **ALL** SETTINGS ON YOUR PAP2T AND RENDERS IT FULLY UNLOCKED. IF IT WAS CONFIGURED FOR A PROVIDER, THESE SETTINGS WILL BE GONE.
* Pick up again, and dial ‘****110#’ and note down the IP address given, then hang up.
* Enter that IP address into your web browser.
* Click ‘Admin login’.
* DHCP - ‘no’
* Static IP - [choose something free on your network - mine is 10.1.1.126]
* Gateway - [your gateway/modem - mine is 10.1.1.1]
* Netmask - ‘255.255.255.0′ (or whatever yours is).
* After about 30 seconds, enter the new static IP you just created into your web browser. You should be logged into the PAP2T again.
* Click ‘Admin login’ then ‘Line 1′
* Proxy - [Your trixbox IP address - mine is 10.1.1.125]
* Display name: test
* User ID: 100
* Password: tonyiscool
* Click ‘Save Settings’
And I got here well inside the 1 hour I promised!! With enough time to go and crack open a cold beer (Tui, for the record).
You should now be making successful calls in and out of your Trixbox via your VFX trunk! Woohoo!
* Login to your Trixbox, and use the inbuilt SSH client through the WebGUI or use Putty under Windows, or if you have a screen+keyboard on your Linux box, just login as root.
* Run ‘yum -y update’ to update CentOS (takes LOTS of time, go and waterblast the driveway or something)
* Run ‘trixbox-update.sh’ and say yes afterwards to update Trixbox
Happy VFXing or Trixing or whatever it is you think you are doing!
Other related posts:
Flatmates busting your ADSL cap? Remedy...
Hawkes Bay Today (newspaper) scraping Trademe for telemarketing
Smart Connect - a free alternative to Psiloc Connect for S60 Nokia Smartphones (E71 etc)
Comment by grudge, on 20-Jun-2009 09:02
Would this install be possible from a usb stick rather than a cd install ?
I would like to try the install on my Asus EEE but it has no CD drive.
Comment by Amar, on 27-May-2010 21:26
Hi there, I have trixbox with a2billing i operate calling card from it at the moment but i want to integrate a billing portal like paypal and also set up new trunk and rates and back it up can you help and what is your charges