ViciDial/ViciDialSVN
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

several changes to SCRATCH_INSTALL.txt for the 2.0 code tree

Browse Source 
git-svn-id: svn://192.168.202.10@186 3d104415-ff17-0410-8863-d5cf3c621b8a
This commit is contained in:
mattf
2006-08-18 03:19:23 +00:00
parent e353654b06
commit 39230a2b50
1 changed files with 89 additions and 147 deletions
Download Patch File Download Diff File Expand all files Collapse all files
agc_2-X/trunk/docs/SCRATCH_INSTALL.txt
+89 -147
View File
@@ -1,4 +1,4 @@
Asterisk/astguiclient install from scratch. v.2.0.1 2006-08-XX Asterisk/astguiclient install from scratch. v.2.0.1 2006-09-XX
By the astGUIclient group astguiclient@eflo.net By the astGUIclient group astguiclient@eflo.net
**** IMPORTANT - In order for vicidial/astguiclient to function correctly please **** IMPORTANT - In order for vicidial/astguiclient to function correctly please
@@ -225,25 +225,59 @@ installation we are assuming that there are no other machines on our network to
help the Asterisk server, so it must have everything it needs installed locally. help the Asterisk server, so it must have everything it needs installed locally.
It's nice to have a non-root account to put applications and have things run on
when you don't want to use root. We use cron user account for this purpose.
SUBPHASE 3.0: MySQL requirements
You must at least have Mysql client installed on each VICIDIAL server, but you
only need one database server.
SUBPHASE 3.0: creating an underpriveledged user account MySQL is a fast database system that is very easy to integrate with any
application. You can either install the server on the local Asterisk system or
have one somewhere on your network. For our purposes, we are creating an Asterisk
installation that is self contained and needs no other local servers to operate,
so we will need to install mysql on this machine.
*REQUIRED and OPTIONAL* (only install MySQL server locally if you don't want to use an installation
on another machine, Mysql client is required on all VICIDIAL servers)
NOTE: a minimum of MySQL server 4.0.X is required
1. type "adduser cron" at the command prompt Go to http://www.mysql.com/ and download the mysql package
2. follow the prompts and assign a password that you will remember to the new - to install this directly on the command line type:
user. The home directory should be /home/cron/ for this new user. - cd /usr/local
- wget http://mirror.trouble-free.net/mysql_mirror/Downloads/MySQL-4.0/mysql-4.0.27.tar.gz
- gunzip mysql-4.0.27.tar.gz
- tar xvf mysql-4.0.27.tar
- cd mysql-4.0.27
- groupadd mysql
- useradd -g mysql mysql
- "./configure --prefix=/usr/local/mysql --enable-large-files --enable-shared=yes --with-readline"
**** If only MySQL client is needed for DBD::mysql then use this:
- "./configure --prefix=/usr/local/mysql --without-server --enable-shared=yes --with-readline"
- make
- make install
- scripts/mysql_install_db
- chown -R root /usr/local/mysql
- chown -R mysql /usr/local/mysql/var
- chgrp -R mysql /usr/local/mysql
- cp support-files/my-medium.cnf /etc/my.cnf
- /usr/local/mysql/bin/mysqld_safe --user=mysql &
- you are done
***** NOTE: if you will be using any of the DBI perl scripts: *****
Every machine that you will be using the newer BDI perl scripts on will need
to have the perl modules DBI and DBD::mysql installed on them. To do this
you will also need to at least have the MySQL client installed on the server
(see above) then you will need to go to 'cpan' and "install DBI" and
"install DBD::mysql". You may need to "force install DBD::mysql" if the DBD
tests fail on your first try, but that is OK since the tests are not needed
SUBPHASE 3.1: Installing Perl Modules SUBPHASE 3.1: Installing Perl Modules
NOTE - you can install ActiveState http://www.activestate.com perl for faster NOTE - you can install ActiveState http://www.activestate.com perl which may
executing code that uses less processor time, but it is not required. Here's improve performance, but it is not required. Here's the source for ActiveState
the source for ActiveState Perl 5.6: (it's free) Perl 5.8: (it's free)
http://downloads.activestate.com/ActivePerl/src/5.6/AP638_source.tgz http://downloads.activestate.com/ActivePerl/src/5.8/AP817_source.tgz
I hope to add the lengthy steps for installing it as your default perl on your I hope to add the lengthy steps for installing it as your default perl on your
server but I need some time and a free machine to do that. server but I need some time and a free machine to do that.
@@ -273,8 +307,7 @@ following modules first: (say YES if asked to install prerequisites)
- reload cpan - reload cpan
- then you can install other modules: - then you can install other modules:
- install DBI - install DBI
- force install DBD::mysql (must at least have mysqlclient installed) - force install DBD::mysql (must at least have mysqlclientlibs installed)
- install O/OY/OYAMA/Net-MySQL-0.08.tar.gz
- install Net::Telnet - install Net::Telnet
- install Time::HiRes - install Time::HiRes
- install OLE::Storage_Lite (needed for super list loader Excel) - install OLE::Storage_Lite (needed for super list loader Excel)
@@ -400,12 +433,12 @@ the time is the same on our client computers and our servers.
6. Go to http://www.ntp.org/ and download the ntpd package 6. Go to http://www.ntp.org/ and download the ntpd package
- to install this directly on the command line type: - to install this directly on the command line type:
- cd /usr/local - cd /usr/local
- wget http://www.eecis.udel.edu/~ntp/ntp_spool/ntp4/ntp-4.2/ntp-4.2.2.tar.gz - wget http://www.eecis.udel.edu/~ntp/ntp_spool/ntp4/ntp-4.2/ntp-4.2.2p3.tar.gz
If you get compilation errors here try 4.1.2: If you get compilation errors here try 4.1.2:
- wget http://www.eecis.udel.edu/~ntp/ntp_spool/ntp4/ntp-4.1.2.tar.gz - wget http://www.eecis.udel.edu/~ntp/ntp_spool/ntp4/ntp-4.1.2.tar.gz
- gunzip ntp-stable-4.2.0a-20060224.tar.gz - gunzip ntp-4.2.2p3.tar.gz
- tar xvf ntp-stable-4.2.0a-20060224.tar - tar xvf ntp-4.2.2p3.tar.gz
- cd ntp-4.2.0 - cd ntp-4.2.2p3
- ./configure - ./configure
- make - make
- make install - make install
@@ -416,37 +449,17 @@ the time is the same on our client computers and our servers.
- you are done - you are done
aftpd is a tftp server which is a file transfer method used by many VOIP phones
to get their firmware and/or configuration files. This is optional.
*OPTIONAL* (only if you want it for a VOIP phone you are going to use)
7. Go to ftp://ftp.mamalinux.com/pub/atftp and download the aftpd package
- to install this directly on the command line type:
- cd /usr/local
- ncftpget ftp://ftp.mamalinux.com/pub/atftp/atftp-0.7.tar.gz
- gunzip atftp-0.7.tar.gz
- tar xvf atftp-0.7.tar
- cd atftp-0.7
- ./configure
- make
- make install
- mkdir /usr/local/tftp # create the directory to put files in
- chmod 0777 /usr/local/tftp # set permissions for new directory
- "/usr/local/sbin/in.tftpd --verbose=6 --daemon --port=69 --user cron /usr/local/tftp" # command to start tftpd server
- you are done
iftop is a good console bandwidth visualization tool that shows you active iftop is a good console bandwidth visualization tool that shows you active
connections, where they are going to/from and how much of your precious bandwidth connections, where they are going to/from and how much of your precious bandwidth
they are using. *OPTIONAL* they are using. *OPTIONAL*
8. Go to http://www.ex-parrot.com/~pdw/iftop/ and download the package 7. Go to http://www.ex-parrot.com/~pdw/iftop/ and download the package
- to install this directly on the command line type: - to install this directly on the command line type:
- cd /usr/local - cd /usr/local
- wget http://www.tcpdump.org/release/libpcap-0.8.3.tar.gz - wget http://www.tcpdump.org/release/libpcap-0.9.4.tar.gz
- gunzip libpcap-0.8.3.tar.gz - gunzip libpcap-0.9.4.tar.gz
- tar xvf libpcap-0.8.3.tar - tar xvf libpcap-0.9.4.tar
- cd libpcap-0.8.3 - cd libpcap-0.9.4
- ./configure - ./configure
- make - make
- make install - make install
@@ -467,7 +480,7 @@ within PNG files simply by creating a config file and a data file. We use this
package along with the included PHP script to generate server performance graphs package along with the included PHP script to generate server performance graphs
that can be displayed real-time on a web page. *OPTIONAL* that can be displayed real-time on a web page. *OPTIONAL*
9. Go to http://ploticus.sourceforge.net/ and download the package 8. Go to http://ploticus.sourceforge.net/ and download the package
- to install this directly on the command line type: - to install this directly on the command line type:
NOTE: you may have to edit the Makefile to remove X11 if you don't have it NOTE: you may have to edit the Makefile to remove X11 if you don't have it
- cd /usr/local - cd /usr/local
@@ -483,76 +496,13 @@ that can be displayed real-time on a web page. *OPTIONAL*
need the 'pl' script to be linked or copied into your htdocs/vicidial/ploticus directory need the 'pl' script to be linked or copied into your htdocs/vicidial/ploticus directory
NOTE: you may need to edit the Makefile for ploticus if you do not have X11 NOTE: you may need to edit the Makefile for ploticus if you do not have X11
MySQL is a fast database system that is very easy to integrate with any
application. You can either install it on the local Asterisk system or have one
somewhere on your network. For our purposes, we are creating an Asterisk
installation that is self contained and needs no other local servers to operate,
so we will need to install mysql on this machine.
*OPTIONAL* (only install MySQL locally if you don't want to use an installation
on another machine)
NOTE: a minimum of MySQL 4.0.X is required
10. Go to http://www.mysql.com/ and download the mysql package
- to install this directly on the command line type:
- cd /usr/local
- wget http://mirror.trouble-free.net/mysql_mirror/Downloads/MySQL-4.0/mysql-4.0.27.tar.gz
- gunzip mysql-4.0.27.tar.gz
- tar xvf mysql-4.0.27.tar
- cd mysql-4.0.27
- groupadd mysql
- useradd -g mysql mysql
- "./configure --prefix=/usr/local/mysql --enable-large-files --enable-shared=yes --with-readline"
If only MySQL client is needed for DBD::mysql then use this:
- "./configure --prefix=/usr/local/mysql --without-server --enable-shared=yes --with-readline"
- make
- make install
- scripts/mysql_install_db
- chown -R root /usr/local/mysql
- chown -R mysql /usr/local/mysql/var
- chgrp -R mysql /usr/local/mysql
- cp support-files/my-medium.cnf /etc/my.cnf
- /usr/local/mysql/bin/mysqld_safe --user=mysql &
- you are done
***** NOTE: if you use MySQL version 4.0.X: *****
(http://mirror.trouble-free.net/mysql_mirror/Downloads/MySQL-4.0/mysql-4.0.27.tar.gz)
Then you need to make sure that you use the 0.08 version of the Net::MySQL
perl module. This can be found in the astguiclient release zip file in the
libs/Net folder(MySQL.pm). Here are instructions on how to replace the
0.09 version of MySQL.pm with the 0.08 version which is MySQL 4.0.X compatible:
- cpan
- install O/OY/OYAMA/Net-MySQL-0.08.tar.gz
or you can use the version included with the astguiclient release:
- locate -u
- locate MySQL.pm (replace the path below with the path you find)
- mv /usr/lib/perl5/site_perl/5.8.6/Net/MySQL.pm MySQL.pm-old
- cp /home/cron/astguiclient_1.1.12-3/libs/Net/MySQL.pm /usr/lib/perl5/site_perl/5.8.6/Net/MySQL.pm
If you do not do this, then you will see MySQL authentication errors on your
Asterisk server.
***** NOTE: if you use MySQL version 4.1.12 or greater: *****
(http://mirror.services.wisc.edu/mysql/Downloads/MySQL-4.1/mysql-4.1.18.tar.gz)
If you are using the 0.08 version of the Net::MySQL perl module with 4.1.X
Then you need to make sure that you use the SET PASSWORD ... OLD_PASSWORD to
allow the older client libraries to connect to the MySQL server, or you can
start your mysqld server with the "-old-passwords" option. If you do not do
this, then you will see MySQL authentication errors on your Asterisk server.
***** NOTE: if you will be using any of the DBI perl scripts: *****
Every machine that you will be using the newer BDI perl scripts on will need
to have the perl modules DBI and DBD::mysql installed on them. To do this
you will also need to at least have the MySQL client installed on the server
(see above) then you will need to go to 'cpan' and "install DBI" and
"install DBD::mysql". You may need to "force install DBD::mysql" if the DBD
tests fail on your first try, but that is OK since the tests are not needed
openssh is a remote login protocol server that is always a good idea to have openssh is a remote login protocol server that is always a good idea to have
updated on your system, so we're going to install a new version now. updated on your system, so we're going to install a new version now.
*OPTIONAL* (only updated as a precaution, not manditory) *OPTIONAL* (only updated as a precaution, not manditory)
[NOTE: newer zlib is needed before installing] [NOTE: newer zlib is needed before installing]
11. Go to http://www.openssh.org/ and download the linux source for openssh 9. Go to http://www.openssh.org/ and download the linux source for openssh
- to install this directly on the command line type: - to install this directly on the command line type:
- cd /usr/local - cd /usr/local
- wget http://www.zlib.net/zlib-1.2.3.tar.gz - wget http://www.zlib.net/zlib-1.2.3.tar.gz
@@ -563,7 +513,7 @@ updated on your system, so we're going to install a new version now.
- make - make
- make install - make install
- cd /usr/local - cd /usr/local
- wget http://gulus.usherbrooke.ca/pub/appl/ssh/OpenSSH/portable/openssh-4.3p2.tar.gz - wget http://mirror.mcs.anl.gov/openssh/portable/openssh-4.3p2.tar.gz
- gunzip openssh-4.3p2.tar.gz - gunzip openssh-4.3p2.tar.gz
- tar xvf openssh-4.3p2.tar - tar xvf openssh-4.3p2.tar
- cd openssh-4.3p2 - cd openssh-4.3p2
@@ -578,7 +528,7 @@ locally and have it work with apache, you need it installed on your machine
*OPTIONAL* (only install openssl if you want to use SSL secured web pages on *OPTIONAL* (only install openssl if you want to use SSL secured web pages on
your locally installed copy of Apache web server) your locally installed copy of Apache web server)
12. Go to http://www.openssl.org/ and download the linux source for openssl 10. Go to http://www.openssl.org/ and download the linux source for openssl
- to install this directly on the command line type: - to install this directly on the command line type:
- cd /usr/local - cd /usr/local
- wget http://www.openssl.org/source/openssl-0.9.8b.tar.gz - wget http://www.openssl.org/source/openssl-0.9.8b.tar.gz
@@ -597,22 +547,22 @@ functionalities we need to have Apache and PHP installed on this machine.
*OPTIONAL* (only install Apache and PHP locally if you don't want to use an *OPTIONAL* (only install Apache and PHP locally if you don't want to use an
installation on another machine) installation on another machine)
13. Go to http://www.apache.org/ and download the apache unix source 11. Go to http://www.apache.org/ and download the apache unix source
Go to http://www.php.net/ and download the php unix source code Go to http://www.php.net/ and download the php unix source code
- to install this directly on the command line type: - to install this directly on the command line type:
- cd /usr/local - cd /usr/local
- wget http://apache.secsup.org/dist/httpd/httpd-2.0.58.tar.gz - wget http://apache.secsup.org/dist/httpd/httpd-2.0.59.tar.gz
- gunzip httpd-2.0.58.tar.gz - gunzip httpd-2.0.59.tar.gz
- tar xvf httpd-2.0.58.tar - tar xvf httpd-2.0.59.tar
- wget http://us2.php.net/distributions/php-4.4.2.tar.gz - wget http://us2.php.net/distributions/php-4.4.4.tar.gz
NOTE: PHP 5.1.1 has also been tested with this release NOTE: PHP 5.1.1 has also been tested with this release
- gunzip php-4.4.2.tar.gz - gunzip php-4.4.4.tar.gz
- tar xvf php-4.4.2.tar - tar xvf php-4.4.4.tar
- cd httpd-2.0.58 - cd httpd-2.0.59
- ./configure --enable-so --with-apxs2 - ./configure --enable-so --with-apxs2
- make - make
- make install - make install
- cd ../php-4.4.2 - cd ../php-4.4.4
- ./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-mysql - ./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-mysql
- make - make
- make install - make install
@@ -635,7 +585,7 @@ the load of your web traffic across many servers. If you are running more than
another cheap web server to handle the extra load. another cheap web server to handle the extra load.
*OPTIONAL* *OPTIONAL*
14. Go to http://balance.sourceforge.net to download the most recent source version 12. Go to http://balance.sourceforge.net to download the most recent source version
- to install this directly on the command line type: - to install this directly on the command line type:
- cd /usr/local - cd /usr/local
- wget http://voxel.dl.sourceforge.net/sourceforge/balance/balance-3.34.tgz - wget http://voxel.dl.sourceforge.net/sourceforge/balance/balance-3.34.tgz
@@ -655,13 +605,13 @@ you want to use the latest development code of Asterisk you will need to have
this loaded on your system. this loaded on your system.
*OPTIONAL* *OPTIONAL*
15. Go to http://subversion.tigris.org to download the most recent source version 13. Go to http://subversion.tigris.org to download the most recent source version
- to install this directly on the command line type: - to install this directly on the command line type:
- cd /usr/local - cd /usr/local
- wget http://subversion.tigris.org/downloads/subversion-1.3.0.tar.gz - wget http://subversion.tigris.org/downloads/subversion-1.3.2.tar.gz
- gunzip subversion-1.3.0.tar.gz - gunzip subversion-1.3.2.tar.gz
- tar xvf subversion-1.3.0.tar - tar xvf subversion-1.3.2.tar
- cd subversion-1.3.0 - cd subversion-1.3.2
- ./configure --enable-ssl --with-neon - ./configure --enable-ssl --with-neon
- make - make
- make install - make install
@@ -671,13 +621,11 @@ this loaded on your system.
PHASE 4: INSTALLING ASTERISK PHASE 4: INSTALLING ASTERISK
OK, all the prep work is done, now it's time to start having fun with Asterisk. OK, all the prep work is done, now it's time to start having fun with Asterisk.
There are four basic ways to install Asterisk, an official release(at the time of There are two basic ways to install Asterisk, an official release(at the time of
this writing the official release is 1.2.10), the CVS_v1-0 branch(1.0 this writing the official release is 1.2.10) and the SVN_DEV version(development
with bug fixes not yet packaged and released) and the SVN_DEV version(development branch). We recommend using Asterisk 1.2.10. These instructions are how we get
branch). Because there are bugs that affect astGUIclient in releases 1.0.8 and our Asterisk system with it's T1 line installed with our 2 SIP VOIP devices and
1.0.9, we recommend using Asterisk 1.2.10 or 1.0.11.1. These instructions are how we one IAX2 softphone.
get our Asterisk system with it's T1 line installed with our 2 SIP VOIP devices
and one IAX2 softphone.
NOTE: If you want to use release 1.0.8 or 9 we would recommend either using the NOTE: If you want to use release 1.0.8 or 9 we would recommend either using the
CVS_v1-0_Stable branch where the issues are fixed, or patching your 1.0.8/1.0.9 code CVS_v1-0_Stable branch where the issues are fixed, or patching your 1.0.8/1.0.9 code
@@ -699,24 +647,10 @@ with the following patch:
- tar xvf zaptel-1.2.7.tar - tar xvf zaptel-1.2.7.tar
- gunzip libpri-1.2.3.tar.gz - gunzip libpri-1.2.3.tar.gz
- tar xvf libpri-1.2.3.tar - tar xvf libpri-1.2.3.tar
B. If you want latest 1.0 tree stable release: B. if you want latest SVN_DEV version (sometimes unstable) [1.3 tree]
- wget http://ftp.digium.com/pub/asterisk/old-releases/asterisk-1.0.11.1.tar.gz
- wget http://ftp.digium.com/pub/zaptel/releases/zaptel-1.0.10.tar.gz
- wget http://ftp.digium.com/pub/libpri/releases/libpri-1.0.9.tar.gz
- gunzip asterisk-1.0.11.1.tar.gz
- tar xvf asterisk-1.0.11.1.tar
- gunzip zaptel-1.0.10.tar.gz
- tar xvf zaptel-1.0.10.tar
- gunzip libpri-1.0.9.tar.gz
- tar xvf libpri-1.0.9.tar
C. if you want latest SVN_DEV version (sometimes unstable) [1.3 tree]
- svn checkout http://svn.digium.com/svn/asterisk/trunk asterisk - svn checkout http://svn.digium.com/svn/asterisk/trunk asterisk
- svn checkout http://svn.digium.com/svn/zaptel/trunk zaptel - svn checkout http://svn.digium.com/svn/zaptel/trunk zaptel
- svn checkout http://svn.digium.com/svn/libpri/trunk libpri - svn checkout http://svn.digium.com/svn/libpri/trunk libpri
D. if you want latest STABLE 1.2 tree version (stable)
- svn checkout http://svn.digium.com/svn/asterisk/branches/1.2 asterisk-1.2
- svn checkout http://svn.digium.com/svn/zaptel/branches/1.2 zaptel-1.2
- svn checkout http://svn.digium.com/svn/libpri/branches/1.2 libpri-1.2
- ALL -> - ALL ->
- (1.0 tree)if you want to allow for more than 100 voicemail messages in a - (1.0 tree)if you want to allow for more than 100 voicemail messages in a
mailbox(warning this will slightly increase memory usage when a call mailbox(warning this will slightly increase memory usage when a call
@@ -1417,9 +1351,11 @@ VICIDIAL components to the system. (NOTE: make sure you have added the user "cro
SUBPHASE 6.0: putting the files in place SUBPHASE 6.0: putting the files in place
There are two methods for downloading astGUIclient/VICIDIAL, a release and SVN
1. Go to http://astguiclient.sf.net/ and download the latest astguiclient 1. Go to http://astguiclient.sf.net/ and download the latest astguiclient
package(as of this writing it is 1.1.12) package(as of this writing it is 1.1.12)
- to install this directly on the command line type: - for 1.1 release:
- cd /home/cron - cd /home/cron
- mkdir astguiclient - mkdir astguiclient
- cd astguiclient - cd astguiclient
@@ -1435,6 +1371,12 @@ package(as of this writing it is 1.1.12)
$DB_database = 'asterisk'; $DB_database = 'asterisk';
$DB_user = 'cron'; $DB_user = 'cron';
$DB_pass = '1234'; $DB_pass = '1234';
- for SVN 2.0 trunk:
- mkdir /usr/src/astguiclient
- cd /usr/src/astguiclient
- svn checkout svn://205.201.151.21:43690/agc_2-X
- cd trunk
- perl install.pl
- there is one more file you need that's not included with the download - there is one more file you need that's not included with the download
package, it's the conf.gsm file(this is the half-hour music file that we use package, it's the conf.gsm file(this is the half-hour music file that we use
to put people on hold). I have a free classical music file that is available to put people on hold). I have a free classical music file that is available