Author: fapeeler
Date: Wed Apr 25 15:22:42 2012
New Revision: 1330341

URL: http://svn.apache.org/viewvc?rev=1330341&view=rev
Log:
VCL-576

upgrade edits for 2.3 release

Modified:
    incubator/vcl/trunk/UPGRADE

Modified: incubator/vcl/trunk/UPGRADE
URL: 
http://svn.apache.org/viewvc/incubator/vcl/trunk/UPGRADE?rev=1330341&r1=1330340&r2=1330341&view=diff
==============================================================================
--- incubator/vcl/trunk/UPGRADE (original)
+++ incubator/vcl/trunk/UPGRADE Wed Apr 25 15:22:42 2012
@@ -1,6 +1,6 @@
-This file explains how to upgrade an existing install of Apache VCL 2.1 or 2.2
-to Apache VCL 2.2.1. It assumed that you extracted the release archive
-to /root/apache-VCL-2.2.1-incubating
+This file explains how to upgrade an existing install of Apache VCL
+to Apache VCL 2.3. It assumed that you extracted the release archive
+to /root/apache-VCL-23-incubating
 
 The basic steps that will be performed:
 
@@ -24,16 +24,18 @@ The basic steps that will be performed:
 We will create a backup of the vcl database. This will provide a restore point
 if necessary.
 
-   mysqldump vcl > ~/vcl-pre2.2.1-upgrade.sql
+   mysqldump vcl > ~/vcl-pre2.3-upgrade.sql
 
 3. Update mysql schema
 
 This step updates the mysql schema.
 
-   cd /root/apache-VCL-2.2.1-incubating
+   cd /root/apache-VCL-2.3-incubating
    mysql vcl < mysql/update-vcl.sql
 
-4. Grant CREATE TEMPORARY TABLES to mysql user
+4. FOR UPGRADING from 2.1 ONLY (skip to step 5 if upgrading from 2.2.1) 
+
+Grant CREATE TEMPORARY TABLES to mysql user
 
 The web code now requires access to create temporary tables in mysql. You need
 to grant the user your web code uses to access mysql the "CREATE TEMPORARY
@@ -63,24 +65,24 @@ code at /var/www/html/vcl. If you instal
    a. copy your old code out of the way
 
       cd /var/www/html
-               mv vcl ~/vcl-pre2.2.1_web
+               mv vcl ~/vcl-pre2.3_web
 
        b. copy the new code in place
 
-          cd /root/apache-VCL-2.2.1-incubating
+          cd /root/apache-VCL-2.3-incubating
                cp -r web /var/www/html/vcl
 
        c. copy your config files from the previous version:
 
-          cd ~/vcl-pre2.2.1_web/.ht-inc
+          cd ~/vcl-pre2.3_web/.ht-inc
                cp conf.php secrets.php pubkey.pem keys.pem 
/var/www/html/vcl/.ht-inc
 
-       d. (2.1 -> 2.2.1 only) make /var/www/html/vcl/.ht-inc/maintenance 
writable by
+       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. (2.1 -> 2.2.1 only) add the following new entries to conf.php - You 
can copy
+       e. (upgrade from 2.1 only) 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
 
@@ -92,10 +94,17 @@ code at /var/www/html/vcl. If you instal
                * define("FILTERINGSELECTTHRESHOLD", 1000);
                * define("DEFAULTTHEME", 'default');
 
+       f. run copydojocss.sh 
+               cd to /var/www/html/vcl/themes directory
+               cd /var/www/html/vcl/themes 
+               ./copydojocss.sh default
+
 6. Restart httpd service
 
        service httpd start
 
+       * Confirm you can access the VCL portal before continuing.
+
 7. Update management node code
 
 This step will move the existing vcl code base out of the way, so we can 
cleanly
@@ -105,14 +114,14 @@ copy in the new management node code.
 
                cd <your vcl MN code root path>
                ie. cd /usr/local/
-               cp -r vcl ~/vcl-pre2.2.1_managementnode
+               cp -r vcl ~/vcl-pre2.3_managementnode
 
-       b. Copy in the 2.2.1 code base to /usr/local, copying in should 
preserve any
+       b. Copy in the 2.3 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.1-incubating/managementnode/* 
/usr/local/vcl
+               /bin/cp -r /root/apache-VCL-2.3-incubating/managementnode/* 
/usr/local/vcl
 
-       c. (2.1 -> 2.2.1 only) Make changes related to vcld.conf settings
+       c. (upgrading from 2.1 only) Make changes related to vcld.conf settings
 
           * Open VCL web interface
                * Go to Management Nodes
@@ -127,6 +136,12 @@ copy in the new management node code.
                  is used, options are dynamic DHCP, Manual DHCP, or static
                * End Node SSH Identity Key Files
 
+       d. Run install_perl_libs.pl to update the perl dependencies(This will 
take a few minutes.)
+               
+               /usr/local/vcl/bin/install_perl_libs.pl
+
 8. Restart vcld service
 
        service vcld start
+
+       * Check the /var/log/vcld.log file to confirm vcld is working. 


Reply via email to