Asterisk Management Portal Installation Guide



Similar documents
Installing Booked scheduler on CentOS 6.5

LAMP Quickstart for Red Hat Enterprise Linux 4

OpenVox DE210E/DE410E User Manual

INUVIKA OVD INSTALLING INUVIKA OVD ON RHEL 6

AX400P User Manual. ATCOM Analog Card AX400P User Manual Version:

OpenVox D110P/D110E User Manual

Install Cacti Network Monitoring Tool on CentOS 6.4 / RHEL 6.4 / Scientific Linux 6.4

Partek Flow Installation Guide

Product Guide Version: 1.0

Desktop : Ubuntu Desktop, Ubuntu Desktop Server : RedHat EL 5, RedHat EL 6, Ubuntu Server, Ubuntu Server, CentOS 5, CentOS 6

Installation Guide for WebSphere Application Server (WAS) and its Fix Packs on AIX V5.3L

IIS, FTP Server and Windows

OpenVox Communication Co.Ltd. OpenVox-Best Cost Effective Asterisk Cards

Windows Template Creation Guide. How to build your own Windows VM templates for deployment in Cloudturk.

Cloud Homework instructions for AWS default instance (Red Hat based)

Deploying IBM Lotus Domino on Red Hat Enterprise Linux 5. Version 1.0

1. Product Information

Server Installation/Upgrade Guide

WHM Administrator s Guide

Online Backup Client User Manual Linux

JobScheduler - Amazon AMI Installation

How To Install Amyshelf On Windows 2000 Or Later

GestióIP IPAM v3.0 IP address management software Installation Guide v0.1

Installing Virtual Coordinator (VC) in Linux Systems that use RPM (Red Hat, Fedora, CentOS) Document # 15807A1-103 Date: Aug 06, 2012

OpenPro ERP Software Installation Guide REDHAT LINUX

PCI BASED ISDN INTERFACE CARD

Livezilla How to Install on Shared Hosting By: Jon Manning

System and Network Monitoring With Zabbix

Table of Contents. Overview Features Applications Hardware requirement Card dimensions Software Installation...

EZcast Installation guide

RecoveryVault Express Client User Manual

FireBLAST Marketing Solution v2

Backup and Restore MySQL Databases

Bitrix Site Manager. VMBitrix Virtual Machine. Quick Start And Usage Guide

SAMBA SERVER (PDC) Samba is comprised of a suite of RPMs that come on the RHEL/Fedora CDs. The files are named:

LOCKSS on LINUX. CentOS6 Installation Manual 08/22/2013

Installation of PHP, MariaDB, and Apache

Online Backup Linux Client User Manual

Redhat 6.2 Installation Howto -Basic Proxy and Transparent

My Account Quick Start

Online Backup Client User Manual

Apache 2.0 Installation Guide

Installation Guide for AmiRNA and WMD3 Release 3.1

Newton Linux User Group Graphing SNMP with Cacti and RRDtool

Installing the Operating System or Hypervisor

LOCKSS on LINUX. Installation Manual and the OpenBSD Transition 02/17/2011

Online Backup Client User Manual

IPPBX FAQ. For Firmware Version: V2.0/V

Installing, Uninstalling, and Upgrading Service Monitor

Sophos Anti-Virus for Linux configuration guide. Product version: 9

Red Hat JBoss Core Services Apache HTTP Server 2.4 Apache HTTP Server Installation Guide

Bitrix Site Manager ASP.NET. Installation Guide

Troubleshooting / FAQ

Amahi Instruction Manual

Team Foundation Server 2013 Installation Guide

Thirdlane PBX and Thirdlane PBX Manager 6.0

ULTEO OPEN VIRTUAL DESKTOP V4.0

CN=Monitor Installation and Configuration v2.0

Active Directory Integration. Documentation. v1.02. making your facilities work for you!

TANDBERG MANAGEMENT SUITE 10.0

Parallels Plesk Automation

Practical Guide. How to setup VoIP Infrastructure using AsteriskNOW

Getting Started with Dynamic Web Sites

Plesk 11 Manual. Fasthosts Customer Support

10 STEPS TO YOUR FIRST QNX PROGRAM. QUICKSTART GUIDE Second Edition

4PSA Total Backup User's Guide. for Plesk and newer versions

dotdefender v5.12 for Apache Installation Guide Applicure Web Application Firewall Applicure Technologies Ltd. 1 of 11 support@applicure.

Security Correlation Server Quick Installation Guide

SNMP Upgrade Procedure for NV Transmitters

Installing and Configuring MySQL as StoreGrid Backend Database on Linux

Host your websites. The process to host a single website is different from having multiple sites.

CA Spectrum and CA Service Desk

Secure File Transfer Installation. Sender Recipient Attached FIles Pages Date. Development Internal/External None 11 6/23/08

HOW TO BUILD A VMWARE APPLIANCE: A CASE STUDY

Installation Guide. McAfee VirusScan Enterprise for Linux Software

Dell SupportAssist Version 2.0 for Dell OpenManage Essentials Quick Start Guide

IBM Endpoint Manager Version 9.1. Patch Management for Red Hat Enterprise Linux User's Guide

Rancid Server Build and Operation Overview (v0.3) (This is being done from memory so expect some errors)

Installation Manual for Grid Monitoring Tool

StoreGrid Backup Server With MySQL As Backend Database:

ilaw Installation Procedure

Using Internet or Windows Explorer to Upload Your Site

ZeroTurnaround License Server User Manual 1.4.0

CPE111 COMPUTER EXPLORATION

Avalanche Remote Control User Guide. Version 4.1.3

User Guide - escan for Linux File Server

Customer Tips. Xerox Network Scanning TWAIN Configuration for the WorkCentre 7328/7335/7345. for the user. Purpose. Background

Installation Guidelines (MySQL database & Archivists Toolkit client)

Maintaining the Content Server

Avira Update Manager User Manual

Note: With v3.2, the DocuSign Fetch application was renamed DocuSign Retrieve.

iview (v2.0) Administrator Guide Version 1.0

VoIP Laboratory B How to re flash an IP04

Introduction to Operating Systems

How to configure your Desktop Computer and Mobile Devices post migrating to Microsoft Office 365

User Manual. Onsight Management Suite Version 5.1. Another Innovation by Librestream

Transcription:

Asterisk Management Portal Installation Guide i. Linux Installation White Box Enterprise Linux (WBEL) is the distribution used throughout this guide. We believe that the goals of the distribution are in good alignment with the mission critical nature of a small business telephone system. WBEL ISOs can be downloaded from a number of mirror sites. Check the official WBEL website for more information: http://www.whiteboxlinux.org/ Detailing a Linux installation is beyond the scope of this document. There are numerous articles, HOW TOs and books available to the individual that deal with this subject. Therefore, for the purposes of this document it is assumed that the WBEL installation is that of a Server system (the other choices given during installation are: Personal Desktop, Workstation and Custom). Furthermore, for the purposes of this document it is assumed that the partitioning of the hard disk drive was done automatically by selecting Autopartition when prompted, and that no previous partitions existed on the drive prior to installation. A note about Package Group Selection. It is not recommended to use the X Window System on a production AMP/Asterisk server. Therefore, since a mouse is not needed, this document also assumes that the text based installation method of WBEL is used. AMP has several requirements (which we will cover in a later section) but at this point of the WBEL installation ensure that the following package groups are selected (or deselected if the Server system selected them by default): Text based Internet Server Configuration Tools Web Server Mail Server [Deselect Windows File Server] MySQL Database Development Tools Kernel Development Administration Tools [Deselect Printing Support]

ii. Post Install Configuration For performance and security reasons it is important to update the system immediately after install. WBEL uses yum for this purpose. You should edit (as root) the /etc/yum.conf file to point to a mirror close to you. Here is an example yum.conf: [main] cachedir=/var/cache/yum debuglevel=2 logfile=/var/log/yum.log pkgpolicy=newest distroverpkg=whitebox-release tolerant=1 exactarch=1 [base] name=white Box Enterprise Linux $releasever - $basearch - Base #baseurl=http://whiteboxlinux.org/pub/$releasever/en/os/$basearch baseurl=http://mirror.cpsc.ucalgary.ca/mirror/whiteboxlinux.org/3.0/en/os/i386 [updates-released] name=white Box Enterprise Linux $releasever - $basearch - Released Updates #baseurl=http://whiteboxlinux.org/pub/$releasever/en/updates/ baseurl=http://mirror.cpsc.ucalgary.ca/mirror/whiteboxlinux.org/3.0/en/updates #[updates-testing] #name=white Box Enterprise Linux $releasever - $basearch - Unreleased Updates #baseurl=http://whiteboxlinux.org/pub/$releasever/en/os/testing/ Having edited /etc/yum.conf to point to a mirror, proceed with updating the system by running (as root) from the commandline: [root@pbx etc]# yum -y update

1. Additional Package Installation to Satisfy AMP/Asterisk dependencies You can check if a particular package is installed by doing either: yum info [package] or: rpm qa grep [package] If the package is not installed, install it by using yum: yum install [package] See the yum man page for more information. The following packages need to be installed with yum (as root): libxml2 libtiff libtiff devel httpd mysql mysql devel mysql server php php mysql openssl openssl devel kernel source perl perl CPAN cvs bison ncurses devel audiofile devel

lame may not be available through a yum repository; it can be obtained from: http://apt.sw.be/redhat/el3/en/i386/rpms.dag/lame 3.96.1 1.1.el3.dag.i386.rpm Download and install the rpm: [root@pbx tmp]# wget http://apt.sw.be/redhat/el3/en/i386/rpms.dag/lame-3.96.1-1.1.el3.dag.i386.rpm [root@pbx tmp]# rpm -ivh lame-3.96.1-1.1.el3.dag.i386.rpm warning: lame-3.96.1-1.1.el3.dag.i386.rpm: V3 DSA signature: NOKEY, key ID 6b8d79e6 Preparing... ########################################### [100%] 1:lame ########################################### [100%] 2. Satisfying AMP's PERL module dependencies a. From the commandline run the following (as root): perl MCPAN e "install Net::Telnet" This will invoke the CPAN Configuration routine. More information on the prompts can be found here, under the CONFIGURATION section: http://search.cpan.org/~jhi/perl 5.8.0/lib/CPAN.pm Note that you can safely answer no when prompted "Are you ready for manual configuration?". It will just take longer to install because you will not configure a nearby repository. I recommend going through the configuration routine if only to specify a local repository. You can pretty much just hit <Enter> for everything (assuming the system has 1 CPU) but the specification of the local repository. The output below only includes the sections relevant to specifying a local repository and the building and installing of the module: [root@pbx root]# perl -MCPAN -e "install Net::Telnet" /usr/lib/perl5/5.8.0/cpan/config.pm initialized. CPAN is the world-wide archive of perl resources. It consists of about 100 sites that all replicate the same contents all around the globe.

Many countries have at least one CPAN site already. The resources found on CPAN are easily accessible with the CPAN.pm module. If you want to use CPAN.pm, you have to configure it properly. If you do not want to enter a dialog now, you can answer 'no' to this question and I'll try to autoconfigure. (Note: you can revisit this dialog anytime later by typing 'o conf init' at the cpan prompt.) Are you ready for manual configuration? [yes] [snip] You have no /root/.cpan/sources/mirrored.by I'm trying to fetch one CPAN: LWP::UserAgent loaded ok Fetching with LWP: ftp://ftp.perl.org/pub/cpan/mirrored.by Now we need to know where your favorite CPAN sites are located. Push a few sites onto the array (just in case the first on the array won't work). If you are mirroring CPAN to your local workstation, specify a file: URL. First, pick a nearby continent and country (you can pick several of each, separated by spaces, or none if you just want to keep your existing selections). Then, you will be presented with a list of URLs of CPAN mirrors in the countries you selected, along with previously selected URLs. Select some of those URLs, or just keep the old list. Finally, you will be prompted for any extra URLs -- file:, ftp:, or http: -- that host a CPAN mirror. (1) Africa (2) Asia (3) Central America (4) Europe (5) North America (6) Oceania (7) South America Select your continent (or several nearby continents) [] 5 Sorry! since you don't have any existing picks, you must make a geographic selection. (1) Canada (2) Mexico (3) United States Select your country (or several nearby countries) [] 1 Sorry! since you don't have any existing picks, you must make a geographic selection. (1) ftp://cpan.chebucto.ns.ca/pub/cpan/ (2) ftp://cpan.mirror.cygnal.ca/pub/cpan/ (3) ftp://cpan.sunsite.ualberta.ca/pub/cpan/ (4) ftp://ftp.nrc.ca/pub/cpan/ (5) ftp://mirror.isurf.ca/pub/cpan (6) ftp://theoryx5.uwinnipeg.ca/pub/cpan/ Select as many URLs as you like,

put them on one line, separated by blanks [] 3 Enter another URL or RETURN to quit: [] New set of picks: ftp://cpan.sunsite.ualberta.ca/pub/cpan/ [snip] commit: wrote /usr/lib/perl5/5.8.0/cpan/config.pm CPAN: Storable loaded ok Going to read /root/.cpan/metadata Database was generated on Sat, 13 Nov 2004 05:10:14 GMT Running install for module Net::Telnet Running make for J/JR/JROGERS/Net-Telnet-3.03.tar.gz CPAN: Digest::MD5 loaded ok Fetching with LWP: ftp://cpan.sunsite.ualberta.ca/pub/cpan/authors/id/j/jr/jrogers/checksums Checksum for /root/.cpan/sources/authors/id/j/jr/jrogers/net-telnet- 3.03.tar.gz ok Scanning cache /root/.cpan/build for sizes Net-Telnet-3.03/ Net-Telnet-3.03/Makefile.PL Net-Telnet-3.03/ChangeLog Net-Telnet-3.03/lib/ Net-Telnet-3.03/lib/Net/ Net-Telnet-3.03/lib/Net/Telnet.pm Net-Telnet-3.03/t/ Net-Telnet-3.03/t/select.t Net-Telnet-3.03/README Net-Telnet-3.03/MANIFEST CPAN.pm: Going to build J/JR/JROGERS/Net-Telnet-3.03.tar.gz Checking if your kit is complete... Looks good Writing Makefile for Net::Telnet cp lib/net/telnet.pm blib/lib/net/telnet.pm Manifying blib/man3/net::telnet.3pm /usr/bin/make -- OK Running make test PERL_DL_NONLAZY=1 /usr/bin/perl "-MExtUtils::Command::MM" "-e" "test_harness (0, 'blib/lib', 'blib/arch')" t/*.t t/select...ok All tests successful. Files=1, Tests=3, 0 wallclock secs ( 0.12 cusr + 0.02 csys = 0.14 CPU) /usr/bin/make test -- OK Running make install Installing /usr/lib/perl5/site_perl/5.8.0/net/telnet.pm Installing /usr/share/man/man3/net::telnet.3pm Writing /usr/lib/perl5/site_perl/5.8.0/i386-linux-threadmulti/auto/net/telnet/.packlist Appending installation info to /usr/lib/perl5/5.8.0/i386-linux-threadmulti/perllocal.pod /usr/bin/make install -- OK

Install these PERL modules (as root) as well: [root@pbx root]# perl -MCPAN -e "install IPC::Signal" [root@pbx root]# perl -MCPAN -e "install Proc::WaitStat" b. Download and install (as root) mime construct; as of this writing: [root@pbx tmp]# wget http://search.cpan.org/cpan/authors/id/r/ro/rosch/mimeconstruct-1.8.tar.gz [root@pbx tmp]# tar zxf mime-construct-1.8.tar.gz [root@pbx tmp]# cd mime-construct-1.8 [root@pbx mime-construct-1.8]# perl Makefile.PL [root@pbx mime-construct-1.8]# make install c. Download and install asterisk perl; as of this writing: [root@pbx tmp]# wget http://asterisk.gnuinter.net/files/asterisk-perl- 0.08.tar.gz [root@pbx tmp]# tar zxf asterisk-perl-0.08.tar.gz [root@pbx tmp]# cd asterisk-perl-0.08 [root@pbx asterisk-perl-0.08]# perl Makefile.PL Writing Makefile for asterisk-perl [root@pbx asterisk-perl-0.08]# make install 3. Install mpg123 (for Music on Hold); as of this writing: [root@pbx tmp]# wget http://www.mpg123.de/mpg123/mpg123-0.59r.tar.gz [root@pbx tmp]# tar zxf mpg123-0.59r.tar.gz [root@pbx tmp]# cd mpg123-0.59r [root@pbx mpg123-0.59r]# make linux [root@pbx mpg123-0.59r]# make install 4. Getting the latest AMP files [root@pbx mpg123-0.59r]# cd /usr/src [root@pbx src]# wget http://unc.dl.sourceforge.net/sourceforge/amportal/amp- 1.10.003.tar.gz [root@pbx src]# tar zxf AMP-1.10.003.tar.gz 5. Getting Asterisk and Zaptel [root@pbx src]# export CVSROOT=:pserver:anoncvs@cvs.digium.com:/usr/cvsroot [root@pbx src]# cvs login Logging in to :pserver:anoncvs@cvs.digium.com:2401/usr/cvsroot CVS password:

(the password is: anoncvs) [root@pbx src]# cvs checkout -r v1-0 zaptel asterisk asterisk-addons 6. Build/Compile the zaptel drivers [root@pbx src]# cd zaptel [root@pbx zaptel]# make && make install 7. Patching Asterisk for incoming fax functionality (softfax/spandsp) Download the latest spandsp files from http://www.opencall.org; as of this writing: [root@pbx src]# wget ftp://ftp.opencall.org/pub/spandsp/spandsp- 0.0.2pre4/spandsp-0.0.2pre4.tar.gz [root@pbx src]# tar zxf spandsp-0.0.2pre4.tar.gz [root@pbx src]# cd spandsp-0.0.2 [root@pbx spandsp-0.0.2]#./configure && make && make install Copy the following files (from opencall.org) to /usr/src/asterisk/apps and patch Asterisk, i.e.: [root@pbx spandsp-0.0.2]# cd /usr/src/asterisk/apps [root@pbx apps]# wget ftp://ftp.opencall.org/pub/spandsp/spandsp- 0.0.2pre4/app_rxfax.c [root@pbx apps]# wget ftp://ftp.opencall.org/pub/spandsp/spandsp- 0.0.2pre4/app_txfax.c [root@pbx apps]# wget ftp://ftp.opencall.org/pub/spandsp/spandsp- 0.0.2pre4/apps_makefile.patch [root@pbx apps]# patch < apps_makefile.patch patching file Makefile 8. Create a group and non root user [root@pbx apps]# groupadd asterisk [root@pbx apps]# useradd -c "asterisk PBX" -d /var/lib/asterisk -u 5060 -g asterisk asterisk

9. Building/Compiling Asterisk to run as our non root user Edit /usr/src/asterisk/makefile such that (~ line 122): ASTVARRUNDIR=$(INSTALL_PREFIX)/var/run/asterisk i.e.: [root@pbx asterisk]# vi Makefile Once in vi, you can do <Esc> followed by :set number (no quotes) that will show you the line numbers. You can Ctrl f to page down, or just use the down arrow key to scroll down to ~ line 122. When the appropriate line is located you can Shift a to add your text (i.e. /asterisk) to the end of the line. To save do <Esc> followed by Shift zz. Once the Makefile has been edited we can build Asterisk: [root@pbx asterisk]# make clean && make && make install 10.Setting up MySQL for CDR (Call Detail Reports) [root@pbx asterisk]# /usr/bin/mysql_install_db [root@pbx asterisk]# service mysqld start Starting MySQL: [ OK ] [root@pbx asterisk]# mysqladmin -u root password 'passw0rd' [root@pbx asterisk]# mysqladmin create asteriskcdrdb -p Enter password: (password is what you entered above, i.e.: passw0rd) [root@pbx asterisk]# mysql --user root -p mysql> GRANT ALL PRIVILEGES -> ON asteriskcdrdb.* -> TO asteriskuser@localhost -> IDENTIFIED BY 'amp109'; Query OK, 0 rows affected (0.00 sec) mysql> \q Bye [root@pbx asterisk]# mysql --user=root --password=passw0rd asteriskcdrdb < / usr/src/amp/sql/cdr_mysql_table.sql

11.Build/Compile cdr_mysql module for Asterisk [root@pbx asterisk]# cd /usr/src/asterisk-addons/ [root@pbx asterisk-addons]# make clean && make && make install 12.Setup MySQL for AMP web interface [root@pbx asterisk-addons]# mysqladmin create asterisk -p Enter password: (password is passw0rd) [root@pbx asterisk-addons]# mysql --user root -p asterisk < / usr/src/amp/sql/newinstall.sql [root@pbx asterisk-addons]# mysql --user root -p asterisk Enter password: Reading table information for completion of table and column names You can turn off this feature to get a quicker startup with -A Welcome to the MySQL monitor. Commands end with ; or \g. Your MySQL connection id is 7 to server version: 3.23.58 Type 'help;' or '\h' for help. Type '\c' to clear the buffer. mysql> GRANT ALL PRIVILEGES -> ON asterisk.* -> TO asteriskuser@localhost -> IDENTIFIED BY 'amp109'; Query OK, 0 rows affected (0.00 sec) mysql> \q Bye 13.Apply the AMP/Asterisk configuration files WARNING! If you have an existing Asterisk installation, the script below will overwrite your Asterisk configuration files. Backup your /etc/asterisk directory before running. [root@pbx asterisk-addons]# cd /usr/src/amp/ [root@pbx AMP]#./apply_conf.sh Don't worry about this output at this time: Unable to connect to remote asterisk Notice: no sip accounts defined op_server.pl: no process killed

Asterisk isn't running, you haven't defined any SIP extensions and op_server.pl (Flash Operator Panel) wasn't running. 14.Prep AMP/Asterisk Configuration files [root@pbx AMP]# cd /etc/asterisk [root@pbx asterisk]# mv vm_email.inc.template vm_email.inc [root@pbx asterisk]# cp voicemail.conf.template voicemail.conf [root@pbx asterisk]# mv zapata.conf.template zapata.conf [root@pbx asterisk]# cd /var/www/html/admin/cdr/lib/ [root@pbx lib]# mv defines.php.template defines.php [root@pbx lib]# cd /var/www/html/panel/ [root@pbx panel]# mv op_server.cfg.template op_server.cfg [root@pbx panel]# cd /usr/src/amp/ [root@pbx AMP]#./chown_asterisk.sh 15.Edit Apache/PHP environment a. Change the web server URL (WEBROOT) in defines.php i.e.: [root@pbx AMP]# vi /var/www/html/admin/cdr/lib/defines.php Once edited the line should look like this (using grep to single out the line for display on the commandline): [root@pbx AMP]# grep WEBROOT /var/www/html/admin/cdr/lib/defines.php define ("WEBROOT", "http://192.168.1.3/admin/cdr/"); b. Change vm_email.inc to reflect the web server address i.e.: [root@pbx AMP]# vi /etc/asterisk/vm_email.inc Once edited the contents of the file will look like this (using cat to display the entire file): [root@pbx AMP]# cat /etc/asterisk/vm_email.inc

; Change the email body, variables: VM_NAME, VM_DUR, VM_MSGNUM, VM_MAILBOX, VM_CALLERID, VM_DATE emailbody=${vm_name},\n\nthere is a new voicemail in mailbox ${VM_MAILBOX}: \n\n\tfrom:\t${vm_callerid}\n\tlength:\t${vm_dur} seconds\n\tdate:\t$ {VM_DATE}\n\nDial *98 to access your voicemail by phone.\nvisit http://192.168.1.3/cgi-bin/vmail.cgi?box=${vm_mailbox} to manage your voicemail with a web browser.\n c. Change op_server.cfg (web_hostname) to reflect the web server address i.e.: [root@pbx AMP]# vi /var/www/html/panel/op_server.cfg [root@pbx AMP]# grep web_hostname /var/www/html/panel/op_server.cfg web_hostname=192.168.1.3 ; must be the same hostname or ip address used ;web_hostname=www.virtualwebserver.com d. Modify lines 28+ of retrieve_op_conf_from_mysql.pl to reflect the number of zap channels you have i.e.: [root@pbx AMP]# vi /var/www/html/admin/retrieve_op_conf_from_mysql.pl If you have 1 channel, you should remove [Zap/2], [Zap/3] and [Zap/4] by entering dd (no quotes) on the line you want removed. Once you have removed (or added) channels, type Shift zz in vi to save the file. e.g.: [root@pbx AMP]# grep Zap /var/www/html/admin/retrieve_op_conf_from_mysql.pl # Zap Channels = remove or add to this list as necessary $additional = "[Zap/1]\nPosition=1\nLabel=\"External 1\"\nExtension=- 1\nIcon=3\n"; e. Edit Apache/PHP to allow for large Music on Hold files i.e. vi +482 /etc/php.ini

Edit with vi as above such that the line looks like this (using grep again to single out the line to show you what it looks like after editing): [root@pbx AMP]# grep upload_max_filesize /etc/php.ini upload_max_filesize = 20M vi +14 /etc/httpd/conf.d/php.conf Edit with vi as above such that the line looks like this: [root@pbx AMP]# grep LimitRequestBody /etc/httpd/conf.d/php.conf LimitRequestBody 20000000 16.Configure zaptel module a. Edit /etc/zaptel.conf to reflect installed Digium telephony card(s). A significant portion of the default file is commented out and is not included in the output below. Only the parameters/values relevant to a X100P are included below: # kewlstart for X100P fxsks=1 # loadzone = us defaultzone = us Only the parameters/values relevant to a 1 FXO TDM400P configuration are included below (assumes port 3 on the card contains the FXO module): # kewlstart for 1 port TDM400P (fxo uses fxs signalling) fxsks=3 # loadzone = us defaultzone = us b. Run ztcfg v i.e.: [root@pbx etc]# ztcfg -v

Zaptel Configuration ====================== 1 channels configured. Notice: Configuration file is /etc/zaptel.conf line 150: Unable to open master device '/dev/zap/ctl' The line 150: warning above is the result of not loading the zaptel module yet. The module gets loaded at boot time (dealt with below) so don't worry about its presence here. Detailed information with regard to Asterisk's configuration files can be found here: http://voip info.org/wiki Asterisk+config+files 17.Configure zapata module Edit /etc/asterisk/zapata.conf to reflect installed Digium telephony card(s). Only the parameters/values relevant to a X100P configuration are included below: [channels] language=en ; ; X100P plugged into PSTN ; context=from-pstn signalling=fxs_ks faxdetect=incoming usecallerid=yes echocancel=yes echocancelwhenbridged=no ;echotraining=yes echotraining=800 group=0 channel=1 Only the parameters/values relevant to a 1 FXO TDM400P configuration are included below (assumes port 3 on the card contains the FXO module):

[channels] language=en ; ; Port #3 plugged into PSTN ; context=from-pstn signalling=fxs_ks faxdetect=incoming usecallerid=yes echocancel=yes callprogress=no busydetect=no echocancelwhenbridged=no echotraining=800 group=0 rxgain=5.5 channel=3 Detailed information with regard to Asterisk's configuration files can be found here: http://voip info.org/wiki Asterisk+config+files 18.Edit web server configuration file Edit (with vi) /etc/httpd/conf/httpd.conf so that: User asterisk Group asterisk and: #Password protect /var/www/html/admin <Directory /var/www/html/admin> AuthType Basic AuthName "Restricted Area" AuthUserFile /usr/local/apache/passwd/wwwpasswd Require user wwwadmin </Directory> To create the wwwpasswd file: [root@pbx asterisk]# mkdir /usr/local/apache [root@pbx asterisk]# mkdir /usr/local/apache/passwd [root@pbx asterisk]# htpasswd -c /usr/local/apache/passwd/wwwpasswd wwwadmin New password: Re-type new password: Adding password for user wwwadmin

19.asterisk user environment Edit (with vi) /var/lib/asterisk/.bash_profile to include /usr/sbin in the PATH and set the LD_LIBRARY_PATH environment variable. [root@pbx etc]# cat /var/lib/asterisk/.bash_profile #.bash_profile # Get the aliases and functions if [ -f ~/.bashrc ]; then. ~/.bashrc fi # User specific environment and startup programs PATH=$PATH:/usr/sbin:$HOME/bin export PATH export LD_LIBRARY_PATH=/usr/local/lib unset USERNAME This is done so that if the need arises to start safe_asterisk manually from the commandline that the environment variables will be set. For example, after asterisk is started at boot the need may arise to stop asterisk. Instead of having to reboot again you can manually run safe_asterisk: [root@pbx root]# su - asterisk [asterisk@pbx asterisk]$ env grep PATH LD_LIBRARY_PATH=/usr/local/lib PATH=/usr/kerberos/bin:/bin:/usr/bin:/usr/local/bin:/usr/bin/X11:/usr/X11R6/b in:/usr/sbin:/var/lib/asterisk/bin [asterisk@pbx asterisk]$ asterisk -rx "stop when convenient" [asterisk@pbx asterisk]$ safe_asterisk 20.Automatic start up The module/driver that you load at boot time depends upon whether you are using a X100P or a TDM400P. The wcfxo module should be loaded for the former and the wcfxs module should be loaded for the latter. (In recent Asterisk code the functionality provided by wcfxs module will be provided in wctdm. At the time of this writing the AMP/Asterisk build does indeed use wcfxs for the TDM400P telephony card.) Edit (with vi) /etc/rc.d/rc.local to include the following for the X100P:

[root@pbx etc]# cat /etc/rc.d/rc.local #!/bin/sh # # This script will be executed *after* all the other init scripts. # You can put your own initialization stuff in here if you don't # want to do the full Sys V style init stuff. touch /var/lock/subsys/local echo ADDING WCFXO /sbin/modprobe wcfxo echo STARTING ASTERISK su asterisk -c "export PATH=$PATH:/usr/sbin && export LD_LIBRARY_PATH=/usr/local/lib && /usr/sbin/safe_asterisk" /usr/sbin/asterisk -rx 'sip debug' sleep 7 echo STARTING op_server.pl cd /var/www/html/panel; su asterisk -c /var/www/html/panel/safe_opserver & Edit (with vi) /etc/rc.d/rc.local to include the following for the TDM400P: #!/bin/sh # # This script will be executed *after* all the other init scripts. # You can put your own initialization stuff in here if you don't # want to do the full Sys V style init stuff. touch /var/lock/subsys/local echo ADDING WCFXS /sbin/modprobe wcfxs echo STARTING ASTERISK su asterisk -c "export PATH=$PATH:/usr/sbin && export LD_LIBRARY_PATH=/usr/local/lib && /usr/sbin/safe_asterisk" sleep 7 usr/sbin/asterisk -rx 'sip debug' echo STARTING op_server.pl cd /var/www/html/panel; su asterisk -c /var/www/html/panel/safe_opserver & 21.Ensure services are starting at boot time and reboot In order to access and use AMP we will want both Apache (httpd) and MySQL (mysqld) to be started at boot. You can check to see if they are setup to start at boot by using chkconfig: [root@pbx root]# chkconfig --list grep httpd httpd 0:off 1:off 2:off 3:off 4:off 5:off 6:off [root@pbx root]# chkconfig --list grep mysqld mysqld 0:off 1:off 2:off 3:off 4:off 5:off 6:off Here we see that both httpd and mysqld have off across the board (runlevels). chkconfig can be used to turn on a particular service but in order to avoid a discussion about runlevels we will use WBEL's setup program for this purpose:

[root@pbx root]# setup Down arrow to System Services, then hit Tab and <Enter> on Run Tool. Then downarrow until you reach httpd and press the space bar to select this service to be automatically started at boot time. Down arrow until you reach mysqld and press the space bar to select this service to be automatically started at boot time as well. Then Tab and hit <Enter> on Ok. Then hit Tab and <Enter> on Quit to leave the setup program. (If you run the chkconfig commands above again you will see that the service is now turned on under runlevel 3.) 22.Reboot and access the AMP administration interface [root@pbx root]# reboot Access AMP with your web browser:

The first time you click on the Asterisk Management Portal link you will be prompted for a username and password: From here you can setup Extensions, Call Groups, create IVRs (Digital Receptionist), upload custom On Hold Music and view Call Detail Reports. Please send comments/feedback on this manual to info@coalescentsystems.ca. If you found this documentation helpful please consider making a donation to the AMP (amportal) project: http://sourceforge.net/project/project_donations.php?group_id=121515 END