Forum archive
TKLPatch for Asterisk
Hi all! If you'd like to bring the power of VoIP systems to your SOHO, here's all you need! This TKLPatch will convert Turnkey Core 10.04 beta to a powerfull Asterisk system with FreePBX installed. I'm giving my first steps on this world of telephony over ip, so as allways, this patch surely needs a lot of test. FreePBX is like a child, it starts nicely and then begin to complain about a lots of things, but I was able to stabilize the installation so that it's happy and without complains! If there's someone in the community with is more experienced with asterisk, please be kind to install and test this one.
Features:
What it does:
HOSTNAME=asterisk
echo "$HOSTNAME" > /etc/hostname
sed -i "s|127.0.1.1 \(.*\)|127.0.1.1 $HOSTNAME|" /etc/hosts
hostname asterisk
echo deb-src http://archive.ubuntu.com/ubuntu lucid universe >> /etc/apt/sources.list.d/sources.list
install apache2 php5 mysql-server php5-mysql php5-cli php-pear php-db makepasswd asterisk sox ssl-cert asterisk-sounds-extra mpg123
cd /usr/src/
apt-get -y build-dep asterisk-addons
apt-get -b source asterisk-addons
dpkg -i *.deb
sed -i "s/www-data/asterisk/" /etc/apache2/envvars
wget http://mirror.freepbx.org/freepbx-2.8.0.tar.gz
tar xzf freepbx-2.8.0.tar.gz
rm freepbx-2.8.0.tar.gz
cd freepbx-2.8.0/
mysqladmin -u root create asterisk
mysqladmin -u root create asteriskcdrdb
mysql -u root asterisk < SQL/newinstall.sql
mysql -u root asteriskcdrdb < SQL/cdr_mysql_table.sql
mysql -u root <<-END_PRIVS
GRANT ALL PRIVILEGES ON asterisk.* TO asteriskuser@localhost IDENTIFIED BY "amp109";
GRANT ALL PRIVILEGES ON asteriskcdrdb.* TO asteriskuser@localhost IDENTIFIED BY "amp109";
flush privileges;
END_PRIVS
sed -i 's/\(^upload_max_filesize = \).*/\120M/' /etc/php5/apache2/php.ini
cp /etc/asterisk/modules.conf /etc/asterisk/modules.conf.bak
# Initial run of installation
./install_amp
# Second run to bypass the Cannot redeclare __parse_DialRulesFile() error
if [ $? = 255 ]; then
echo "Second run..."
./install_amp
fi
cp /etc/asterisk/modules.conf.bak /etc/asterisk/modules.conf
mv /etc/asterisk/sip_notify.conf /etc/asterisk/sip_notify.conf.bak
ln -s /var/www/admin/modules/core/etc/sip_notify.conf /etc/asterisk/
ln -s /var/lib/asterisk/moh /var/lib/asterisk/mohmp3
mkdir -p /var/lib/asterisk/agi-bin
chown -R asterisk:asterisk /var/www
chown -R asterisk:asterisk /var/lib/asterisk
chown -R asterisk:asterisk /etc/asterisk
chown -R asterisk:asterisk /usr/share/asterisk
chown asterisk:asterisk /etc/amportal.conf
/var/lib/asterisk/bin/module_admin upgradeall
sed -i -e "s/^\(exit 0\)$/\/usr\/local\/sbin\/amportal start\n\1\n/" /etc/rc.local
update-rc.d -f asterisk remove
sed -i "s/BACKGROUND=0/BACKGROUND=1/" /usr/sbin/safe_asterisk
a2dissite default
a2ensite freepbx
a2ensite freepbx-ssl
a2enmod ssl
service apache2 stop
service mysql stop
cleanup_apt
cd /
rm -Rf /usr/src/
mkdir -p /usr/srcKnown Issues:
Replies (16)
Wow, this must have been a difficult integration!
Reply 1Handling upgrades: can't do the ideal thing, just the next best
Reply 2Unfortunately, we don't have the resources to do this for even a small fraction of the software in the TurnKey library though perhaps once we gain enough traction we can try to get ISVs on board with the idea that this is something they should be doing themselves. So we can't do the ideal thing yet, but you don't have to be perfect to be useful. At least we're still helping users setup their initial installation with all the added value that TurnKey provides.
The next best thing would be to update an appliance every so often with new versions from upstream and let users use TKLBAM to migrate their data between those versions. Either that or help them migrate in place by documenting the process. We've also done that in the past, but it's more work than an automatic process.
I don't really qualify but...
Reply 3As usual I'm happy to chip in my 2c :)!
If we can't rely on the repo upgrades anyway (which we can't really if its in Universe) then I'm thinking it sounds like a good reason to go with the upstream 4yr "LTS" install. Pity really that they don't offer their own repo. Actually they do but only for RPM based distros so no good for us. I found a PPA of 1.8 but I don't think a random PPA is a valid repo choice for a TKL appliance!
The only other thing that occurs to me is how will updates be handled? Will it simply be a case of updating the appliance and rereleasing it (and use TKLBAM to migrate data) or will there be some other upgrade mechanism available?
There are also other things to consider
Reply 4While I'm a fan of latest versions (I think you guys have notice that), we must remember the other components that tightly integrate in this appliance, as it's the freePBX software. So I'll first check if the current freePBX is completely compatible with the new 1.8 release of Asterisk.
Upgrades, they'll surely have a way to apply upgrade to currently running systems, and if there's a very important fix in the software, we can make a script and hang it in the appliance page to help people get the upgrade ok.
I'll research a little and if everything looks fine, and we agree that we should use 1.8 (I would like to!) I'll work on a new release for this patch.
Asterisk 1.8 is out but is it worth the upgrade?
Reply 5The main thing I'm finding interesting about Asterisk v1.8 is that it's the first version since 1.4 to be deemed a "long term support" version.
The main disadvantage in using a new version of Asterisk v1.8 would be that we have to pull it in from upstream rather than from the package management system. I'm interested in feedback from those who know more about this on whether or not this would be worth it. We do occasionally install from upstream even when a package is available (e.g., WordPress) but the benefits have to outweigh the costs (e.g., more complex integration, harder to upgrade).
In this case I'm not worried about losing security updates from Ubuntu because Asterisk is in the Universe repository anyhow and I'll doubt Canonical will make an exception for such a complex piece of software.
I'm only nominally familiar
Reply 6I'm only nominally familiar with how you all develop these packages but very much enjoy the fruits!
That said, 1.8 with the Google Voice support sounds very useful.
Thanks for the tip John
Reply 7It's been almost a year from the creation of this patch, surelly it needs an update, taking in consideration the security issues you note. Maybe we can include the iptables rules mentioned in the article and leave access from the local network by default.
I never got this one to production so this kind of feedback is very welcome.
A word of caution
Reply 8Adrian, I would include a note of caution for users warning that the system should only be implemented behind a firewall that blocks inbound access to SIP, otherwise you're just asking for a whopping phone bill.
See NerdVittles article http://nerdvittles.com/?p=684 for more details. Access to SIP should be limited to the local network, or remotely through SSL or VPN. I would recommend you explore adding these features for your own protection.
PS: I'm exploring a similar combination using Freeswitch and BlueBox.
Alternative
Reply 9Hi,
great job on the VOIP appliance. I love asterix and have played with it for quite a while.
I use a little known image from Askozia (www.askozia.com) and it is built from T2 Linux providing only the required apps to make it tick. As a consequence the image is only about 50Mb. I use it on Proxmox and dedicated hardware. It will run on almost anything PC and the free version supports 2 concurrent calls.
Askozia
Reply 10Askozia doesn't look to be free....
TKLPatch for Asterisk UPDATED
Reply 11
If you'd like to create a new TurnKey appliance use TKLDev
Reply 12The scripts that we use to produce all the builds are collectively called buildtasks. The script to produce the container builds is bt-container.
If you are going to produce a new TurnKey appliance, then I suggest that you start a new thread.
CentOS container on TurnKey LXC appliance
Reply 13Bruce, I'm not sure if the context of your question is referring to the ability to run a CentOS container on a TurnKey LXC appliance, but for the purpose of this discussion, I'll assume it is. When the TurnKey LXC appliance was first introduced in version 13.0, the ability to download container images from other sources was inherited from LXC. The appliance added the option to download and modify OpenVZ images from the TurnKey repository. This allows the LXC appliance to run images from TurnKey and others such as CentOS, Ubuntu, etc. While you could create a custom CentOS container with Asterisk and your scripts, then run it on a TurnKey LXC appliance, it still wouldn't be a TurnKey appliance.
In my previous job, I did some work with Asterisk and VoIP. I had been thinking about developing an appliance based on Freeswitch and the BlueBox fork of FreePBX. That was several years ago and now the BlueBox project has been abandoned and replaced by Kazoo with which I am not familiar.
As Jeremy said, TKLdev is now the preferred environment for developing new appliances.
http://wiki.freepbx.org/display/FOP/Installing+FreePBX+13+on+Debian+8.1 should have the details about how to install Asterisk and FreePBX on a TurnKey 14.x (Debian Jessie) appliance. I suggest you start with the 'LAMP' appliance since it will include both Apache and MySQL which are prerequisites for FreePBX.
It won't work on CentOS as is
Reply 14Regardless a quick google suggests that it installs on Debian fine: http://wiki.freepbx.org/display/FOP/Installing+FreePBX+13+on+Debian+8.1 So we could create a TurnKey build for it. I'm not sure when we'll get to it though. As a small open source company our bottleneck is labour. So we really need to focus our limited resources on maintaining the appliances we have and adding new features that provide the most leverage (i.e. apply to all or at least most of the current appliances).
It sounds like you are more familiar with CentOS, but if you were at all interested in helping us develop a TurnKey FreePBX appliance then we would happily add it to the library. Let me know if you are even vaguely interested in that.
Although it would still not be the same as the FreePBX VM, unless we can work out what they are adding beyond what can normally be installed.
Probably best to ask FreePBX
Reply 15Unfortunately this Asterisk appliance never made it into the library. So we don't have a current build.
Regarding creating a FreePBX container. Is the ISO they provide built on Debann (or even Ubuntu)? If so then you might be able to use our buildtasks container buildscript (bt-container) although it's designed for use with TurnKey appliances so may require some tweaking and customisation... And like I say there may be some technical reason why a container won't work properly...
FreePBX + Asterisk in a container
Reply 16Unfortunately, Alain's TKLpatch never made it to the list of supported TurnKey appliances.
I've previously run TrixBox both on native hardware and in a VirtualBox VM (not a container). As I recall, there was a need to tweak the clock settings on the VirtualBox host since Asterisk relies on the hardware clock for system timing. I've never tried to run in a container. A quick Google search turned up a lot of requests, but no preconfigured templates. A pair of YouTube videos, https://www.youtube.com/watch?v=AVIhPqZZRz4, suggest that it is possible but I think you will have to start by installing a CentOS template and then manually installing and configuring Asterisk and FreePBX. Probably not the answer you were looking for.
For the benefit of others who may not be familiar with Asterisk - here's my summary: it's open source phone switch designed to route voice (and video). In VoIP mode you connect your VoIP phones to the switch through an IP network. You can also use a soft phone program from any PC or smartphone. The switch then routes the calls your phone makes just like a conventional phone switch would.
For users with legacy hardware Asterisk also supports interfacing with analog phone systems, though this requires some extra hardware (and configuration!).
Just like with any other IP application you could use Asterisk to setup a 100% private phone system that just routes phone calls within your organization's Intranet. In this case no access to the outside world would be required. But most users will probably want to interface with the "public" phone system. You can do that by interface with a SIP gateway that provides these services for a cost.
It looks like one of the easiest phone gateway solutions to set up is SIPstation which, if I'm not mistaken, is bundled with FreePBX, a web configuration front-end to Asterisk. Asterisk is a back-end component (e.g,. like Apache, but for phone system stuff).
Unfortunately I'm a bit out of my depth here so an actual review is hard to do right now. I imagine that and not lack of interest is the reason you didn't get more feedback from the community. Once we convert this to a TurnKey appliance we'll dive deeper and may have more feedback. Stay tuned!