Page History

This file page provides information on how to upgrade from VCL 2.2 to VCL 2.2.1. Please note it only applies for the upgrade from 2.2 to 2.2.1, this may or may not work for other versions.

...

• Download and Extract 2.2.1 code
• Shutdown httpd and vcld services
• Create backup of vcl database
• Update mysql schema
• Grant CREATE TEMPORARY TABLES to mysql user
• Update Web code, create a backup, copy in new, make changes
• Restart httpd service
• Update Management node vcl code, create a backup, copy in new, make changes
• Restart vcld service

...

cd /root/apache-VCL-2.2.1-incubating
mysql vcl < mysql/update-2.2.1.sqlvcl.sql

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 TABLES" permission. Look at the secrets.php file in your web code for the user and hostname. For example, if your web code is installed at /var/www/html/vcl, your secrets.php file would be /var/www/html/vcl/.ht-inc/secrets.php. Look for $vclhost and $vclusername. The secrets.php file might have something like:

$vclhost = 'localhost';
$vcluser = 'vcluser';

Then, you need to issue the grant command to mysql. Using the values from above as examples, connect to mysql and then issue the grant command:

mysql
GRANT CREATE TEMPORARY TABLES ON `vcl`.* TO 'vcluser'@'localhost';
exit

Update web code

This step we will move the 2.2 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.

1. copy your old code out of the way

   Code Block
   cd /var/www/html mv vcl ~/vcl_2.2_web

2. copy the new code in place

   Code Block
   cd /root/apache-VCL-2.2.1-incubating cp -r web /var/www/html/vcl

3. apply a patch to fix editing reservations

   Code Block
   cd /var/www/html/vcl/.ht-inc wget https://issues.apache.org/jira/secure/attachment/12477101/utils_virtual_undefined.patch patch < utils_virtual_undefined.patch

4. apply patch to fix processing of block allocations

   Code Block
   wget https://issues.apache.org/jira/secure/attachment/12485328/vmhostcheck_fix.patch patch < vmhostcheck_fix.patch

5. copy your 2.2 config files

   Code Block
   cd ~/vcl_2.2_web/.ht-inc cp conf.php secrets.php pubkey.pem keys.pem /var/www/html/vcl/.ht-inc

...