Permalink
Find file
Fetching contributors…
Cannot retrieve contributors at this time
143 lines (109 sloc) 8.54 KB

TropoVBX Install Guide

http://www.TropoVBX.org

Installing TropoVBX is quick and easy, just follow this five step guide to get up and running in no time.

Requirements

Step 1: Get the Code

Download the latest release and unpack the source code into your webroot.

Step 2: Create a Database

TropoVBX needs a database from either your hosting provider or your own web server. Please see your hosting provider's documentation on creating databases for more info.

Step 3: Run the Installer

Open your web browser and navigate to the URL of your TropoVBX installation. The installer will check that your system meets the minimum requirements and will configure your new phone system. You may have to adjust the permissions on the TropoVBX upload and configuration directories.

Step 4a: Connect to Twilio

During the install process, you will be prompted for your Twilio API credentials. You can obtain your Account SID and Auth Token from your Twilio Dashboard. You must be logged into your Twilio account to access the dashboard. If you don't have a Twilio account register for a free trial and we'll include $30.00 worth of credit to help you get started.

Step 4b: Connect to Tropo

During the install process, you will be prompted for your Tropo credentials. You can obtain your Tropo login information from Tropo.com. If you don't have a Tropo account register for a free developer account.

Step 4c: Connect to VoiceVault

During the install process, you will be prompted for your VoiceVault credentials. You can obtain your VoiceVault credentials information from www.voicevault.com. If you don't have a VoiceVault account register for a free developer account. VoiceVault is optional and adds Voice Biometric authentication for password resets.

Step 5: Login

Navigate to the URL of your TropoVBX installation and login using the account you created during the installation. Once you're logged in you'll be able to add users and groups to your new phone system. You can also add devices, provision phone numbers, configure voicemail, and design call flows.

Step 6: Profit!

That's it, you're all set. TropoVBX is open source and extensible so feel free to skin it, hack it, and sell it!

Installing on Godaddy

Add this to the bottom of TropoVBX/config/config.php $config['uri_protocol'] = 'REQUEST_URI'; $config['index_page'] = '';

More Resources

Now that you've got a working installation you can:


TropoVBX Step by Step Explanation

About

This page provides detailed information for each step of the TropoVBX install process.

TropoVBX Server Check

TropoVBX requires the software listed below. It is all available for free and is open source. TropoVBX is supported and should run on all major linux distributions. TropoVBX may run on other platforms (namely Windows) but is currently unsupported.

  1. PHP version
    • We recommend PHP 5.2 or higher, although you can get away with earlier versions as long as you have PEAR Services_JSON installed
  2. CURL support
    • TropoVBX requires CURL. If you don't meet this requirement, install the CURL module.
  3. Apache version
    • We recommend Apache version 2.2+. Earlier versions and other web servers may work, but are currently unsupported.
  4. MySQL support
    • We require MySQL version 5+.
  5. APC support (optional)
    • APC is recommended, but not required.
  6. Config directory writable
    • The configuration directory must be writable by the user your webserver is running as for the TropoVBX installation to complete. The path to the configuration directory is '/TropoVBX/config'. On unix systems you can adjust the permissions with the chown and chmod commands.
  7. SimpleXML support
    • TropoVBX requires SimpleXML. If you don't meet this requirement, install the SimpleXML module.
  8. JSON support
    • TropoVBX requires JSON. If you don't meet this requirement, install the JSON module. For versions of PHP prior to 5.2 you will need the PEAR Services_JSON PECL module installed.
  9. Upload directory writable
    • The upload directory must be writable by the user your webserver is running as for the TropoVBX installation to complete. The path to the configuration directory is '/TropoVBX/audio-uploads'. On unix systems you can adjust the permissions with the chown and chmod commands.

Configure Database

TropoVBX requires a MySQL database. You should create a database, and a user with permissions to access the database for TropoVBX. If you are running TropoVBX on a shared hosting environment, you may have to use the tools provided by your hosting provider to create a new database and database user.

  1. Hostname
    • In most cases this should be 'localhost'. If your database server is on a machine other than your webserver, specify it's address here.
  2. Username
    • The username to use when connecting to MySQL
  3. Password
    • The password to use when connecting to MySQL
  4. Database Name
    • The name of your TropoVBX database.

Connect to your Twilio account

TropoVBX requires a Twilio account to enable provisioning phone numbers, sending and receiving voice calls, and sending and receiving SMS from Tropo. If you don't have a Twilio account, register for a free trial and we'll include $30.00 worth of credit to help you get started.

  1. Twilio SID
    • This is your account identifier, it is unique to you and can be shared.
  2. Twilio Token
    • This is the key to your Twilio account, it is private and should not be shared.

Connect to your Tropo account

TropoVBX requires a Tropo account to enable provisioning phone numbers, sending and receiving voice calls, and sending and receiving SMS from Tropo. If you don't have a Tropo account, register for a free trial.

  1. Tropo username
    • This is your unique Tropo.com username.
  2. Tropo password
    • This is the password to your Tropo.com account.
  3. Phono key
    • This is your Phono API key from phono.com. This is needed to use the Phono web client for calls.

Connect to your VoiceVault account

If you want to use the Voice Biometric authentication for password reset functionality in TropoVBX you have to add a VoiceVault account to enable this functionality. If you don't have a VoiceVault account, register for a free developer account.

  1. VoiceVault Username
    • This is your unique VoiceVault API username.
  2. VoiceVault password
    • This is the password to your VoiceVault API account.
  3. VoiceVault Config
    • This is the VoiceVault config ID you received when you registered for API access.
  4. VoiceVault Organisation
    • This is the VoiceVault Organisation ID you received when you registered for API access.
  5. Phone Number
    • After you finish the installation and add phone numbers to TropoVBX you can complete the VoiceVault installation on the API Accounts tab by selecting the Phone Number, this is the phone number calls will originate from when a user requests a password reset by phone.

Optional Settings

TropoVBX has the ability to send email notifications to users. This includes password reset emails, voicemail and SMS notifications, as well as notifications defined by plugins.

  1. From Email
    • This email address will be used in the from field of emails sent from your TropoVBX installation.

Setup Your Account

In order to administer your TropoVBX installation you'll need to create a user account. This is the account that will be used to manage your TropoVBX installation. This information can be updated later from within TropoVBX.

  1. Email
    • The email address to be associated with your TropoVBX admin account.
  2. Password
    • The password for your TropoVBX admin account.
  3. First Name
    • The first name of your TropoVBX administrator.
  4. Last Name
    • The last name of your TropoVBX administrator.