It’s Orgasmatron 5.1: The Ultimate Asterisk Kitchen Sink

For those that want a turnkey Asterisk® VoIP PBX with every bell and whistle, today is your very lucky day. This tutorial will walk you through every step. In less than an hour, you'll have your very own, fully functional Asterisk PBX. No Linux skills are required for this setup. There's no charge for any outbound call made to any number in the U.S. or Canada. And inbound calls are free as well.

News Flash: Incredible PBX 4.0 is now available with FreePBX 2.10 support!

Coming January 19: Incredible PBX 11 & Incredible Fax for Asterisk 11 and FreePBX 2.11

New Asterisk Security Model. Orgasmatron 5.1 has an all-new design which is intended to let you run an absolutely secure Asterisk PBX in your home from behind a secure firewall with NO INBOUND PORTS exposed to the Internet. So long as your router, Google Voice, and SIPgate passwords are secure, you can sleep like a baby. Today's Magic uses SIPgate as an intermediate SIP provider for Google Voice to set up free outbound Google Voice calls in the U.S. and Canada. Remember that Google Voice actually places two calls to connect you to your destination. First, you get a call back. And then the party you're calling is connected. The SIPgate trunk is used by Google Voice to call you back so the inbound SIPgate call is free. We handle all of the interconnection magic with Asterisk transparently so your calls appear to be processed as if you were using a standard telephone to dial out. Just remember not to use extension 75 in Asterisk for your personal conferences!

Because we register your SIP connection with SIPgate permanently, there is no need to open the SIP or IAX Internet ports on your router. In short, your SIP connection with SIPgate works just as if you were using a browser behind a firewall. The return port will automatically be mapped by your NAT-based router. Hence, no security worries! We, of course, do recommend that you sign up with Vitelity so you have an alternate communications vehicle in the event of a problem with your free service. Vitelity also can provide 911 emergency service for your home or home office. You can save a little money while supporting the PBX in a Flash project by using the links at the end of this article.

Kitchen Sink Inventory. No kitchen is complete without an inventory. So, for those that are wondering what's included in the Orgasmatron 5.1 build, here's a feature list of the components you get in addition to the base PBX in a Flash build with Asterisk 1.4, FreePBX 2.6, and Apache, SendMail, MySQL, PHP, phpMyAdmin, IPtables Linux firewall, Fail2Ban, and WebMin. A2Billing, Cepstral, Hamachi VPN, and Mondo Backups are optional and may be installed using the scripts that are provided.

• A2Billing (/root/nv/install-a2billing)
• Amazon S3
• AsteriDex
• CallerID Superfecta (FreePBX Module)
• CallWho for Asterisk
• Cepstral TTS (/root/nv/install-cepstral.sh)
• Preconfigured Email That Works with SendMail
• Extensions (16 preconfigured)
• Fax Module using nvFax
• FONmail
• FreePBX Backups
• Gizmo5 (Free Calls to Gizmo5 users worldwide: 1747xxxxxxx*1089)
• Google Voice (preconfigured)
• Hamachi VPN (/root/nv/install-hamachi.x)
• Hotel-Style Wakeup Calls (FreePBX Module)
• ISN: FreeNum SIP Calling from Any Phone
• MeetMe Conference Bridge (just dial C-O-N-F)
• Mondo Full System Backups (/root/nv/install-diskbackup.x)
• NewsClips from Yahoo
• ODBC Database Support
• Reminders by Phone and Web
• SIP URI Outbound Calling (call any SIP URI worldwide for free)
• TeleYapper
• Tide Reports with xTide
• Trunk Lister Script (/root/nv/trunks.sh)
• Trunks (Vitelity, Fonica, SIPgate, and ENUM)
• Twitter Interface (Make Free Calls and Send SMS Messages)
• Weather by Airport Code
• Weather by ZIP Code
• Worldwide Weather
• Zaptel Updater (/root/nv/zaptel-update.sh)

Prerequisites. Here's what you'll need to get started:

• Broadband Internet connection
• Rock-solid NAT router/firewall. Recommend: $35 dLink WBR-2310
• $200 PC on which to run PBX in a Flash or a Proxmox Virtual Machine
• Free Google Voice account (HINT: Under $2 on eBay)
• Free SIPgateOne residential account (Use cell to get SMS invite)

Learn First. Install Second. Even though the installation process is now a No-Brainer, you are well-advised to do some reading before you begin. VoIP PBX systems have become a favorite target of the hackers and crackers around the world and, unless you have an unlimited bank account, you need to take some precautions to protect your phone bill. Start by reading our Primer on Asterisk Security. Then read our PBX in a Flash and VPN in a Flash knols. If you're still not asleep, there's loads of additional documentation on the PBX in a Flash documentation web site.

Today's Drill. The installation process is straight-forward. Just don't skip any steps. In a nutshell, here are the 6 Steps to Free Calling and an incredibly versatile, preconfigured Asterisk PBX:

1. Configure SIPgate and Google Voice for Orgasmatron 5.1
2. Install the latest version of PBX in a Flash
3. Run the Orgasmatron 5.1 Installer
4. Enter your Google Voice and SIPgate credentials
5. Change existing passwords to secure your system
6. Configure a softphone or SIP telephone

Configuring SIPgate. A free SIPgate One residential phone number is a key component in today's project. This allows you to receive free incoming calls on your SIPgate number. Step #1 is to request an invite at this link. You'll need to enter your U.S. cellphone number to receive the SMS message with your invitation code. Don't worry. You can erase your cellphone number from your account once it is set up. Once you receive the invite code, enter it and choose the option to set up a residential account. Next, choose a phone number and write it down. The area code really doesn't matter because Google Voice is the only one that will be calling this number after we get things set up. For now, leave your cellphone number in place so that you can receive your confirmation call from Google Voice in the next step. After that, you'll want to revisit SIPgate and remove all parallel calling numbers. Finally, click on the Settings link and write down your SIP ID and SIP Password. You'll need these in a few minutes to configure PBX in a Flash. Now place a call to your new SIPgate number and make certain that your cellphone rings before proceeding.

Configuring Google Voice. Google Voice still is by invitation only so the first thing you'll need is an invite. If you're in a hurry, then stroll over to eBay where you'll find lots of them for under $2. Once you have your invite in hand, click on the email link to set up your account. After you've chosen a telephone number, plug in your new SIPgate number as the destination for your Google Voice calls and choose Office as the Phone Type. Trust us.

Google then will place a call to your SIPgate number and ask you to enter a confirmation code that's been provided. When your cellphone rings, answer it and punch in the number. Wait for confirmation. Then hang up.

While you're still in Google Voice Settings, click on the Calls tab. Make sure your settings match these:

Click Save Changes once you adjust your settings. Under the Voicemail tab, plug in your email address so you get notified of new voicemails. Down the road, receipt of a Google Voice voicemail will be a big hint that something has come unglued on your PBX.

Now place a test call to your new Google Voice number and be sure your cellphone rings. Don't move forward until you've been able to successfully place a call to your cellphone by dialing your Google Voice number. Once this is working, revisit SIPgate and remove all parallel calling numbers including your cell number.

Installing PBX in a Flash. Now for the fun part. Here's a quick tutorial to get PBX in a Flash installed. We recommend you install the latest PIAF 1.6 beta which is virtually identical to version 1.4 except it uses CentOS 5.4 instead of CentOS 5.2. This means it works better with newer hardware including Atom-based computers and newer network cards. Download the 32-bit, PIAF 1.6 version from here, here, or here. The MD5 checksum for the file is e8a3fc96702d8aa9ecbd2a8afb934d36. Burn the ISO to a CD. Then boot your system from the installation CD and type ksalt to begin.

WARNING: This install will completely erase, repartition, and reformat ALL disks on your system! Press Ctrl-C to cancel the install.

On some systems you may get a notice that CentOS can't find the kickstart file. Just tab to OK and press Enter. Don't change the name or location of the kickstart file! This will get you going. Think of it as a CentOS 'feature'. 🙂

At the keyboard prompt, tab to OK and press Enter. At the time zone prompt, tab once, highlight your time zone, tab to OK and press Enter. At the password prompt, make up a VERY secure root password. Type it twice. Tab to OK, press Enter. Get a cup of coffee. Come back in about 5 minutes. When the system has installed CentOS, it will reboot. Remove the CD promptly. After the reboot, choose A option. Have a 10-minute cup of coffee. After installation is complete, the machine will reboot a second time. Log in as root with your new password and execute the following commands:

update-scripts
update-fixes

When prompted, change the ARI password to something really obscure. You're never going to use it! You now have a PBX in a Flash base install. On a stand-alone machine, it takes about 30 minutes. On a virtual machine, it takes about half that time.

Running the Orgasmatron 5.1 Installer. Log into your server as root and issue the following commands to run the Orgasmatron 5.1 installer:

cd /root
wget http://pbxinaflash.net/orgasmo51.x
chmod +x orgasmo51.x
./orgasmo51.x

Have another 15-minute cup of coffee. It's a great time to consider a modest donation to the Nerd Vittles project. You'll find a link at the top of the page. When the installer finishes, READ THE SCREEN!

Adding Your Credentials to PBX in a Flash. Now we're ready to insert your Google Voice credentials and SIPgate number into PBX in a Flash. You'll need four pieces of information: your 10-digit Google Voice phone number, your Google Voice account name (which is the email address you used to set up your GV account), your GV password (no spaces!), and your 11-digit SIPgate RingBack DID (beginning with a 1). Don't get the 10-digit GV number mixed up with the 11-digit SIPgate RingBack DID, or nothing will work. 🙂

While logged into your server as root, issue the following command: ./configure-gv. Check your entries carefully. If you make a typo in entering any of your data, press Ctrl-C to cancel the script and then run it again!!

Next, run passwd-master and set your FreePBX passwords to something equally secure but different from your Linux root password.

Finally, type status and press Enter. Write down the IP address of your new server. You'll need it in the next step.

Configuring FreePBX. Using a web browser, log in to FreePBX 2.6 at the following link substituting your actual IP address for ipaddress: http://ipaddress/admin. You'll be prompted for a user name (maint) and password (the one you just created with passwd-master).

When FreePBX loads, choose Setup, Trunks, sipgate. In Peer Details, replace both instances of sipID with your actual SipGate SIP ID. In Peer Details, replace sipPassword with your actual SipGate SIP Password. In Register String, replace sipID with your SipGate SIP ID, replace sipPassword with your SipGate SIP Password, and replace 3333333333 with your 10-digit SipGate Phone Number. When finished, the Register String should look something like the following:

7004484f0:B8TTW3@sipgate.com/4155201234

Click Submit Changes, Apply Configuration Changes, Continue with Reload to save your settings.

Now click Setup, Inbound Routes, gv-ringback. In DID Number, replace 3333333333 with your 10-digit SIPGate Phone Number. In CallerID Number, replace 7777777777 with your 10-digit Google Voice Number.

Click Submit, Apply Configuration Changes, Continue with Reload to save your changes.

Securing FreePBX. You're almost done. While still in FreePBX, choose each of the 16 preconfigured extensions on your new server and change the extension AND voicemail passwords. Here's the drill: Setup, Extensions, 501, Submit. After changing secret and Voicemail Password, repeat with the next extension number instead of 501. Then Apply Config Changes, Continue when you've finished with all of them.

Now change the default DISA password: Setup, DISA, DISAmain, PIN, Submit Changes, Apply Config Changes, Continue.

Whew! We recommend you reboot your server at this juncture just to be sure everything gets initialized correctly. Then all we need is a phone and you're all set.

Configuring a SIP Phone. There are hundreds of terrific SIP telephones and softphones for Asterisk-based systems. Once you get things humming along, you'll want a real SIP telephone, and you'll find lots of recommendations on Nerd Vittles. For today, let's download a terrific (free) softphone to get you started. We recommend X-Lite because there are versions for Windows, Mac, and Linux. So download your favorite from this link. Install and run X-Lite on your Desktop. At the top of the phone, click on the Down Arrow and choose SIP Account Settings, Add. Enter the following information using your actual password for extension 701 and the actual IP address of your PBX in a Flash server instead of 192.168.0.251. Click OK when finished.

Orgasmatron Test Flight. The proof is in the pudding as they say. So let's try two simple tests. First, from another phone, call your Google Voice number. Your softphone should begin ringing shortly. Answer the call and make sure you can send and receive voice on both phones. Hang up. Now let's place an outbound call. Using the softphone, dial your cellphone number. Google Voice should transparently connect you. Answer the call and make sure you can send and receive voice on both phones. If everything is working, congratulations!

Solving One-Way Audio Problems. If you experience one-way audio on some of your phone calls, you may need to adjust the settings in /etc/asterisk/sip_custom.conf. Just uncomment the first two lines by removing the semicolons. Then replace 173.15.238.123 with your public IP address, and replace 192.168.0.0 with the subnet address of your private network. Save the file and restart Asterisk with the command: amportal restart.

Choosing a VoIP Provider. For this week, we'll point you to some things to play with on your new server. Then, in the subsequent articles below, we'll cover in detail how to customize every application that's been loaded. Nothing beats free when it comes to long distance calls. But nothing lasts forever. So we'd recommend you set up another account with Vitelity using our special link below. This gives your PBX a secondary way to communicate with every telephone in the world, and it also gets you a second real phone number for your new system... so that people can call you. Here's how it works. You pay Vitelity a deposit for phone service. They then will bill you $3.99 a month for your new phone number. This $3.99 also covers the cost of unlimited inbound calls (two at a time) delivered to your PBX for the month. For outbound calls, you pay by the minute and the cost is determined by where you're calling. If you're in the U.S., outbound calls to anywhere in the U.S. are a little over a penny a minute. If you change your mind about Vitelity and want a refund of the balance in your account, all you have to do is ask.

The VoIP world is new territory for some of you. Unlike the Ma Bell days, there's really no reason not to have multiple VoIP providers especially for outbound calls. Depending upon where you are calling, calls may be cheaper using different providers for calls to different locations. So we recommend having at least two providers. Visit the PBX in a Flash Forum to get some ideas on choosing alternative providers.

Kicking the Tires. OK. That's enough tutorial for today. Let's play. Using your new softphone, begin your adventure by dialing these extensions:

• D-E-M-O - Nerd Vittles Orgasmatron Demo (running on your PBX)
• 1234*1061 - Nerd Vittles Demo via ISN FreeNum connection to NV
• 17476009082*1089 - Nerd Vittles Demo via ISN to Google/Gizmo5
• Z-I-P - Enter a five digit zip code for any U.S. weather report
• 6-1-1 - Enter a 3-character airport code for any U.S. weather report
• 5-1-1 - Get the latest news and sports headlines from Yahoo News
• T-I-D-E - Get today's tides and lunar schedule for any U.S. port
• F-A-X - Send a fax to an email address of your choice
• 4-1-2 - 3-character phonebook lookup/dialer with AsteriDex
• M-A-I-L - Record a message and deliver it to any email address
• C-O-N-F - Set up a MeetMe Conference on the fly
• 1-2-3 - Schedule regular/recurring reminder (PW: 12345678)
• 2-2-2 - ODBC/Timeclock Lookup Demo (Empl No: 12345)
• 2-2-3 - ODBC/AsteriDex Lookup Demo (Code: AME)
• Dial *68 - Schedule a hotel-style wakeup call from any extension
• 1061*1061 - PBX in a Flash Support Conference Bridge
• 882*1061 - VoIP Users Conference every Friday at Noon (EST)

Homework. Your homework for this week is to do some exploring. FreePBX is a treasure trove of functionality, and the Orgasmatron build adds a bunch of additional options. See if you can find all of them. For starters, you'll want to activate CID Superfecta in FreePBX. For tips, start here in the forums. Then log into your server as root and look through the scripts added in the /root/nv folder. You'll find all sorts of goodies to keep you busy. And, be sure to check out Tweet2Dial which lets you use Twitter to make Google Voice calls, send free SMS messages, and manage your new Asterisk server. Finally, don't forget to List Yourself in Directory Assistance so everyone can find you by dialing 411. And be sure to add your new number to the Do Not Call Registry to block telemarketing calls. Or just call 888-382-1222 from your new number. Enjoy!

Continue reading Part II.

Continue reading Part III.

Continue reading Part IV.

Support Issues. With any application as sophisticated as this one, you're bound to have questions. Blog comments are a terrible place to handle support issues although we welcome general comments about our articles and software. If you have particular support issues, we encourage you to get actively involved in the PBX in a Flash Forums. It's the best Asterisk tech support site in the business, and it's all free! We maintain a thread with the latest Patches for Orgasmatron 5.1. Please have a look. Unlike some forums, ours is extremely friendly and is supported by literally hundreds of Asterisk gurus and thousands of ordinary users just like you. So you won't have to wait long for an answer to your questions.

Upgrading Previous Orgasmatron V Installs. The question we hear over and over is "How do I upgrade from an existing Orgasmatron V install or from an existing Asterisk system?" The short answer is you can't. But there is some good news. For those with existing Orgasmatron V installs, we think we can fix your system so that it makes calls reliably. First, be sure your sipgate and gv-incoming settings match what is shown above in this article. Second, be sure you have configured a sipgate trunk with your proper sipgate credentials. Finally, log into your server as root and issue the following commands:
cd /root
wget http://pygooglevoice.googlecode.com/files/pygooglevoice-0.5.tar.gz
tar zxvf pygooglevoice-0.5*
cd pygooglevoice-0.5
python setup.py install
cd /etc/asterisk
sed -i 's|\${RINGBACK}|\${RINGBACK} 3|' extensions_custom.conf
asterisk -rx "dialplan reload"


Early Adopter WARNING. Current downloads are bug-free as best we can tell. But, for those that installed Orgasmatron 5.1 before 2:20 PM (EST) on Saturday, 2/27/2010, a couple of issues have arisen that need to be addressed. Please visit the following link to Orgasmatron 5.1 patches and apply those applicable to your particular situation. Without these patches, a security vulnerability may exist if you expose your server to web access from the Internet and a number of dialplan errors will cause unexpected behavior. It takes less than a minute to apply all of the patches! I'm reminded of the old Wild West adage: "You can always tell the pioneers by the arrows in their back."

Originally published: February 25, 2010

Need help with Asterisk? Visit the PBX in a Flash Forum.
Or Try the New, Free PBX in a Flash Conference Bridge.

whos.amung.us If you're wondering what your fellow man is reading on Nerd Vittles these days, wonder no more. Visit our new whos.amung.us statistical web site and check out what's happening. It's a terrific resource both for us and for you.

Special Thanks to Our Generous Sponsors

FULL DISCLOSURE: ClearlyIP, Skyetel, Vitelity, DigitalOcean, Vultr, VoIP.ms, 3CX, Sangoma, TelecomsXchange and VitalPBX have provided financial support to Nerd Vittles and our open source projects through advertising, referral revenue, and/or merchandise. As an Amazon Associate and Best Buy Affiliate, we also earn from qualifying purchases. We’ve chosen these providers not the other way around. Our decisions are based upon their corporate reputation and the quality of their offerings and pricing. Our recommendations regarding technology are reached without regard to financial compensation except in situations in which comparable products at comparable pricing are available from multiple sources. In this limited case, we support our sponsors because our sponsors support us.

BOGO Bonaza: Enjoy state-of-the-art VoIP service with a $10 credit and half-price SIP service on up to $500 of Skyetel trunking with free number porting when you fund your Skyetel account. No limits on number of simultaneous calls. Quadruple data center redundancy. $25 monthly minimum spend required. Tutorial and sign up details are here.

The lynchpin of Incredible PBX 2020 and beyond is ClearlyIP components which bring management of FreePBX modules and SIP phone integration to a level never before available with any other Asterisk distribution. And now you can configure and reconfigure your new Incredible PBX phones from the convenience of the Incredible PBX GUI.

VitalPBX is perhaps the fastest-growing PBX offering based upon Asterisk with an installed presence in more than 100 countries worldwide. VitalPBX has generously provided a customized White Label version of Incredible PBX tailored for use with all Incredible PBX and VitalPBX custom applications. Follow this link for a free test drive!
 

Special Thanks to Vitelity. Vitelity is now Voyant Communications and has halted new registrations for the time being. Our special thanks to Vitelity for their unwavering financial support over many years and to the many Nerd Vittles readers who continue to enjoy the benefits of their service offerings. We will keep everyone posted on further developments.
 

Some Recent Nerd Vittles Articles of Interest...