Files
ViciDialSVN/agc_2-X/trunk/UPGRADE
T
mattf 281d70fadd update of the UPGRADE doc
add deletion of vicidial_hopper reserved records to AST_reset_mysql_vars script

git-svn-id: svn://192.168.202.10@357 3d104415-ff17-0410-8863-d5cf3c621b8a
2006-10-16 21:32:39 +00:00

131 lines
5.0 KiB
Plaintext

################ UPGRADE
NOTE: Upgrading from 1.1.12-3 to 2.0.1 is at the bottom
########## UPGRADING FROM 2.0.1 TO 2.0.2 ##########
1. upgrade the MySQL Asterisk database:
mysql
use asterisk
\. /path/from/root/extras/upgrade_2.0.2.sql
quit
2. The astguiclient web directory has been removed and the
astguiclient/admin.php functions have been merged into the
vicidial/admin.php page
3. You can now define trunks for use only by specific campaigns. See the help
in the vicidial/admin.php server modification page under the
VICIDIAL SERVER TRUNKS section.
4. Agents now have the ability to control volume levels for any call in their
meetme room directly from the vicidial.php page. This only works on
Asterisk 1.2.7.1, 1.2.12.1 or SVN_1.2 and the meetmeadmin_volume_control.patch
patch must be applied as described in the SCRATCH_INSTALL. Also, a few
lines must be added to the extensions.conf for this to work:
(_X48600XXX, _X38600XXX, 8300 [see extensions.conf.sample])
5. Multiple ADMIN_keepalive scripts have been replaced with a single script
ADMIN_keepalive_ALL.pl
Remove all other ADMIN keepalive entries in your crontab and replace
with this one:
### keepalive script for astguiclient processes
* * * * * /usr/share/astguiclient/ADMIN_keepalive_ALL.pl
6. /etc/astguiclient.conf has new variables for new functionality including:
- FastAGI_log server settings
- new ADMIN_keepalive_ALL process settings
and comments are added to the astguiclient.conf file
7. Experimental FastAGI replacement for call_log and VD_hangup AGI scripts:
FastAGI_log.pl
If you want to use it, read the comments at the top of the script
8. Fix for unregistered SIP trunks (thanks to Chris Doyle):
look at the bottom of the docs/conf_examples/extensions.conf.sample
file for examples of what to put in your extensions.conf file to get
VICIDIAL auto dialing to work with non-registered SIP trunks. remember
to put sip-silence.gsm in your /var/lib/asterisk/sounds/ directory.
########## UPGRADING FROM 1.1.12-3 TO 2.0.1 ##########
If you are upgrading to the 2.0 code tree from the 1.1.12-3 release there have
been several changes made to the code base and to where some files are stored in
the release as well as on your machine.
1. upgrade the MySQL Asterisk database:
mysql
use asterisk
\. /path/from/root/extras/upgrade_2.0.1.sql
quit
2. use the new installer for astguiclient-VICIDIAL files:
NOTE: this new script is interactive with prompts. this script will
create the new /etc/astguiclient.conf settings file that replaces the
old AST_SERVER_conf.pl file that has been removed. Also, this settings
file is used by dbconnect.php scripts so no need to manually edit them
perl install.pl
3. Make sure you have MySQL clientlibs installed:
Because all perl script now use DBI instead of Net::MySQL you need to make sure
that you have at least the MySQL client installed on all VICIDIAL servers even
if the MySQL server is installed on another machine. You can skip this step if
MySQL server is already on your VICIDIAL server:
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 --without-server --enable-shared=yes --with-readline"
- make
- make install
- you are done
4. New MySQL perl modules:
You will need to make sure that you have installed the following perl modules:
DBI (top-level Database interface module "install DBI")
DBD::mysql (MySQL-specific interface through DBI "force install DBD::mysql")
5. new predictive dialing crontab entry:
If you will be using the new predictive dialing functions you need to make sure
you have the keepalive for this function loaded in your crontab:
NOTE: this only needs to be on a single server if you are in a multiple
VICIDIAL server setup.
### keepalive script for VICIDIAL predictive script
* * * * * /usr/share/astguiclient/ADMIN_keepalive_AST_VDadapt.pl
6. all old crontab entries and /home/cron files
All of your old crontab entries need to be changed from /home/cron to
/usr/share/astguiclient if you choose the default installation path. You can
manually set the path to /home/cron if you like though since the home path is
now dynamic in all vicidial perl(.pl) scripts. If you do choose to use the new
default path, you can delete everything in the /home/cron directory if you like
7. old /etc/rc.d/rc.local entries
Be sure to change your /etc/rc.d/rc.local entries(the commands that are run at
system boot to start asterisk and other scripts like log rolling) and change the
/home/cron path to the new /usr/share/astguiclient path.
8. other notes:
- there is a new DIAL METHOD field and several other new dial-control fields
in campaign modification page, please take a minute to read the help
documentation for these new features.