2600hz: Difference between revisions

From Alpine Linux
No edit summary
m (Reverted edits by RuthHughes (talk) to last revision by Fab)
(19 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 FreeSwitch ==
== Installing FreeSwitch ==


'''Installing Freeswitch '''
First use <code>apk</code> to install the needed software parts.


  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
{{Cmd|apk add freeswitch freeswitch-flite freeswitch-sounds-en-us-callie-8000 freeswitch-sample-config}}


'''Changing some permissions'''
Change the permissions of {{Path|/etc/freeswitch/}}


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


== Starting ==
== Starting ==
Line 61: Line 29:
'''Starting http and sql server and adding to boot'''
'''Starting http and sql server and adding to boot'''


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


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


'''Install 2600hz (bluesbox)'''
Create a {{Path|webapps}} folder


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


cd /tmp
Checkout the source code from the git repository
git clone git://source.2600hz.org/bluebox.git bluebox/


Change Folder Name
{{Cmd|cd /usr/share/webapps/
git clone git://source.2600hz.org/bluebox.git bluebox/}}


mv bluebox/ /etc/bluebox
Change the folder permissions


Change Folder Persmissions
{{Cmd|chmod -R 777 /usr/share/webapps/bluebox}}


chmod -R 777 /etc/bluebox
Create a symlink to the create directory


Make Symlink to the bluesbox folder
{{Cmd|ln -s /usr/share/webapps/bluebox/ /var/www/localhost/htdocs/bluebox}}


ln -s /etc/bluebox/ /var/www/localhost/htdocs/bluesbox
== Configuring bluebox ==
== 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 101: 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 107: 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 118: Line 87:


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


Line 137: 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.