freepbx

###

Installing FreePBX

###

Important Warning!

FreePBX _will_ overwrite any exisiting asterisk configurations you may have. This project attempts

to manage as much of asterisk as it can, and this means lots of automatically generated dialplans.

Please visit the Documentation site (http://www.freepbx.org/support/documentation) for instructions,

hints and tips. As a rule of thumb, any existing sip, iax, or extensions files can be

copied to the same name with _custom.conf appended, and things will continue to work as before.

###############################################################################################

###############################################################################################

### THESE INSTRUCTIONS ARE OUTDATED!!!!! (JULY, 2008) ###

### PLEASE VISIT: ###

### http://www.freepbx.org/support/documentation/installation ###

### ###

### FOR UP TO DATE INSTRUCTIONS ###

###############################################################################################

###############################################################################################

###

FreePBX has several requirements, including the following packages (names may vary based on distro):

libxml2

libxml2-devel

libtiff

libtiff-devel

lame

httpd (or Apache2)

mysql (or mysql-client)

mysql-devel (or libmysqlclient10-dev)

mysql-server

php (or php4) NOTE!!! Only standard php is supported, hardened PHP projects are NOT supported!!

(on debian, also install libapache2-mod-php4)

php4-pear (if pear is not included with your php)

php-mysql

(on SUSE, also install php4-gettext and php4-session)

php-gd

openssl

openssl-devel (or libssl-dev)

kernel-devel (or linux-source)

perl

perl-CPAN

bison

ncurses-devel (or libncurses5-dev)

audiofile-devel (or libaudiofile-devel)

curl

sox

###

FreePBX requires the following changes to php and apache for uploading new MOH files:

(Note: Thise are reasonably distro specifc. Check http://www.aussievoip.com/wiki/FreePBX

for more documentation)

- vi +482 /etc/php.ini (or /etc/php4/apache2/php.ini)

upload_max_filesize=20M

- vi +14 /etc/httpd/conf.d/php.conf (if you have it)

LimitRequestBody 20000000

###

Download the latest FreePBX files:

- download the latest FreePBX tarball to /usr/src

- tar -zxvf freepbx<version>.tar.gz

###

Getting Asterisk and Zaptel from SVN or download the latest Asterisk and Zaptel source archives

(FreePBX uses the v2.0 branch)

- cd /usr/src

- svn checkout http://svn.digium.com/svn/asterisk/branches/1.2 asterisk-1.2

- svn checkout http://svn.digium.com/svn/zaptel/branches/1.2 zaptel-1.2

- svn checkout http://svn.digium.com/svn/libpri/branches/1.2 libpri-1.2

###

For TDM zap devices (FXO/FXS):

- cd /usr/src/zaptel

- make && make install

If you will be using a Digium telephony card that supports T1/E1 signaling do this step as well:

- cd /usr/src/libpri


###

Patching Asterisk with softfax/spandsp.

- Download the latest 0.2 spandsp files from http://www.soft-switch.org

- cd /usr/src/spandsp-xxx

- ./configure


The spandsp libraries are installed to /usr/local/lib. Therefore /usr/local/lib must be added to the LD_LIBRARY_PATH environment variable of the user that starts the asterisk process. To be safe, also add it to /etc/ld.so.conf and run ldconfig.

Copy the following files (from soft-switch.org) to /usr/src/asterisk/apps/ :

- cp app_rxfax.c /usr/src/asterisk/apps/

- cp app_txfax.c /usr/src/asterisk/apps/

- cp apps_makefile.patch /usr/src/asterisk/apps/

- cd /usr/src/asterisk/apps

- patch < apps_makefile.patch

###

Create a group and non-root user:

- groupadd asterisk

- useradd -c "asterisk PBX" -d /var/lib/asterisk -g asterisk asterisk

###

Building Asterisk and configuring it to run as a non-root user

- mkdir /var/run/asterisk

- cd /usr/src/asterisk

- make clean && make && make install

###

Get and build cdr_mysql module for asterisk

- cd /usr/src/asterisk-addons

- perl -p -i.bak -e 's/CFLAGS.*D_GNU_SOURCE/CFLAGS+=-D_GNU_SOURCE\nCFLAGS+=-DMYSQL_LOGUNIQUEID/' Makefile

- make clean && make && make install

###

Install asterisk-sounds

- cd /usr/src/asterisk-sounds

- make install

###

Setting up MySQL for CDR and FreePBX web interface

- /usr/bin/mysql_install_db

- /etc/init.d/mysqld start (or /etc/init.d/mysql start)

- mysqladmin -u root password 'db_root_pwd'

- mysqladmin create asteriskcdrdb -p

- mysql --user=root --password=db_root_pwd asteriskcdrdb < /usr/src/freepbx<version>/SQL/cdr_mysql_table.sql

- mysqladmin create asterisk -p

- mysql --user root -p asterisk < /usr/src/freepbx<version>/SQL/newinstall.sql

###

Grant access to these two databases you just created

**Note the default mysql username/password is asteriskuser/amp109.

**If you change either of these, you will be prompted for them while running ./install below

- mysql --user root -p

mysql> GRANT ALL PRIVILEGES ON asteriskcdrdb.* TO asteriskuser@localhost IDENTIFIED BY 'amp109';

Query OK, 0 rows affected (0.00 sec)

mysql> GRANT ALL PRIVILEGES ON asterisk.* TO asteriskuser@localhost IDENTIFIED BY 'amp109';

Query OK, 0 rows affected (0.00 sec)

mysql> quit

###

Run the "install" script to install all the FreePBX files:

- /usr/src/FreePBX/install_amp

###

Configure zaptel driver:

a. Edit /etc/zaptel.conf to reflect installed Digium telephony card(s).

Only the parameters/values relevant to a TDM400P with 4 FXO modules are included below:

fxsks=1-4

loadzone=us

defaultzone=us

Only the parameters/values relevant to a TE110P (T1 configuration) are included below:

span=1,1,0,esf,b8zs

bchan=1-23

dchan=24

loadzone=us

defaultzone=us

b. ztcfg -v

Zaptel Configuration

======================

1 channels configured.

If you get a warning about unable to open master device /dev/zap/ctl, that's ok. It's a result

of the zaptel module(s) not loaded yet.

Detailed information with regard to Asterisk's configuration files can be found here:

http://voip-info.org/wiki-Asterisk+config+files

###

Configure zapata module in asterisk config.

- edit /etc/asterisk/zapata.conf to reflect installed digium interfaces (see zapata.conf.template)

Only the parameters/values relevant to a TDM400P with 4 FXO modules are included below:

[channels]

language=en

#include zapata_additional.conf

context=from-pstn

signalling=fxs_ks

faxdetect=incoming

usecallerid=yes

callerid=asreceived

echocancel=yes

callprogress=no

busydetect=no

echocancelwhenbridged=no

echotraining=800

group=0

channel=1-4

Only the parameters/values relevant to a TE110P (T1 configuration) are included below:

[channels]

language=en


context=from-pstn

switchtype=national

pridialplan=national

signalling=pri_cpe

faxdetect=incoming

usecallerid=yes

echocancel=yes

callerid=asreceived

echocancelwhenbridged=no

echotraining=800

group=0

channel=1-23

Note: if your configuration is using zap channels as FXS endpoints, zapata.conf must

contain the following line in order to provision these endpoints in FreePBX's Extensions admin:


Detailed information with regard to Asterisk's configuration files can be found here:

http://voip-info.org/wiki-Asterisk+config+files

###

httpd (Apache) configuration

- Edit /etc/httpd/conf/httpd.conf (or /etc/apache2/apache2.conf) so that:

User asterisk

Group asterisk

###

Chown the PHP session.save_path directory:

- chown asterisk /var/lib/php/session

###

Amportal Control Script

FreePBX's amportal control script starts, stops or kills services in the FreePBX environment, and sets permissions on directories/files in the

FreePBX environment:

[root@pbx root]# amportal

----------AMP Control Script-----------

Usage: amportal start|stop|kill|chown

start: Starts Asterisk and Flash Operator Panel server

stop: Gracefully stops Asterisk and the FOP server

kill: Kills Asterisk and the FOP server

chown: Sets appropriate permissions on files

The amportal script is the recommended way to stop and start asterisk:

[root@pbx root]# /usr/sbin/amportal stop

[root@pbx root]# /usr/sbin/amportal start

###

Auto Start

The module/driver that you load at boot time depends upon whether you are using a

TDM400P or TE110P. The wcfxs module should be loaded for the former and the wcte11xp

module should be loaded for the latter.

The following scripts are for RedHat and derivatives that use an rc.local:

Edit /etc/rc.d/rc.local to include the following for the TDM400P:

#!/bin/sh

#

# This script will be executed *after* all the other init scripts.

# You can put your own initialization stuff in here if you don't

# want to do the full Sys V style init stuff.

touch /var/lock/subsys/local

echo Loading wcfxs

/sbin/modprobe wcfxs

/usr/sbin/amportal start

Edit /etc/rc.d/rc.local to include the following for the TE110P:

#!/bin/sh

#

# This script will be executed *after* all the other init scripts.

# You can put your own initialization stuff in here if you don't

# want to do the full Sys V style init stuff.

touch /var/lock/subsys/local

echo Loading wcte11xp

/sbin/modprobe wcte11xp

/usr/sbin/amportal start

For Debian and others (?), you'll have to add startup script(s) to /etc/init.d and link them

to the appropriate rc?.d runlevel.

Also ensure that mysql and apache are set to start at bootup. For RedHat-based systems do the following:

- chkconfig --level 3 httpd on

- chkconfig --level 3 mysqld on

###

Start everything (or reboot and it should start automagically):

- As root run:

service httpd restart

(or /etc/init.d/apache2 restart)

- As root run:

amportal start

- Point your browser to:

http://[ip address] (default login is admin/admin)

If you notice any errors or updates that are needed to this document, please e-mail:

[email protected]

freepbx

Documents

Transcript of freepbx