Author: jfthomps Date: Fri Sep 17 18:17:41 2010 New Revision: 998233 URL: http://svn.apache.org/viewvc?rev=998233&view=rev Log: initial add
Added: incubator/vcl/trunk/UPGRADE Added: incubator/vcl/trunk/UPGRADE URL: http://svn.apache.org/viewvc/incubator/vcl/trunk/UPGRADE?rev=998233&view=auto ============================================================================== --- incubator/vcl/trunk/UPGRADE (added) +++ incubator/vcl/trunk/UPGRADE Fri Sep 17 18:17:41 2010 @@ -0,0 +1,112 @@ +This file explains how to upgrade an existing install of Apache VCL 2.1 +to Apache VCL 2.2. It assumed that you extracted the release archive +to /root/apache-VCL-2.2-incubating + +The basic steps that will be performed: + +1. Shutdown httpd and vcld services +2. Create backup of vcl database +3. Update mysql schema +4. Update Web code, create a backup, copy in new, make changes +5. Restart httpd service +6. Update Management node vcl code, create a backup, copy in new, make changes +7. Restart vcld service + + +1. Shutdown httpd and vcld services + + service httpd stop + service vcld stop + +2. Create a backup of vcl database + +We will create a backup of the vcl database. This will provide a restore point +if necessary. + + mysqldump vcl > ~/vcl-pre2.2-upgrade.sql + +3. Update mysql schema + +This step updates the mysql schema. + + cd /root/apache-VCL-2.2-incubating + mysql vcl < mysql/update-2.2.sql + +4. Update web code + +This step we will move the 2.1 web directory out of the way, so we can copy in +the new web code base. After copying in the new code, we will migrate your +configuration changes. These instructions assume that you installed the vcl +web code at /var/www/html/vcl. If you installed it elsewhere, replace +/var/www/html/vcl with your vcl web root. + + a. copy your old code out of the way + + cd /var/www/html + mv vcl ~/vcl_2.1_web + + b. copy the new code in place + + cd /root/apache-VCL-2.2-incubating + cp -r web /var/www/html/vcl + + c. copy your 2.1 config files + + cd ~/vcl_2.1_web/.ht-inc + cp conf.php secrets.php pubkey.pem keys.pem /var/www/html/vcl/.ht-inc + + d. make /var/www/html/vcl/.ht-inc/maintenance writable by the web server - if + httpd on your server is running as the user apache: + + chown apache /var/www/html/vcl/.ht-inc/maintenance + + e. add the following new entries to conf.php - You can copy them in from + .ht-inc/conf-default.php. Descriptions of each item can also be found + in conf-default.php + + * date_default_timezone_set('America/New_York'); + * $blockNotifyUsers = "adminu...@example.org"; + * define("SCHEDULER_ALLOCATE_RANDOM_COMPUTER", 0); + * define("DOCUMENTATIONURL", "https://cwiki.apache.org/VCLDOCS/"); + * define("USEFILTERINGSELECT", 1); + * define("FILTERINGSELECTTHRESHOLD", 1000); + * define("DEFAULTTHEME", 'default'); + +5. Restart httpd service + + service httpd start + +6. Update management node code + +This step will move the 2.1 vcl code base out of the way, so we can cleanly copy +in the new management node(MN) code. + + a. Copy 2.1 code base to a backup location + + cd <your vcl MN code root path> + ie. cd /usr/local/ + cp -r vcl ~/vcl_2.1_managementnode + + b. Copy in the 2.2 code base to /usr/local, copying in should preserve any + drivers or other files you've added. + + /bin/cp -r /root/apache-VCL-2.2-incubating/managementnode/* /usr/local/vcl + + c. Make changes related to vcld.conf settings + + * Open VCL web interface + * Go to Management Nodes + * Select Edit Management Node Information + * Select Edit. + * Set any relevant fields: + * SysAdmin Email Address(es) - comma delimited list of vcl admin email + addresses + * Address for Shadow Emails - a shared mail box, optional it receives + email of all notifications + * Public NIC configuration method - Defines what type of NIC configuration is + used, options are dynamic DHCP, Manual DHCP, or static + * End Node SSH Identity Key Files + +7. Restart vcld service + + service vcld start