2600hz: Difference between revisions

From Alpine Linux
(Created page with '== WORK IN PROGRESS == What is 2600hz? == 2600hz is home to a collection of open-source telephony software that enables the use of the FreeSWITCH, Asterisk and YATE switching li...')
 
m (Reverted edits by RuthHughes (talk) to last revision by Fab)
(20 intermediate revisions by 7 users not shown)
Line 1: Line 1:
== WORK IN PROGRESS
[http://www.2600hz.org blue.box] is an open source GUI for administration and configuration of FreeSWITCH and Asterisk based VoIP systems. It supports multi-tenancy and skinning, and is completely modular.
== What is 2600hz? ==


2600hz is home to a collection of open-source telephony software that enables the use of the FreeSWITCH, Asterisk and YATE switching libraries. Initially built around the blue.box project, we aim to provide a collection of software to power your GUI, your cloud-based telephony switch and/or your monitoring and maintenance tool set.
== Install Lighttpd ==


== Set up 2600hz bluesbox on Alpine Linux ==
{{:Setting Up Lighttpd With FastCGI}}
 
This document will be a very quick c/p guide to setup 2600hz on Alpine linux. What we will setup is the following:
 
* Lighttpd with PHP
* Postgresql
* git
* 2600hz (bluesbox)
* Freeswitch
 
== Install lighttpd, PHP and postgresql ==
 
apk add git lighttpd php php-iconv php-json php-gd php-curl php-xml php-pgsql php-imap php-pdo php-pdo_pgsql php-soap php-xmlrpc php-posix php-mcrypt php-gettext postgresql postgresql-client
 
== Configuring Lighttpd ==
 
'''Edit lighttpd.conf'''
 
nano +46 /etc/lighttpd/lighttpd.conf
 
Uncomment line:
 
uncoment    include "mod_fastcgi.conf", save and exit
 
'''Note:''' If you are using the Alpine ACF, change the lighttpd port:
 
nano +81 /etc/lighttpd/lighttpd.conf
 
uncomment and change the line to: server.port          = 8080
 
'''Starting http service and adding to boot'''
 
/etc/init.d/lighttpd start && rc-update add lighttpd default


== Configuring postgresql ==
== Configuring postgresql ==


/etc/init.d/postgresql setup
{{Cmd|apk add postgresql postgresql-client git
/etc/init.d/postgresql setup}}


'''Starting http service and adding to boot'''
'''Starting http service and adding to boot'''


/etc/init.d/postgresql start && rc-update add postgresql default
{{Cmd|/etc/init.d/postgresql start && rc-update add postgresql default}}


== Installing 2600hz ==
== Installing FreeSwitch ==


'''Install 2600hz (bluesbox)'''
First use <code>apk</code> to install the needed software parts.


Download
{{Cmd|apk add freeswitch freeswitch-flite freeswitch-sounds-en-us-callie-8000 freeswitch-sample-config}}


cd /tmp
Change the permissions of {{Path|/etc/freeswitch/}}
git clone git://source.2600hz.org/bluebox.git bluebox/


Change Folder Name
{{Cmd|chown lighttpd:lighttpd /etc/freeswitch/
chmod 777 -R /etc/freeswitch/}}


  mv bluebox/ /etc/bluebox
== Starting ==
   
'''Starting http and sql server and adding to boot'''


Change Folder Persmissions
{{Cmd|/etc/init.d/postgresql setup
/etc/init.d/postgresql start && rc-update add postgresql default
/etc/init.d/lighttpd start && rc-update add lighttpd default }}


chmod -R 777 /etc/bluebox
== Installing 2600hz ==
 
Make Symlink to the bluesbox folder


ln -s /etc/bluebox/ /var/www/localhost/htdocs/bluesbox
Create a {{Path|webapps}} folder


{{Cmd|mkdir /usr/share/webapps/ -p}}


== Installing FreeSwitch ==
Checkout the source code from the git repository


'''Installing Freeswitch '''
{{Cmd|cd /usr/share/webapps/
git clone git://source.2600hz.org/bluebox.git bluebox/}}


  apk add freeswitch freeswitch-flite freeswitch-sounds-en-us-callie-8000 freeswitch-sample-config -U -X http://build.alpinelinux.org:8009/backports/1.10/ --allow-untrusted
Change the folder permissions


'''Changing some permissions'''
{{Cmd|chmod -R 777 /usr/share/webapps/bluebox}}


chown lighttpd:lighttpd /etc/freeswitch/
Create a symlink to the create directory
chmod 777 -R /etc/freeswitch/


== Starting ==
{{Cmd|ln -s /usr/share/webapps/bluebox/ /var/www/localhost/htdocs/bluebox}}
'''Starting http and sql server and adding to boot'''


/etc/init.d/postgresql setup
== Configuring bluebox ==
/etc/init.d/postgresql start && rc-update add postgresql default
/etc/init.d/lighttpd start && rc-update add lighttpd default
== Configuring bluesbox ==


'''Log on your bluesbox'''
'''Log on your bluebox'''


Browse to: http://WEBSERVER_IP_ADDRESS/bluesbox and start configuration.
Browse to: http://WEBSERVER_IP_ADDRESS/bluebox and start configuration.


* Welcome to Bluebox 1.0 Setup Wizard
* Welcome to Bluebox 1.0 Setup Wizard
Line 102: Line 67:
Select pqsl as database server, '''bluebox''' as database name, '''postgres''' as user,''' no password'''
Select pqsl as database server, '''bluebox''' as database name, '''postgres''' as user,''' no password'''
Set '''Default Timezone'''
Set '''Default Timezone'''
'''Note:''' Set Port to 3306 (for mysql); see - http://tickets.2600hz.org/browse/BLUEBOX-445
Next
Next


Line 108: Line 76:
Master Administration Account
Master Administration Account


Email Address:
Email Address:'''youremail@yourserver.net'''
Password:
Password:'''adminpassword'''
Confirm Password:
Confirm Password:'''adminpassword'''


Next  
Next  
Line 119: Line 87:


Conf Directory: '''/etc/freeswitch'''
Conf Directory: '''/etc/freeswitch'''
Global Sound File Directory: '''/usr/sounds'''
Global Sound File Directory: '''/usr/sounds'''


Line 138: Line 107:


'''Note:''' If you are using the Alpine ACF, or if you change the port in the lighttpd.conf file, the go to the port you set.
'''Note:''' If you are using the Alpine ACF, or if you change the port in the lighttpd.conf file, the go to the port you set.
e.g: if you set the port to 8080, then browse to: http://WEBSERVER_IP_ADDRESS:8080/bluesbox
e.g: if you set the port to 8080, then browse to: http://WEBSERVER_IP_ADDRESS:8080/bluebox
 
'''Note:''' Needs PHP DOM package (apk add php-dom)


'''Note:''' This documentation need some minor fixes.
'''Note:''' This documentation need some minor fixes.
[[Category:SQL]]
[[Category:Telephony]]

Revision as of 12:30, 7 March 2016

blue.box is an open source GUI for administration and configuration of FreeSWITCH and Asterisk based VoIP systems. It supports multi-tenancy and skinning, and is completely modular.

Install Lighttpd

Basic Installation

For installing the additional packages first activate community packages and update the package index

Install the required packages:

# apk add lighttpd php82 fcgi php82-cgi

Configure Lighttpd

Edit lighttpd.conf (/etc/lighttpd/lighttpd.conf) and uncomment the line:

Contents of /etc/lighttpd/lighttpd.conf

... include "mod_fastcgi.conf" ...

Edit mod_fastcgi.conf (/etc/lighttpd/mod_fastcgi.conf), find and change /usr/bin/php-cgi to /usr/bin/php-cgi82.

Contents of /etc/lighttpd/mod_fastcgi.conf

... "bin-path" => "/usr/bin/php-cgi82" # php-cgi ...

Start lighttpd service and add it to default runlevel

# rc-service lighttpd start # rc-update add lighttpd default

Configuring postgresql

apk add postgresql postgresql-client git /etc/init.d/postgresql setup

Starting http service and adding to boot

/etc/init.d/postgresql start && rc-update add postgresql default

Installing FreeSwitch

First use apk to install the needed software parts.

apk add freeswitch freeswitch-flite freeswitch-sounds-en-us-callie-8000 freeswitch-sample-config

Change the permissions of /etc/freeswitch/

chown lighttpd:lighttpd /etc/freeswitch/ chmod 777 -R /etc/freeswitch/

Starting

Starting http and sql server and adding to boot

/etc/init.d/postgresql setup /etc/init.d/postgresql start && rc-update add postgresql default /etc/init.d/lighttpd start && rc-update add lighttpd default

Installing 2600hz

Create a webapps folder

mkdir /usr/share/webapps/ -p

Checkout the source code from the git repository

cd /usr/share/webapps/ git clone git://source.2600hz.org/bluebox.git bluebox/

Change the folder permissions

chmod -R 777 /usr/share/webapps/bluebox

Create a symlink to the create directory

ln -s /usr/share/webapps/bluebox/ /var/www/localhost/htdocs/bluebox

Configuring bluebox

Log on your bluebox

Browse to: http://WEBSERVER_IP_ADDRESS/bluebox and start configuration.

  • Welcome to Bluebox 1.0 Setup Wizard

Accept Terms and Conditions Next

  • Initial Configuration

Select pqsl as database server, bluebox as database name, postgres as user, no password Set Default Timezone

Note: Set Port to 3306 (for mysql); see - http://tickets.2600hz.org/browse/BLUEBOX-445

Next

  • Create Main Administrator

Master Administration Account

Email Address:youremail@yourserver.net Password:adminpassword Confirm Password:adminpassword

Next

  • Telephony Engine

In Telephony Configuration

Conf Directory: /etc/freeswitch

Global Sound File Directory: /usr/sounds

Next

Conflicting configuration files will be permanently erased if you continue!

Next

  • Installation

Ready to Install

Next

After that you will see Click here to use Bluebox 1.0!

And you finish you Bluesbox installation.

Note: If you are using the Alpine ACF, or if you change the port in the lighttpd.conf file, the go to the port you set. e.g: if you set the port to 8080, then browse to: http://WEBSERVER_IP_ADDRESS:8080/bluebox

Note: Needs PHP DOM package (apk add php-dom)

Note: This documentation need some minor fixes.

Retrieved from "https://wiki.alpinelinux.org/w/index.php?title=2600hz&oldid=12478"