################ 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: - new ADMIN_keepalive_ALL process settings - FastAGI_log server 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 Look at the docs/conf_examples/extensions.conf.sample file for examples of how to use this new feature in your dialplan 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 ########## 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.