FREEPBX INSTALL GUIDE
---------------------

Author: Anton Raharja - anton at ngoprek dot org

Current linux distribution: Ubuntu server 7.10
Current kernel version: 2.6.22-14-server

Login as root and follow steps below:
	notes:
	- you are required to connect your Ubuntu server to the Internet
	- for fast update and upgrade please configure your apt source 
	  to the fastest reachable server 
	- in this tutorial you are assumed using Intel Pentium 4
	- some of your installed apache server configuration will be changed
	- you are recommended to use fresh install of Ubuntu server 7.10
	  (you will later update and upgrade this server)

apt-get update
apt-get upgrade

apt-get install mc build-essential libncurses5-dev libssl-dev libmysqlclient15-dev 
apt-get install linux-headers-`uname -r` apache2 php5 php5-cli php-pear php-db 
apt-get install php5-gd php5-mysql mysql-server openssh-server curl sox subversion
	note:
	put 'rahasia' (without quote) as mysql server root password
	please remember that this is only for the sake of following this manual
	later on you have to change it to your own password

tar -zxf asterisk-sounds-0.1.tar.gz
tar -zxf zaptel-firmware-0.1.tar.gz

tar -zxf libpri-1.4.3.tar.gz
cd libpri-1.4.3
make
make install
cd ../

tar -zxf zaptel-1.4.8.tar.gz
cd zaptel-1.4.8
./configure
make menuconfig
	note: 
	select all options on ‘Utilities’
	press x to save selections
cp ../zaptel-firmware-0.1/firmware/* firmware/
make
make install
make config
cd ../

tar -zxf asterisk-1.4.17.tar.gz
cd asterisk-1.4.17
./configure
make menuconfig
	note:
	remove chan_mgcp, chan_phone, chan_oss, chan_skinny from ‘Channel Drivers’
	remove codec_adpcm, codec_a_mu, codec_lpc10 from ‘Codec Translators’
	select EXTRA-SOUNDS-EN-GSM from 'Extras Sound Packages'
	press x to save selections
cp ../asterisk-sounds-0.1/sounds/* sounds/
make
make install
make samples
genzaptelconf
	note:
	genzaptelconf is part of zaptel package, but make sure to execute this after 
	installing asterisk
cd ../

tar -zxf asterisk-addons-1.4.5.tar.gz
cd asterisk-addons-1.4.5
./configure
make menuconfig
	note:
	remove chan_ooh323 from ‘Asterisk Addon Modules’
	make sure the rest is selected
make
make install
make samples
cd ../

tar -zxf codec-g723-g729-p4-0.1.tar.gz
cd codec-g723-g729-p4-0.1
cp codec_g729-ast14-gcc4-glibc-pentium4.so /usr/lib/asterisk/modules/codec_g729.so
cp codec_g723-ast14-gcc4-glibc-pentium4.so /usr/lib/asterisk/modules/codec_g723.so
cd ../

useradd -s /bin/false -m asterisk
	note:
	default shell is /bin/false and create a home directory (needed by FOP)

mcedit /etc/apache2/apache2.conf
	note:
	look for this lines:
	    User www-data
	    Group www-data
	and change to below lines:
	    User asterisk
	    Group asterisk

a2enmod php5
/etc/init.d/apache2 restart

chown asterisk.asterisk /etc/asterisk -R
chown asterisk.asterisk /usr/lib/asterisk -R
chown asterisk.asterisk /var/lib/asterisk -R
chown asterisk.asterisk /var/log/asterisk -R
chown asterisk.asterisk /var/spool/asterisk -R

mcedit /etc/asterisk/asterisk.conf
	note:
	look for astrundir path like this line:
	    astrundir => /var/run
	and change it to:
	    astrundir => /var/log/asterisk

asterisk -U asterisk -G asterisk

mysqladmin -u root -p password rahasia
	note:
	lets make sure that you change the mysql server root password
	'rahasia' (without quote) is a password chosen for testing purposes only

mysqladmin -u root -p create asterisk
mysqladmin -u root -p create asteriskcdrdb

tar -zxf freepbx-2.3.1.tar.gz
cd freepbx-2.3.1
mysql -u root -p asterisk < SQL/newinstall.sql
mysql -u root -p asteriskcdrdb < SQL/cdr_mysql_table.sql
./install_amp
	note:
	Q: Enter your USERNAME to connect to the 'asterisk' database:
	A: root
	Q: Enter your PASSWORD to connect to the 'asterisk' database:
	A: rahasia
	Q: Enter the path to use for your AMP web root:
	A: /var/www
	Q: Enter the IP ADDRESS or hostname used to access the AMP web-admin:
	A: <your server IP address>
	Change above IP address to your own IP

ln -s /usr/local/sbin/amportal /etc/init.d/amportal
update-rc.d amportal defaults
cd ../

rm -f /etc/asterisk/extensions.conf
rm -f /etc/asterisk/sip.conf
rm -f /etc/asterisk/iax.conf
rm -f /etc/asterisk/zapata.conf

mcedit /etc/asterisk/zapata.conf
	note:
	type below lines and save the file:
	    [trunkgroups]                                                                                                                
	    [channels]                                                                                                                   
	    #include zapata-channels.conf

chown asterisk.asterisk /etc/asterisk/zapata.conf

/etc/init.d/amportal start

browse FreePBX admin web page, http://<your server IP address>/admin (please use Firefox)
and click 'Apply Configuration Changes' on top of the page

mcedit /etc/asterisk/sip.conf
	note:
	look for lines like below:
	    disallow=all
	    allow=ulaw
	    allow=alaw
	and change them to:
	    disallow=all
	    ; enable g729 and gsm only when you have remote agents (from internet)
	    ;allow=g729
	    ;allow=gsm
	    allow=ulaw
	    allow=alaw
	    ; enable below options for video support (now disabled)
	    ;allow=h264
	    ;allow=h263p
	    ;allow=h263
	    ;videosupport=yes
	    ;maxcallbitrate=128

mcedit /etc/asterisk/iax.conf
	note:
	look for lines like below:
	    disallow=all
	    allow=ulaw
	    allow=alaw
	    allow=gsm
	and change them to:
	    disallow=all
	    ; enable g729 and gsm only when you have remote agents (from internet)
	    ;allow=g729
	    ;allow=gsm
	    allow=ulaw
	    allow=alaw

asterisk -rx "reload"

back to FreePBX admin web page and start configuring. installation finish.

that's all :)
onto next journey ! configurations !

Regards,
Anton Raharja
http://www.antonraharja.web.id
http://www.voiprakyat.or.id