Skip to content

Instantly share code, notes, and snippets.

What would you like to do?
Install A2billing on Debian Wheezy Status Alpha Tutorial
install realtime Kernel and Kernel Headers:
apt-get install -y linux-image-rt-amd64 linux-headers-rt-amd64
remove the old kernel
apt-get remove -y linux-image-3.2.0-4-amd64 linux-headers-3.2.0-4-amd64
update-grub ##reconfigure the bootloader for the new Kernel
reboot ## start the sytstem with the new Kernel
uname -r ## check the new Kernel is loaded >>3.2.0-4-rt-amd64
Install Xtables Geoip Firewall:
apt-get install xtables-addons-common libtext-csv-xs-perl unzip
mkdir -p /usr/share/xt_geoip
cd /usr/lib/xtables-addons
./xt_geoip_build -D /usr/share/xt_geoip *.csv
make some iptables rules for xtables geoip:
iptables -I INPUT 1 -m state --state NEW -m geoip ! --source-country DE -j DROP ## alow Traffic only from Germany
iptables -I INPUT 1 -s -j ACCEPT ## allow internel Traffic
Now save the rules:
iptables-save > /root/geoip.fw
Make a Entry in rc.local for Start the geip Firewall at System Start:
nano /etc/init.d/rc.local
Append the line:
/sbin/iptables-restore < /root/geoip.fw
save the rc.local file and reboot the System
after reboot show the rules:
/sbin/iptables -L -v -n
apt-get upgrade
apt-get update
Configure your timezone:
dpkg-reconfigure tzdata
Install some pre-requisites:
apt-get install libapache2-mod-php5 php5 php5-common
apt-get install php5-cli php5-mysql mysql-server apache2 php5-gd
apt-get install php5-mcrypt
apt-get install build-essential wget libssl-dev libncurses5-dev libnewt-dev libxml2-dev linux-headers-$(uname -r) libsqlite3-dev uuid-dev sendmail
Add jansson and install Asterisk
apt-get install python-software-properties -y
apt-key adv --keyserver --recv-keys 175E41DF
tar -zxf jansson-2.4.tar.gz
cd jansson-2.4/
./configure --prefix=/usr/ && make clean && make && make install
cd /usr/src/
tar zxvf dahdi-linux-complete*
tar zxvf libpri*
tar zxvf asterisk*
cd /usr/src/dahdi-linux-complete*
make && make install && make config
cd ../libpri*
make && make install
cd ../asterisk*
./configure && make menuselect && make && make install && make config && make samples
/etc/init.d/dahdi start
/etc/init.d/asterisk start
asterisk -rvvv
*CLI> dahdi show version
+++++++++++++++DAHDI Version: 2.6.1 Echo Canceller: HWEC
*CLI> pri show version
+++++++++++++++libpri version: 1.4.13
Download and install A2billing:
cd /usr/local/src
tar -zxvf master.tar.gz
rm master.tar.gz
mv a2billing-* a2billing
Prep the database:
cd a2billing/DataBase/mysql-5.x
mysql -uroot -p < a2billing-createdb-user.sql
You will be asked to enter details. Enter them as follows
database name : mya2billing
hostname : localhost
User : root
Password : mysqlpassword (This is the one we created earlier)
Copy and edit a2billing.conf:
cp /usr/local/src/a2billing/a2billing.conf /etc/
nano -w /etc/a2billing.conf
Make sure the first stanza looks like the following:
hostname = localhost
port = 3306
user = a2billinguser
password = mysqlpassword
dbname = mya2billing
dbtype = mysql
Additional files for A2billing:
chmod 777 /etc/asterisk -R
touch /etc/asterisk/additional_a2billing_iax.conf
touch /etc/asterisk/additional_a2billing_sip.conf
echo include additional_a2billing_iax.conf >> /etc/asterisk/iax.conf
chown -Rf www-data /etc/asterisk/additional_a2billing_iax.conf
chown -Rf www-data /etc/asterisk/additional_a2billing_sip.conf
Install the A2billing sounds:
cd /usr/local/src/a2billing/addons/sounds
Asterisk ended with exit status 1
chown -R asterisk:asterisk /usr/share/asterisk/sounds/
Edit manager.conf:
nano -w /etc/asterisk/manager.conf
Install the AGI etc:
mkdir /usr/share/asterisk/agi-bin
cd /usr/local/src/a2billing/AGI
cp a2billing.php /usr/share/asterisk/agi-bin/
chown -R asterisk:asterisk /usr/share/asterisk/agi-bin
chmod 755 /usr/share/asterisk/agi-bin/a2billing.php
cp /usr/local/src/a2billing/common/lib /usr/share/asterisk/agi-bin/lib -R
Install the webui:
mkdir /var/www/a2billing
chown www-data:www-data /var/www/a2billing
cp -rf /usr/local/src/a2billing/admin /var/www/a2billing
cp -rf /usr/local/src/a2billing/agent /var/www/a2billing
cp -rf /usr/local/src/a2billing/customer /var/www/a2billing
cp -rf /usr/local/src/a2billing/common /var/www/a2billing
chmod 755 /var/www/a2billing/admin/templates_c
chmod 755 /var/www/a2billing/customer/templates_c
chmod 755 /var/www/a2billing/agent/templates_c
chown -R www-data:www-data /var/www
Add contexts to extensions.conf: (For wholesale termination)
nano -w /etc/asterisk/extensions.conf
; CallingCard application
;exten => _X.,1,Answer
;exten => _X.,2,Wait(2)
;exten => _X.,3,deadAGI(a2billing.php)
;exten => _X.,4,Wait(2)
;exten => _X.,5,Hangup
exten => _X.,1,deadAGI(a2billing.php)
exten => _X.,n,Hangup
; CallingCard application
exten => _X.,1,deadAGI(a2billing.php,1,did)
Add some cron entries:
crontab -e
# update the currency table
0 6 * * * php /usr/local/src/a2billing/Cronjobs/currencies_update_yahoo.php
# manage the monthly services subscription
0 6 1 * * php /usr/local/src/a2billing/Cronjobs/a2billing_subscription_fee.php
# To check account of each Users and send an email if the balance is
#less than the user have choice.
0 * * * * php /usr/local/src/a2billing/Cronjobs/a2billing_notify_account.php
# this script will browse all the DID that are reserve and check if
#the customer need to pay for it
# bill them or warn them per email to know if they want to pay in
#order to keep their DIDs
0 2 * * * php /usr/local/src/a2billing/Cronjobs/a2billing_bill_diduse.php
# This script will take care of the recurring service.
0 12 * * * php /usr/local/src/a2billing/Cronjobs/a2billing_batch_process.php
# To generate invoices and for each user.
0 6 * * * php /usr/local/src/a2billing/Cronjobs/a2billing_batch_billing.php
# to proceed the autodialer
*/5 * * * * php /usr/local/src/a2billing/Cronjobs/a2billing_batch_autodialer.php
# manage alarms
0 * * * * php /usr/local/src/a2billing/Cronjobs/a2billing_alarm.php
Make a logfile:
mkdir /var/log/a2billing
touch /var/log/a2billing/a2billing_agi.log
chown -R asterisk:asterisk /var/log/a2billing
Add some rotation:
cd /etc/logrotate.d
mkdir -p /var/log/a2billing
touch /var/log/a2billing/cront_a2b_alarm.log
touch /var/log/a2billing/cront_a2b_autorefill.log
touch /var/log/a2billing/cront_a2b_batch_process.log
touch /var/log/a2billing/cront_a2b_archive_data.log
touch /var/log/a2billing/cront_a2b_bill_diduse.log
touch /var/log/a2billing/cront_a2b_subscription_fee.log
touch /var/log/a2billing/cront_a2b_currency_update.log
touch /var/log/a2billing/cront_a2b_invoice.log
touch /var/log/a2billing/cront_a2b_check_account.log
touch /var/log/a2billing/a2billing_paypal.log
touch /var/log/a2billing/a2billing_epayment.log
touch /var/log/a2billing/a2billing_api_ecommerce_request.log
touch /var/log/a2billing/a2billing_api_callback_request.log
touch /var/log/a2billing/a2billing_api_card.log
touch /var/log/a2billing/a2billing_agi.log
Enable SSL using default certificate for admin:
ln -s /etc/apache2/sites-available/default-ssl /etc/apache2/sites-enabled/000-default-ssl
a2enmod rewrite
service apache2 restart
Asterisk Realtime
It may be beneficial to use Asterisk Realtime with A2billing. If running Asterisk Realtime you do not need to reload every time you add/remove/change a customer. Also it allows you to share the A2billing database between multiple Aserisk/FreePBX servers if you needed to do that. If you need to create many customers it makes more sense to use a database instead of putting them all in a flat text file. Double check you have the Asterisk Realtime module installed. If using 64bit OS the modules are in /usr/lib64/asterisk/modules.
cd /usr/lib/asterisk/modules
There should be a file there called If not you need to re-install Asterisk and set it to compile the realtime module in menuselect. Add the following to /etc/asterisk/extconfig.conf
nano /etc/asterisk/extconfig.conf
NOTE: [settings] is already included and uncommented in this file in asterisk sample configurations. So if you installed asterisk samples or FreePBX and this file already exists and you are trying to add to it, do not add this line twice.
iaxusers => mysql,general,cc_iax_buddies
iaxpeers => mysql,general,cc_iax_buddies
sipusers => mysql,general,cc_sip_buddies
sippeers => mysql,general,cc_sip_buddies
extensions => mysql,general,cc_sip_buddies
Add the following to /etc/asterisk/res_config_mysql.conf
nano /etc/asterisk/res_config_mysql.conf
NOTE: [general] is already included and uncommented in this file in asterisk samples. So if you installed asterisk samples or FreePBX and this file already exists and you are trying to add to it, do not add this line twice.
dbhost =
dbname = mya2billing
dbuser = a2billinguser
dbpass = a2billing
dbport = 3306
;dbsock = /var/lib/mysql/mysql.sock
Assuming (as we did in this guide) that the dbname=mya2billing, dbuser=a2billinguser, dbpassword=a2billing. Double check that these settings match /etc/a2billing.conf and substitute as necessary.
Now restart freepbx/asterisk
amportal restart
To check if realtime is working:
From Asterisk CLI>
# asterisk -vvvr
> core show config mappings
Should produce:
Config Engine: mysql
===> extensions (db=general, table=cc_sip_buddies)
===> iaxpeers (db=general, table=cc_iax_buddies)
===> iaxusers (db=general, table=cc_iax_buddies)
===> sippeers (db=general, table=cc_sip_buddies)
===> sipusers (db=general, table=cc_sip_buddies)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment