Asterisk for Raspberry Pi on ArchLinux: Difference between revisions

From KlavoWiki
Jump to navigationJump to search
No edit summary
 
(118 intermediate revisions by the same user not shown)
Line 1: Line 1:
Note: '''Work In Progress'''
If you don't want to follow these instructions and would prefer to download an image you can do so by downloading the image from [[Asterisk for Raspberry Pi Image]].


These instructions work for the Raberry Pi B-512 version with 512 MB RAM and not the 256MB version. You can follow these instruction for the 256MB version but you will have to skip the perl modules which is used for fax2mail and Google's text to speech.
The following instructions are based on Arch Linux ARM (archlinux-hf-2013-07-22.img.zip)


If you don't want to follow these instuctions and would prefer to download an image you can do so by downloading the image from [[Asterisk for Rasberry Pi Image]].
= Write Image to SD Card =
Using [http://launchpad.net/win32-image-writer/+download Win32DiskImager] and the latest version of [http://www.raspberrypi.org/downloads Arch Linux ARM] from Raspberry Pi write the image to the SD card.


Once the image is written insert the SD card into the Raspberry Pi and boot.  The device will get an IP address from DHCP.
= Update OS =
<pre>
<pre>
The following instructions are based on Arch Linux ARM (archlinux-hf-2012-09-18.zip)
pacman-key --init
pacman -Syu --noconfirm
reboot
</pre>


Write image to sdcard and boot Rasberry Pi.
= Utilities =
Install utilities to help with setup/administration
<pre>
pacman -S --noconfirm vim mlocate zip unzip
</pre>


expand sdcard to use full capacity
== vi to vim ==
  #  fdisk /dev/mmcblk0
<pre>
    d (delete)
pacman -R --noconfirm vi
    2 (partition 2)
ln -s /usr/bin/vim /usr/bin/vi
    n (new)
</pre>
    p (primary partition)
    2 (partition 2 as previously deleted)
    enter (accept default start sector)
    enter (accept default end sector)
    w (write changes)


  # reboot
== Create ll alias ==
<pre>
vi /root/.profile
</pre>


  # resize2fs /dev/mmcblk0p2
Add the following line
  # reboot
<pre>
alias ll="ls -la --color --group-directories-first --time-style=\"+%Y-%m-%d %H:%M\""
</pre>


= Time Synchronisation =
<pre>
cp -f /usr/share/zoneinfo/Australia/Brisbane /etc/localtime
</pre>


update operating system
= Set IP Address =
  # pacman -Syu
  # reboot


Install utilities to help with setup/administration
<pre>
  # pacman -S initscripts vim mlocate zip unzip
vi /boot/cmdline.txt
</pre>


Add the following text.  Make sure there is no carriage return at the end of the file and that everything is located on one line
<pre>
ip=192.168.1.11::192.168.1.254:255.255.255.0:rpi:eth0:off
</pre>


change vi to vim
Set DNS Servers, DNS suffix and DNS search.
  # pacman -R vi
<pre>
  # ln -s /usr/bin/vim /usr/bin/vi
vi /etc/resolv.conf
</pre>
add the lines
<pre>
domain mydomain.com
search mydomain.com
nameserver 192.168.1.254
</pre>


  # vim /root/.profile
After reboot check network settings
        alias ll="ls -la"
<pre>
ip addr show dev eth0
</pre>


enable sound card in Linux
other useful commands
  # vim /etc/rc.conf
<pre>
        MODULES=(snd-bcm2835)
ip addr add 192.168.17.250/24 dev eth0
ip route add 192.168.0.0/16 via 192.168.25.253 dev eth0


Regional settings
  # vim /etc/locale.gen (enable en_AU ISO-8859-1)
  # vim /etc/rc.conf
  # locale-gen


Time Synchronisation
ip addr delete 192.168.17.250/24 dev eth0
  # cp /usr/share/zoneinfo/Australia/Brisbane /etc/localtime
ip route delete 192.168.0.0/16 via 192.168.25.253 dev eth0
</pre>


  # pacman -R openntpd
= Expand Partition =
Now that the device has booted log on and change the default partition from 2 GB to the maximum partition of your SD card.
<pre>
fdisk /dev/mmcblk0
d (delete)
2 (partition 2)
n (new)
p (primary partition)
2 (partition 2 as previously deleted)
enter (accept default start sector)
enter (accept default end sector)
w (write changes)


  # pacman -S ntp
reboot
  # ntpdate ntp.bri.connect.com.au
</pre>


  # vim /etc/rc.conf
Once the rPi has rebooted
remove hwclock
<pre>
        add ntpdate
resize2fs /dev/mmcblk0p2
reboot
</pre>


Edit hostnamer and network settings
  #  vim /etc/hostname
  #  vim /etc/hosts


  #  vim /etc/dhcpcd.conf
= Swap File =
          add line: nohook resolv.conf
As the rPi has limited RAM, either 256 or 512 depending on your version we'll create a swap file to allow application to use higher memory if required.
        remove line: nohook lookup-hostname


  #  vim /etc/resolv.conf
I would recommend allocating the size of the swap file to be that equal to the RAM size.
domain klaverstyn.com
<pre>
search klaverstyn.com
fallocate -l 512M /swapfile
nameserver 192.168.13.1
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
</pre>


The swap file is now active.  We now need to ensure that it is used at boot.
<pre>
vi /etc/fstab
</pre>
add the line to the file
<pre>
/swapfile none swap defaults 0 0
</pre>


change IP address details
= Enable Sound Card =
  # vim /etc/conf.d/network
<pre>
vi /etc/rc.conf
</pre>


interface=eth0
add the line
address=192.168.1.1
netmask=255.255.255.0
broadcast=192.168.0.255
gateway=192.168.0.254


  # vim /etc/systemd/system/network.service
<pre>
MODULES=(snd-bcm2835)
</pre>


[Unit]
<pre>
Description=Network Connectivity
pacman -S --noconfirm alsa-utils
Wants=network.target
</pre>
Before=network.target


[Service]
Test with
Type=oneshot
<pre>
RemainAfterExit=yes
aplay /usr/share/sounds/alsa/Front_Left.wav && aplay /usr/share/sounds/alsa/Front_Center.wav && aplay /usr/share/sounds/alsa/Front_Right.wav
EnvironmentFile=/etc/conf.d/network
</pre>
ExecStart=/sbin/ip link set dev ${interface} up
ExecStart=/sbin/ip addr add ${address}/${netmask} broadcast ${broadcast} dev ${interface}
ExecStart=/sbin/ip route add default via ${gateway}
ExecStop=/sbin/ip addr flush dev ${interface}
ExecStop=/sbin/ip link set dev ${interface} down


[Install]
= Regional settings =
WantedBy=multi-user.target
Enable AU or country specific entries.
<pre>
vi /etc/locale.gen
</pre>


<pre>
vi /etc/rc.conf
locale-gen
</pre>


  # systemctl disable dhcpcd@eth0.service
= Hostname =
  # systemctl enable network.service
<pre>
vi /etc/hostname
</pre>


  # reboot
= Asterisk Packages =
Asterisk uses initscripts to start, stop and manage the asterisk service.  This causes a conflict with network and ntpdate.  We need to install initscripts but remove the networking and clock functions.
<pre>
pacman -S --noconfirm initscripts
</pre>


<pre>
vi /etc/rc.conf
</pre>
Remove '''ntpdate''', '''networking''' and '''sshd''' from DEAMONS=()
<br><br>


Install prerequisites for Asterisk.
<pre>
pacman -S --noconfirm gcc make hgsvn libxml2 libnewt sqlite subversion mysql spandsp speex
systemctl enable mysqld.service
systemctl start mysqld.service
</pre>


install required packages for asterisk
== Secure mysql ==
  # pacman -S gcc make hgsvn libxml2 libnewt sqlite subversion mysql spandsp speex
<pre>
  # systemctl enable mysqld.service
/usr/bin/mysql_secure_installation
  # systemctl start mysqld.service
</pre>


= Install Asterisk =
Download and install Asterisk.  You can refer to [[Asterisk Install]] if required, but only Asterisk is required.


secure mysql
  # /usr/bin/mysql_secure_installation


stop services to free memory
== Set Asterisk to Automatic ==
ensure correct time
<pre>
  # systemctl stop ntpd.service
vi /etc/rc.conf
  # systemctl stop mysqld.service
</pre>
and add '''asterisk''' to DEAMONS


install asterisk
== logrotate ==
<pre>
/etc/logrotate.d/asterisk  
</pre>
add the following lines to the file
<pre>
/var/log/asterisk/messages /var/log/asterisk/*log {
  missingok
  notifempty
  rotate 12
  weekly
  create 0640 root root
  postrotate
      /usr/sbin/asterisk -rx 'logger reload' > /dev/null 2> /dev/null
  endscript
}
</pre>


==  logger ==
<pre>
vi /etc/asterisk/logger.conf
</pre>
change from:
<pre>
;dateformat=%F %T
</pre>to
<pre>
dateformat=%F %T %Z
</pre>


Set asterisk service to start automatically
= Sendmail =
  # vim /etc/rc.conf
<pre>
  add asteirsk to DEAMONS=
pacman -R --noconfirm heirloom-mailx
rm /etc/mail.rc.pacsave
pacman -S --noconfirm ssmtp
</pre>
 
<pre>
vi /etc/ssmtp/ssmtp.conf
</pre>
and add the lines
<pre>
mailhub=192.168.13.3
hostname=rpi.klaverstyn.com
FromLineOverride=yes
</pre>
Edit aliases if required
<pre>
vi /etc/ssmtp/revaliases
</pre>


= Install Apache =
<pre>
pacman -S --noconfirm apache php-apache php php-gd
</pre>


Install Sendmail
<pre>
  # pacman -R heirloom-mailx
vi /etc/httpd/conf/httpd.conf
  # rm /etc/mail.rc.pacsave
</pre>
  # pacman -S ssmtp
and modify the following
  # vi /etc/ssmtp/ssmtp.conf
<pre>
          mailhub=192.168.13.3
AllowOverride All
          hostname=rpi.klaverstyn.com
DirectoryIndex index.php index.html index.htm index.html.var
          FromLineOverride=yes
</pre>


<pre>
systemctl enable httpd.service
</pre>


install Apache, PHP and aCDR
= Configure php =
  # pacman -S apache php-apache php php-gd
<pre>
vi /etc/php/php.ini
</pre>
uncomment
<pre>
extension=mysqli.so
extension=mysql.so
</pre>


  # vim /etc/httpd/conf/httpd.conf
Locate date.timezone and change accordingly.
        AllowOverride All
<pre>
        DirectoryIndex index.php index.html index.htm index.html.var
date.timezone = Australia/Brisbane
</pre>


  # systemctl enable httpd.service
For a list of [http://php.net/manual/en/timezones.php time zones]


  # vim /etc/php/php.ini
<pre>
      uncomment
vi /etc/httpd/conf/httpd.conf
          extension=mysqli.so
</pre>
          extension=mysql.so
add the following lines in thier respective sections
<pre>
LoadModule php5_module modules/libphp5.so
Include conf/extra/php5_module.conf
AddHandler application/x-httpd-php .php
</pre>


  # vim /etc/httpd/conf/httpd.conf
uncomment the following lines
          LoadModule php5_module modules/libphp5.so (add)
<pre>
          Include conf/extra/php5_module.conf      (add)
TypesConfig conf/mime.types
          TypesConfig conf/mime.types               (uncomment)
MIMEMagicFile conf/magic
          MIMEMagicFile conf/magic                 (uncomment)
</pre>
          AddHandler application/x-httpd-php .php  (add)


  # vim /etc/httpd/conf/mime.types
<pre>
          application/x-httpd-php5 php php5
vi /etc/httpd/conf/mime.types
</pre>
add the following line
<pre>
application/x-httpd-php5 php php5
</pre>
    
    


  # systemctl start httpd.service
<pre>
systemctl start httpd.service
</pre>


Note: The web root is /srv/http/
'''Note''': The web root is /srv/http/


= CDR =
Refer to the [[Cdr | Call Detail Records]] page which will allow Asterisk to write the CDR records to the database.


Backup Script
== aCDR ==
  # pacman -S smbclient
aCDR is a web appliction that allows you to search throught your CDR records. View the [[aCDR]] page on installation.
 
= Backup Script =
Refer to [[Asterisk Backup Shell Script]] for the script itself.
<pre>
pacman -S --noconfirm smbclient
</pre>


= perl =
NOTE: To install the perl module requires more RAM that what is available on the 256MB model of the rPi.  Make sure you have a swap file otherwise this section will fail.
<pre>
pacman -S --noconfirm perl perl-yaml libyaml perl-libwww sox mpg123
</pre>


== Text to Speech ==
<pre>
PERL_MM_USE_DEFAULT=1 perl -MCPAN -e "install Bundle::LWP"
PERL_MM_USE_DEFAULT=1 perl -MCPAN -e "install CGI::Util"
</pre>


google text to speech
<pre>
  # pacman -S perl-libwww sox mpg123
wget https://github.com/zaf/asterisk-googletts/blob/master/googletts.agi
  # perl -MCPAN -e "install Bundle::LWP"
mv googletts.agi /var/lib/asterisk/agi-bin/
  # perl -MCPAN -e "install CGI::Util"
chmod 755 /var/lib/asterisk/agi-bin/googletts.agi
</pre>


== fax2mail ==
<pre>
cd /usr/src
wget http://search.cpan.org/CPAN/authors/id/R/RO/ROSCH/mime-construct-1.11.tar.gz
tar xzvf mime-construct-1.11.tar.gz
rm -f mime-construct-1.11.tar.gz
cd mime-construct-1.11
perl Makefile.PL
make install
cd ..
</pre>


<pre>
PERL_MM_USE_DEFAULT=1 perl -MCPAN -e "install Bundle::LWP"
PERL_MM_USE_DEFAULT=1 perl -MCPAN -e "install Proc::WaitStat"
PERL_MM_USE_DEFAULT=1 perl -MCPAN -e "install MIME::Types"
</pre>


reference:
<pre>
https://wiki.archlinux.org/index.php/Systemd
wget http://www.klaverstyn.com.au/david/asterisk/files/fax2mail
https://wiki.archlinux.org/index.php/Configuring_Network
mv fax2mail /usr/sbin/
https://wiki.archlinux.org/index.php/Beginners%27_Guide
chmod 755 /usr/sbin/fax2mail
https://wiki.archlinux.org/index.php/LAMP#PHP
mkdir /var/spool/asterisk/fax
</pre>
</pre>
[[Category : Asterisk]]  [[Category : Rasberry Pi]]
 
= Reference =
http://wiki.archlinux.org/index.php/Systemd<br>
http://wiki.archlinux.org/index.php/Configuring_Network<br>
http://wiki.archlinux.org/index.php/Beginners%27_Guide<br>
http://wiki.archlinux.org/index.php/LAMP#PHP<br>
http://raw.github.com/Evilpaul/RPi-config/master/config.txt
 
 
[[Category : ArchLinux]] [[Category : Asterisk]]  [[Category : Raspberry Pi]]

Latest revision as of 11:30, 12 March 2014

If you don't want to follow these instructions and would prefer to download an image you can do so by downloading the image from Asterisk for Raspberry Pi Image.

The following instructions are based on Arch Linux ARM (archlinux-hf-2013-07-22.img.zip)

Write Image to SD Card

Using Win32DiskImager and the latest version of Arch Linux ARM from Raspberry Pi write the image to the SD card.

Once the image is written insert the SD card into the Raspberry Pi and boot. The device will get an IP address from DHCP.

Update OS

pacman-key --init
pacman -Syu --noconfirm
reboot

Utilities

Install utilities to help with setup/administration

pacman -S --noconfirm vim mlocate zip unzip

vi to vim

pacman -R --noconfirm vi
ln -s /usr/bin/vim /usr/bin/vi

Create ll alias

vi /root/.profile

Add the following line

alias ll="ls -la --color --group-directories-first --time-style=\"+%Y-%m-%d %H:%M\""

Time Synchronisation

cp -f /usr/share/zoneinfo/Australia/Brisbane /etc/localtime

Set IP Address

vi /boot/cmdline.txt

Add the following text. Make sure there is no carriage return at the end of the file and that everything is located on one line

ip=192.168.1.11::192.168.1.254:255.255.255.0:rpi:eth0:off

Set DNS Servers, DNS suffix and DNS search.

vi /etc/resolv.conf

add the lines

domain mydomain.com
search mydomain.com
nameserver 192.168.1.254

After reboot check network settings

ip addr show dev eth0

other useful commands

ip addr add 192.168.17.250/24 dev eth0
ip route add 192.168.0.0/16 via 192.168.25.253 dev eth0


ip addr delete 192.168.17.250/24 dev eth0
ip route delete 192.168.0.0/16 via 192.168.25.253 dev eth0

Expand Partition

Now that the device has booted log on and change the default partition from 2 GB to the maximum partition of your SD card.

fdisk /dev/mmcblk0
d (delete)
2 (partition 2)
n (new)
p (primary partition)
2 (partition 2 as previously deleted)
enter (accept default start sector)
enter (accept default end sector)
w (write changes)

reboot

Once the rPi has rebooted

resize2fs /dev/mmcblk0p2
reboot


Swap File

As the rPi has limited RAM, either 256 or 512 depending on your version we'll create a swap file to allow application to use higher memory if required.

I would recommend allocating the size of the swap file to be that equal to the RAM size.

fallocate -l 512M /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile

The swap file is now active. We now need to ensure that it is used at boot.

vi /etc/fstab

add the line to the file

/swapfile none swap defaults 0 0

Enable Sound Card

vi /etc/rc.conf

add the line

MODULES=(snd-bcm2835)
pacman -S --noconfirm alsa-utils

Test with

aplay /usr/share/sounds/alsa/Front_Left.wav && aplay /usr/share/sounds/alsa/Front_Center.wav && aplay /usr/share/sounds/alsa/Front_Right.wav

Regional settings

Enable AU or country specific entries.

vi /etc/locale.gen
vi /etc/rc.conf
locale-gen

Hostname

vi /etc/hostname

Asterisk Packages

Asterisk uses initscripts to start, stop and manage the asterisk service. This causes a conflict with network and ntpdate. We need to install initscripts but remove the networking and clock functions.

pacman -S --noconfirm initscripts 
vi /etc/rc.conf

Remove ntpdate, networking and sshd from DEAMONS=()

Install prerequisites for Asterisk.

pacman -S --noconfirm gcc make hgsvn libxml2 libnewt sqlite subversion mysql spandsp speex
systemctl enable mysqld.service
systemctl start mysqld.service

Secure mysql

/usr/bin/mysql_secure_installation

Install Asterisk

Download and install Asterisk. You can refer to Asterisk Install if required, but only Asterisk is required.


Set Asterisk to Automatic

vi /etc/rc.conf

and add asterisk to DEAMONS

logrotate

/etc/logrotate.d/asterisk 

add the following lines to the file

/var/log/asterisk/messages /var/log/asterisk/*log {
   missingok
   notifempty
   rotate 12
   weekly
   create 0640 root root
   postrotate
       /usr/sbin/asterisk -rx 'logger reload' > /dev/null 2> /dev/null
   endscript
}

logger

vi /etc/asterisk/logger.conf

change from:

;dateformat=%F %T

to

dateformat=%F %T %Z

Sendmail

pacman -R --noconfirm heirloom-mailx
rm /etc/mail.rc.pacsave
pacman -S --noconfirm ssmtp
vi /etc/ssmtp/ssmtp.conf

and add the lines

mailhub=192.168.13.3
hostname=rpi.klaverstyn.com
FromLineOverride=yes

Edit aliases if required

vi /etc/ssmtp/revaliases

Install Apache

pacman -S --noconfirm apache php-apache php php-gd 
vi /etc/httpd/conf/httpd.conf

and modify the following

AllowOverride All
DirectoryIndex index.php index.html index.htm index.html.var
systemctl enable httpd.service

Configure php

vi /etc/php/php.ini

uncomment

extension=mysqli.so
extension=mysql.so

Locate date.timezone and change accordingly.

date.timezone = Australia/Brisbane

For a list of time zones

vi /etc/httpd/conf/httpd.conf

add the following lines in thier respective sections

LoadModule php5_module modules/libphp5.so
Include conf/extra/php5_module.conf
AddHandler application/x-httpd-php .php

uncomment the following lines

TypesConfig conf/mime.types
MIMEMagicFile conf/magic
vi /etc/httpd/conf/mime.types

add the following line

application/x-httpd-php5		php php5


systemctl start httpd.service

Note: The web root is /srv/http/

CDR

Refer to the Call Detail Records page which will allow Asterisk to write the CDR records to the database.

aCDR

aCDR is a web appliction that allows you to search throught your CDR records. View the aCDR page on installation.

Backup Script

Refer to Asterisk Backup Shell Script for the script itself.

pacman -S --noconfirm smbclient

perl

NOTE: To install the perl module requires more RAM that what is available on the 256MB model of the rPi. Make sure you have a swap file otherwise this section will fail.

pacman -S --noconfirm perl perl-yaml libyaml perl-libwww sox mpg123

Text to Speech

PERL_MM_USE_DEFAULT=1 perl -MCPAN -e "install Bundle::LWP"
PERL_MM_USE_DEFAULT=1 perl -MCPAN -e "install CGI::Util"
wget https://github.com/zaf/asterisk-googletts/blob/master/googletts.agi
mv googletts.agi /var/lib/asterisk/agi-bin/
chmod 755 /var/lib/asterisk/agi-bin/googletts.agi

fax2mail

cd /usr/src
wget http://search.cpan.org/CPAN/authors/id/R/RO/ROSCH/mime-construct-1.11.tar.gz
tar xzvf mime-construct-1.11.tar.gz
rm -f mime-construct-1.11.tar.gz
cd mime-construct-1.11
perl Makefile.PL
make install 
cd ..
PERL_MM_USE_DEFAULT=1 perl -MCPAN -e "install Bundle::LWP"
PERL_MM_USE_DEFAULT=1 perl -MCPAN -e "install Proc::WaitStat"
PERL_MM_USE_DEFAULT=1 perl -MCPAN -e "install MIME::Types"
wget http://www.klaverstyn.com.au/david/asterisk/files/fax2mail
mv fax2mail /usr/sbin/
chmod 755 /usr/sbin/fax2mail
mkdir /var/spool/asterisk/fax

Reference

http://wiki.archlinux.org/index.php/Systemd
http://wiki.archlinux.org/index.php/Configuring_Network
http://wiki.archlinux.org/index.php/Beginners%27_Guide
http://wiki.archlinux.org/index.php/LAMP#PHP
http://raw.github.com/Evilpaul/RPi-config/master/config.txt