Telephony Dev Box

Installation

  1. Install virtualbox
  2. Install vagrant
  3. Clone this repository (git clone https://github.com/mojolingo/Telephony-Dev-Box.git) if you have git installed, or download an archive.
  4. Add the vagrant-berkshelf plugin to your Vagrant installation by doing vagrant plugin install vagrant-berkshelf.
  5. Build the VMs: This project ships with configuration for each of the three supported telephony engines: Asterisk, FreeSWITCH and PRISM, along with a box with Lumenvox TTS & ASR deployed and a load test box (containing SIPp + Sippy Cup). If you simply type vagrant up then one VM will be created for each engine, as well as a VM containing a working Adhearsion environment. However, this will create five virtual machines! You can easily bring up just the instance(s) you want by typing any combination of the below commands:
    • vagrant up adhearsion
    • vagrant up asterisk
    • vagrant up freeswitch
    • vagrant up prism
    • vagrant up lumenvox
    • vagrant up loadtest

One thing to note is that the "adhearsion" VM is especially optional. Most of the Mojo Lingo developers simply run Adhearsion locally. We provided a VM for those users who had a difficult time getting a Ruby build running on their system. If you already have a functional Ruby environment (with RubyGems) then feel free to just gem install adhearsion and keep going.

Usage

Create an Adhearsion app

Configure it to connect to the platform of your choice using one of the following samples:

##
# Use with Rayo (eg FreeSWITCH or Voxeo PRISM)
#
config.punchblock.username = "usera@freeswitch.local-dev.mojolingo.com" # Your XMPP JID for use with Rayo (swap 'freeswitch' for 'prism' as appropriate)
config.punchblock.password = "1" # Your XMPP password
##
# Use with Asterisk
#
config.punchblock.platform = :asterisk # Use Asterisk
config.punchblock.username = "manager" # Your AMI username
config.punchblock.password = "password" # Your AMI password
config.punchblock.host = "asterisk.local-dev.mojolingo.com" # Your AMI host

Test

Boot your Adhearsion app and call in. You can dial usera@[asterisk/freeswitch/prism].local-dev.mojolingo.com, or any number from a registered endpoint.

Register your softphone (optional)

The Asterisk and FreeSWITCH VMs contain preconfigured "usera" and "userb" accounts for softphones. Use the following credentials to register:

Base Boxes

This project includes base box templates for use on Mojo Lingo projects. These base boxes are published at http://ci.mojolingo.com/job/Telephony-Dev-Box-Base-Boxen, and include Chef 11. Ubuntu 12.04 and CentOS 6.4 boxes are available, both 64bit. The main difference between these and other publicly available base boxes is the visibility into their build mechanism and that they never change after they are published - new builds always have a new build number in their URL; this way you can be sure of base box stability.