svn commit: r1419534 - /vcl/branches/vcl-2.3-bugfixes/UPGRADE

[fa...@apache.org]

Author: fapeeler
Date: Mon Dec 10 15:47:27 2012
New Revision: 1419534

URL: http://svn.apache.org/viewvc?rev=1419534&view=rev
Log:
2.3.1 UPGRADE guide

Modified:
    vcl/branches/vcl-2.3-bugfixes/UPGRADE

Modified: vcl/branches/vcl-2.3-bugfixes/UPGRADE
URL: http://svn.apache.org/viewvc/vcl/branches/vcl-2.3-bugfixes/UPGRADE?rev=1419534&r1=1419533&r2=1419534&view=diff
==============================================================================
--- vcl/branches/vcl-2.3-bugfixes/UPGRADE (original)
+++ vcl/branches/vcl-2.3-bugfixes/UPGRADE Mon Dec 10 15:47:27 2012
@@ -1,6 +1,6 @@
 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-2.3
+to Apache VCL 2.3.1. It assumed that you extracted the release archive
+to /root/apache-VCL-2.3.1
 
 The basic steps that will be performed:
 
@@ -24,16 +24,16 @@ 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.3-upgrade.sql
+   mysqldump vcl > ~/vcl-pre2.3.1-upgrade.sql
 
 3. Update mysql schema
 
 This step updates the mysql schema.
 
-   cd /root/apache-VCL-2.3
+   cd /root/apache-VCL-2.3.1
    mysql vcl < mysql/update-vcl.sql
 
-One item of note: A new resource group is added in update-vcl.sql - 
+One item of note: In 2.3 a new resource group is added in update-vcl.sql - 
 "all profiles". Access to manage the group is added to the VCL->admin node
 in the privilege tree if that node exists. If not, you will need to add it
 manually after starting httpd again (step 6). To add it manually, pick a node
@@ -42,7 +42,7 @@ in the privilege tree, scroll to Resourc
 administer, manageGroup, and manageMapping, and click "Submit New Resource
 Group".
 
-4. FOR UPGRADING from 2.1 and 2.2 ONLY (skip to step 5 if upgrading from 2.2.1) 
+4. FOR UPGRADING from 2.2 ONLY (skip to step 5 if upgrading from 2.2.1 or 2.3) 
 
 Grant CREATE TEMPORARY TABLES to mysql user
 
@@ -74,16 +74,16 @@ vcl web code at /var/www/html/vcl. If yo
    a. move your old code out of the way
 
       cd /var/www/html
-      mv vcl ~/vcl-pre2.3_web
+      mv vcl ~/vcl-pre2.3.1_web
 
    b. copy the new code in place
 
-      cd /root/apache-VCL-2.3
+      cd /root/apache-VCL-2.3.1
       cp -r web /var/www/html/vcl
 
    c. copy your config files from the previous version:
 
-      cd ~/vcl-pre2.3_web/.ht-inc
+      cd ~/vcl-pre2.3.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
@@ -193,19 +193,6 @@ vcl web code at /var/www/html/vcl. If yo
               }
            }
 
-      upgrading from 2.1:
-
-         If upgrading from 2.1, it is easier to start with a fresh copy of
-         conf-default.php from 2.3 and then apply your changes to it again.
-         If you are using LDAP authentication, you can copy all entries from
-         $authMech out of your 2.1 conf.php file into your 2.3 conf.php file.
-         However, note that you will need to add the following two additional
-         keys to each entry.  A description of these keys can be found in the
-         2.3 conf-default.php file.
-
-         "lookupuserbeforeauth" => 0,
-         "lookupuserfield" => '',
-
 6. Restart httpd service
 
    service httpd start
@@ -222,30 +209,14 @@ you've added.
 
       cd <your vcl MN code root path>
       ie. cd /usr/local/
-      cp -r vcl ~/vcl-pre2.3_managementnode
+      cp -r vcl ~/vcl-pre2.3.1_managementnode
 
-   b. Copy in the 2.3 code base to /usr/local, copying in should preserve any
+   b. Copy in the 2.3.1 code base to /usr/local, copying in should preserve any
       drivers or other files you've added.
 
-      /bin/cp -r /root/apache-VCL-2.3/managementnode/* /usr/local/vcl
-
-   c. (upgrading from 2.1 only) 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
+      /bin/cp -r /root/apache-VCL-2.3.1/managementnode/* /usr/local/vcl
 
-   d. Run install_perl_libs.pl to update the perl dependencies (this will take
+   c. Run install_perl_libs.pl to update the perl dependencies (this will take
       a few minutes.)
       
       /usr/local/vcl/bin/install_perl_libs.pl
@@ -255,3 +226,4 @@ you've added.
    service vcld start
 
    * Check the /var/log/vcld.log file to confirm vcld is working. 
+	* Run through a few VCL reservation requests to confirm is it working.