Aster-install

This document is deprecated. This script is not maintained.
Please refer to Asterisk Install

What is aster-install

aster-install is a shell script for Linux that will install Asterisk with the necessary add-ons for Asterisk to function with dahdi, faxing and Asterisk Analyser. The shell script is designed to run on a clean installation of CentOS based on the instructions CentOS_Installation.

What does aster-install install

aster-install will install the following components plus any dependencies:

• Asterisk version 1.4.x or 1.6.x
• DAHDi
• g729 and g723 codec
• iLBC codec
• speex codec
• openclose. Announce if office is closed, Out of Hours or Public holiday etc.
• MySQL
• Apache
• spanDSP
• agx-ast-addons if Asterisk 1.4.x selected (faxing)
• fax2mail script
• CDR Analyser
• Flash Operator Panel
• phpSysinfo
• NTP time synchronisation
• Backup script /opt/asterisk-backup. Saves backups to /usr/lib/asterisk/backups/
• LDAPget. Asterisk 1.4.x only. Asterisk 1.6.x is currently not supported.
• Cepstral Text-to-Speech engin
• Option to install mpg123 for MOH

What does not get installed

To be implemented

• Asterisk svn support.
• WEB Callback and Voice Conferencing
• Asterisk GUI. I'm currently thinking about implementing this but not 100% sure if I should.

How do I install and activate the script

To install the script copy and past the following lines to your Linux CLI

yum -y install wget
wget http://www.klaverstyn.com.au/asterisk/script/aster-install.sh
wget http://www.klaverstyn.com.au/asterisk/script/aster-values
chmod +x aster-install.sh

Edit the file aster-values to suite your needs, then run aster-install.sh

./aster-install.sh install

What is aster-values

aster-values is the data file that contains the version of the applications that you want to install.

Editing aster-values

The file has the following sections:

• Asterisk version
• Codec type for sound files
• MySQL user and database details
• phpsysinfo
• OS updates
• Internode repository
• email address for logwatch
• spanDSP version
• FOP version and username/password details

Once you open the file and look at its contents it becomes self explanatory.

Testing Installation

Asterisk Functional

From the Linux CLI type in:

asterisk -r

If you are entered into the Asterisk CLI then you know Asterisk has been installed correctly. If asterisk did not start it could possibly be the cause of an incompatible g729/3 codec. Edit aster-values and change the value of Install_g72x to equal no.

g729, g723 codec

core show translation

If you see a dash under the g729 or g723 column then the codec is not installed.

Faxing

core show applications like fax

should give you a result like

    -= Matching Asterisk Applications =-
           NVFaxDetect: Detects fax sounds on all channel types (IAX and SIP too)
                 RxFAX: Receive a FAX to a file
                 TxFAX: Send a FAX file
    -= 3 Applications Matching =-

CDR

cdr mysql status

should give a result like

Connected to asteriskcdr@127.0.0.1 using table cdr for 7 minutes, 26 seconds.
  Wrote 0 records since last restart.

WEB Sites

Using a WEB browser you should be able to connect to the WEB CDR Analyser and pspSysInfo

http://ipaddress/cdr
http://ipaddress/sysinfo
http://ipaddress/panel

DAHDi

dahdi show status

should give a result like

Description                              Alarms     IRQ        bpviol     CRC4
DAHDI_DUMMY/1 (source: RTC) 1            UNCONFIGUR 0          0          0

LDAPget

core show application LDAPget

should give a result like

  -= Info about application 'LDAPget' =-

[Synopsis]
Retrieve a value from an ldap directory

[Description]
  LDAPget(varname=config-file-section/key): Retrieves a value from an LDAP
directory and stores it in the given variable. Always returns 0.  If the
requested key is not found, jumps to priority n+101 if available.

Change Log

Date        Information

20090902    aster-install.sh        * agx-ast-addons has changed the way you download thier application.  They are now forcing you
                                      to download the SVN version.  Currently the SVN version will not compile against Asterisk
                                      version 1.4.17.x.  The module app_confcall fails to build.
                                    * Due to the new agx-ast-addons version, the requirment of spanDSP is 0.0.6 pre 12 ONLY.
                                      aster-values have been changed accordingly.

20090813    aster-values            * aster-values has been updated for the following components
                                                Asterisk 1.6.0.13
                                             DAHDI Linux 2.2.0.2
                                    Flash Operator Panel 0.30

20090713    aster-values            * aster-values has been updated for the following components
                                             DAHDI Linux 2.2.0.1
                                             DAHDI Tools 2.2.0
                                                  Libpri 1.4.10.1
                                                  mpg123 1.8.1
            aster-install.sh        * mime construct has changed.  The mirror for Internode is no longer part of the mime
                                      construct script.  Changes to the options used so the mime construct script will complete
                                      and install.

20090606    aster-values            * aster-values has been updated to use the latest release of Asterisk 1.6.0.10.

20090522    aster-values            * aster-values has been updated to use the latest release of Asterisk Addons 1.6.0.2.

20090516    Asterisk DL Path Change * Asterisk announced the path to download the Asterisk open source applictions has changed.
                                      This change has now been updated in the aster-install.sh script.
            aster-values            * Added the parameter tts.  This will allow you to install cepstral at a later time or
                                      install multiple voices by changing the Name value in aster-values between each run.

20090513    Parameter requirement   * Parameters are now required to use aster-install.sh.  The valid parameters are install,
                                      display and codec.  Not specifying any parameters will display a help screen explaining
                                      that a parameter is required and what each parameter does.
            aster-values            * With the release of spanDSP version 0.0.6pre12 aster-values has been updated.

20090512    Modified g729/3 codecs  * Added the ability to download compatible codec's for Asterisk 1.6.2.x

20090508    mpg123                  * mpg123 is used to stream music to Asterisk.  Used for playing radio stations to people
                                      that are on hold or parked or waiting in a conference.

20090429    aster-values            * With the release of Asterisk and Asterisk-Addons version 1.6.1.0, aster-values has been
                                      changed to default to download the new version.

20090428    TTS                     * Included the installation of cepstral Text-to-Speech engin.  The default value in
                                      aster-values is TTS=no so the engin by default will not install.

20090424    spandsp                 * In their wisdom the file locations for the spandsp files have been moved.  The script has
                                      been updated to use the new structure.  spandsp-0.0.6pre10 has also been released and
                                      tested with Asterisk 1.6.0.x install.  aster-values is now preselected for
                                      spandsp-0.0.6pre10.

            LDAPget                 * Added the Asterisk module LDAPget

20090421    spandsp                 * spandsp-0.0.6pre8 was released yesterday.  Changed the spanDSP_pre value in aster-values
                                      so spandsp-0.0.6pre8 is installed when using Asterisk 1.6.x.  Asterisk successfully
                                      compiled the fax components using release pre8.

20090416    Modified g729/3 codecs  * Included the g729 and g723 codec builds for Core2, Pentium IV and Pentium III processors.
                                    * Added the value codec to be entered as an argument.  If the value of codec is found the
                                      script will remove any g729 and g723 installed codec's and install the codec as listed
                                      in aster-values.

20090415    Added codec's           * Included iLBC codec.
                                    * Included speex codec.
                                    * Added values in aster-values to select sound file types.  WAV, G729, ULAW etc.
            FOP                     * Included Flash Operator Panel

20090409    Added openclose.agi     * An AGI script that will check if the office is open/closed or closed because
                                      of a public holiday or other type of day (i.e. stocktake).
                                    * Also addedd the context reception to extensions.conf to the agi script
                                      can run based on result.

20090407    CDR Analyser Patch      * Modify /var/www/html/cdr/export_pdf.php
                                      Allows exporting to PDF

            g729 and g723 codec     * The g729 and g723 codec's will only function if you have a pentium 4 processor.
                                      If you have a different type of processor Asterisk will not start unless you
                                      set the value Install_g72x="no"

20090406    First Release.          * Installs Asterisk 1.4.x or 1.6.x
                                      DAHDi
                                      spanDSP
                                      agx-ast-addons if using Asterisk 1.4.x
                                      MySQL
                                      CDR Analyser
                                      phpSysInfo
                                      Module Cleanup