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.
