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...')
 
(replace /etc/init.d with rc-service)
 
(31 intermediate revisions by 10 users not shown)
Line 1: Line 1:
== WORK IN PROGRESS
{{Expand|This page is outdated and possibly should be considered for deletion}}
== 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.
[https://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.


== Set up 2600hz bluesbox on Alpine Linux ==
== Install Lighttpd ==


This document will be a very quick c/p guide to setup 2600hz on Alpine linux. What we will setup is the following:
{{:Setting Up Lighttpd With FastCGI}}


* Lighttpd with PHP
== Installing FreeSwitch ==
* Postgresql
* git
* 2600hz (bluesbox)
* Freeswitch


== Install lighttpd, PHP and postgresql ==
First use <code>apk</code> to install the needed software parts.


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


== Configuring Lighttpd ==
Change the permissions of {{Path|/etc/freeswitch/}}


'''Edit lighttpd.conf'''
{{Cmd|chown lighttpd:lighttpd /etc/freeswitch/
chmod 777 -R /etc/freeswitch/}}


nano +46 /etc/lighttpd/lighttpd.conf
== Starting ==
 
   
Uncomment line:
'''Starting http and sql server and adding to boot'''
 
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 ==
 
  /etc/init.d/postgresql setup
 
'''Starting http service and adding to boot'''


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


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


'''Install 2600hz (bluesbox)'''
Create a {{Path|webapps}} folder
 
Download
 
cd /tmp
git clone git://source.2600hz.org/bluebox.git bluebox/
 
Change Folder Name
 
mv bluebox/ /etc/bluebox
 
Change Folder Persmissions
 
chmod -R 777 /etc/bluebox
 
Make Symlink to the bluesbox folder
 
ln -s /etc/bluebox/ /var/www/localhost/htdocs/bluesbox


{{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 <nowiki>https://github.com/2600hz/bluebox.git</nowiki> 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: <nowiki>http://WEBSERVER_IP_ADDRESS/bluebox</nowiki> and start configuration.


* Welcome to Bluebox 1.0 Setup Wizard
* Welcome to Bluebox 1.0 Setup Wizard
Line 102: Line 60:
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 - https://2600hz.atlassian.net/browse/BLUEBOX-445{{dead link}}
Next
Next


Line 108: Line 69:
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 80:


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


Line 138: Line 100:


'''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: <nowiki>http://WEBSERVER_IP_ADDRESS:8080/bluebox</nowiki>
 
'''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]]

Latest revision as of 10:18, 17 November 2023

This material needs expanding ...

This page is outdated and possibly should be considered for deletion

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

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

rc-service postgresql setup rc-service postgresql start && rc-update add postgresql default rc-service 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 https://github.com/2600hz/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 - https://2600hz.atlassian.net/browse/BLUEBOX-445[Dead Link]

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=25706"