168 lines
7.0 KiB
Plaintext
168 lines
7.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. install new files:
|
|
perl ./install.pl
|
|
NOTES: If you have customized any scripts in the bin or agi folders,
|
|
then make sure you back them up before running the install.pl script.
|
|
This script will replace existing files in the astguiclient installation.
|
|
|
|
/etc/astguiclient.conf has new variables for new functionality including:
|
|
- new ADMIN_keepalive_ALL process settings
|
|
- FastAGI_log server settings
|
|
and comments are added to the astguiclient.conf file
|
|
|
|
2. upgrade the MySQL asterisk database:
|
|
mysql
|
|
use asterisk
|
|
\. /path/from/root/extras/upgrade_2.0.2.sql
|
|
quit
|
|
/usr/share/astguiclient/ADMIN_area_code_populate.pl
|
|
The Daylight Savings Time scheme for the USA and Canada has been
|
|
updated for the 2007 changes. Also, Brazil DST has been added.
|
|
Another addition on this topic is the addition of USA zipcode
|
|
GMT offset list that allows for more accurate timezone lookups.
|
|
|
|
3. The astguiclient web directory has been removed and the
|
|
astguiclient/admin.php functions have been merged into the
|
|
vicidial/admin.php page
|
|
|
|
4. 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.
|
|
|
|
5. 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, 1.2.13 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 docs/conf_examples/extensions.conf.sample])
|
|
|
|
6. 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
|
|
|
|
NOTE: the scripts to be kept alive are to be defined in the astguiclient.conf file
|
|
|
|
7. Experimental FastAGI replacement for call_log and VD_hangup AGI scripts:
|
|
FastAGI_log.pl - requires cpan module Net::Server to run
|
|
If you want to use it, read the comments at the top of the script
|
|
Look at the docs/conf_examples/extensions.conf.sample file for examples
|
|
of how to use this new feature in your dialplan
|
|
- cpan
|
|
- install Net::Server
|
|
|
|
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.
|
|
|
|
9. Added new campaign summary screen and reformatted the timeonVDADall report:
|
|
A summary screen with all of the call information for every active
|
|
campaign for the day. reformatted campaign Realtime report with new
|
|
colors and other display options.
|
|
|
|
10. Added new script to change the server_ip entries when a machine changes IPs
|
|
The ADMIN_update_server_ip.pl script can be used to update your server's
|
|
IP address within all vicidial database tables and config files from
|
|
this one script. This can even be run in the crontab if you are on
|
|
a DHCP service and need to modify your IP address often
|
|
|
|
11. Added new script to allow for dial-out-only(no agents on the server)
|
|
VICIDIAL servers as well as balance dialing where a server with
|
|
available trunk lines can dial lines for another server that does not
|
|
have enough lines to dial for it's dial_level. AST_VDauto_dial_FILL.pl
|
|
script is only for multi-server systems and is started from new
|
|
ADMIN_keepalive_ALL.pl script with option 7 in astguiclient.conf
|
|
|
|
12. Added the ability to restrict agent logins by user group to a specific set
|
|
of campaigns. This is definable in the USER GROUPS section of admin.php
|
|
|
|
|
|
|
|
|
|
########## 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.
|
|
|
|
|