Page History

...

• Download and Extract 2.2 code
• Shutdown httpd and vcld services
• Create backup of vcl database
• Update mysql schema
• 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 httpd and vcld servicesservice

Download and Extract 2.2 code

1. follow instructions on VCL 2.2 (unreleased) Release page to download and verify apache-VCL-2.2-incubating.tar.bz2 and put in in /root
2. extract VCL 2.2 code

   Code Block
   tar xjf apache-VCL-2.2-incubating.tar.bz2

...

1. copy your old code out of the way

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

2. copy the new code in place

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

3. copy your 2.1 config files

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

4. make /var/www/html/vcl/.ht-inc/maintenance writable by the web server - if httpd on your server is running as the user apache:

   Code Block
   chown apache /var/www/html/vcl/.ht-inc/maintenance

5. 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 = "adminuser@example.org";
   • define("SCHEDULER_ALLOCATE_RANDOM_COMPUTER", 0);
   • define("DOCUMENTATIONURL", "https://cwiki.apache.org/VCLDOCS/");
   • define("USEFILTERINGSELECT", 1);
   • define("FILTERINGSELECTTHRESHOLD", 1000);
   • define("DEFAULTTHEME", 'default');

...

Restart httpd service

service httpd start or /etc/init.d/httpd start

...

1. Copy 2.1 code base to a backup location

   Code Block
   cd <your vcl MN code root path> ie. cd /usr/local/ cp -r vcl ~/vcl_2.1_managementnode

2. Copy in the 2.2 code base to /usr/local, copying in should preserve any drivers or other files you've added.

   Code Block
   /bin/cp -r /root/apache-VCL-2.2-incubating/managementnode/* /usr/local/vcl

3. Make changes related to vcld.conf settings
   1. Open VCL web interface
   2. Go to Management Nodes
   3. Select Edit Management Node Information
   4. Select Edit.
   5. Set any relevant fields:
   6. SysAdmin Email Address(es) - comma delimited list of vcl admin email addresses
   7. Address for Shadow Emails - a shared mail box, optional it receives email of all notifications
   8. Public NIC configuration method - Defines what type of NIC configuration is used, options are dynamic DHCP, Manual DHCP, or static
   9. End Node SSH Identity Key Files

...

Restart vcld service

service vcld start or /etc/init.d/vcld start