Bluebox FreeSwitch install guide (CentOS v5.x, Freeswitch v1.0.x, Bluebox)
Bluebox is still a work in progress. We felt it was far enough along to create an install guide for those who want to dip their toes in and try out FreeSwitch at the same time. The Bluebox portion of this guide can be used in conjunction with the Asterisk install portion of one of our other guides although we have not tested the combination.
This guide includes every detail in the form of step by step instructions from bare metal to a running VoIP PBX in about 1 hour. In this guide we prefer to install Freeswitch and Bluebox manually from source. It helps avoid problems often encountered with other installation methods such as version dependencies. With little effort this guide could be modified to install on Debian or some other flavor of Linux. It could also be used to create an install script.
This guide has been tested using:
Linux commands executed at a command prompt are in courier font
We are not including instruction for installing telecom hardware drivers. Refer to the manufacturer and Freeswitch websites for those details.
Lets get started
This guide assumes you already have a minimal CentOS v5 install. Just enough to get a command line is adequate. For details on that see the first section of this guide.
Install the EPEL repository
rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/`uname -i`/epel-release-5-4.noarch.rpm
rpm -Uvh http://dl.fedoraproject.org/pub/epel/5/i386/epel-release-5-4.noarch.rpm
From a root command prompt update the base install
yum -y update
Install Freeswitch/Bluebox required packages, other useful packages, and their dependencies
yum -y groupinstall core
yum -y groupinstall base
yum -y install git autoconf automake nano libtool gcc-c++ ncurses-devel make expat-devel zlib zlib-devel libjpeg-devel unixODBC-devel openssl-devel gnutls-devel libogg-devel libvorbis-devel curl-devel libtiff-devel mysql-server
PHP 5.2 is available via the CentOS 5 testing repository
yum -y --enablerepo=c5-testing install php php-mysql php-posix php-gd php-xml
Probably a good idea to reboot at this point to ensure we are starting the way the system would normally with all the above packages and updates.
git clone git://git.freeswitch.org/freeswitch.git
./bootstrap.sh && ./configure && make && make install && make all cd-sounds-install cd-moh-install
Create and install Freeswitch start/stop script.
chmod a+x freeswitch
Copy/paste the script contained in this text file into the 'freeswitch' file we just created above.
Save the file (CTL-x, y, ENTER)
Add the script as a service and set it to start on boot up.
chkconfig --add freeswitch
chkconfig freeswitch on
Add user/group freeswitch and change directory/apache ownerships
chown -R freeswitch:freeswitch /usr/local/freeswitch
chown -R freeswitch:freeswitch /var/lib/php/session
sed -i "s/User apache/User freeswitch/" /etc/httpd/conf/httpd.conf
sed -i "s/Group apache/Group freeswitch/" /etc/httpd/conf/httpd.conf
Enable Apache and mysql to start on boot and start the services for this session
chkconfig httpd on
chkconfig mysqld on
service freeswitch start
service httpd start
service mysqld start
Create mysql user account.
git clone git://source.2600hz.org/bluebox.git
chown -R freeswitch:freeswitch /var/www/html/bluebox
NOTE: When the install asks you for the web user name change default (apache) to "freeswitch" (without quotes). Everything else can remain at default (Just repeatedly press ENTER when it asks)
When the install finishes modify the default PHP memory size
sed -i 's/memory_limit = 32M/memory_limit = 128M/g' /etc/php.ini
service httpd restart
Browse to http://xxx.xxx.xxx.xxx/bluebox (where xxx.xxx.xxx.xxx is the IP address of your bluebox server) to complete the install.
Only thing you should need to do on your browser running the bluebox web install wizard is set your timezone and add your administrator email address. All other settings can stay at default.