2600hz: Difference between revisions

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]}

Create Main Administrator

Master Administration Account

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

Telephony Engine

In Telephony Configuration

Conf Directory: /etc/freeswitch

Global Sound File Directory: /usr/sounds

Installation

Ready to Install

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.

@@ Line 1: / Line 1: @@
-== WORK IN PROGRESS
+{{Expand|This page is outdated and possibly should be considered for deletion}}
-== What is 2600hz? ==
-hz 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
-* 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 ==
- /etc/init.d/postgresql setup
-'''Starting http service and adding to boot'''
- /etc/init.d/postgresql start && rc-update add postgresql default
 == 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 ==
@@ Line 61: / Line 22: @@
 '''Starting http and sql server and adding to boot'''
- /etc/init.d/postgresql setup
+{{Cmd|rc-service postgresql setup
- /etc/init.d/postgresql start && rc-update add postgresql default
+rc-service postgresql start && rc-update add postgresql default
- /etc/init.d/lighttpd start && rc-update add lighttpd default
+rc-service lighttpd start && rc-update add lighttpd default }}
 == 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 <nowiki>https://github.com/2600hz/bluebox.git</nowiki> 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: <nowiki>http://WEBSERVER_IP_ADDRESS/bluebox</nowiki> and start configuration.
 * Welcome to Bluebox 1.0 Setup Wizard
@@ Line 101: / Line 60: @@
 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
@@ Line 107: / Line 69: @@
 Master Administration Account
- Email Address:
+Email Address:'''youremail@yourserver.net'''
- Password:
+Password:'''adminpassword'''
- Confirm Password:
+Confirm Password:'''adminpassword'''
 Next
@@ Line 118: / Line 80: @@
 Conf Directory: '''/etc/freeswitch'''
 Global Sound File Directory: '''/usr/sounds'''
@@ Line 137: / 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.
-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.
+[[Category:SQL]]
+[[Category:Telephony]]