Aster-install

From KlavoWiki
Jump to navigationJump to search

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

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

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

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 explain that
                                      a parameter is required and what each parameter does.

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