Title: Upgrade From 2.3 to 2.3.1
Notice:    Licensed to the Apache Software Foundation (ASF) under one
           or more contributor license agreements.  See the NOTICE file
           distributed with this work for additional information
           regarding copyright ownership.  The ASF licenses this file
           to you under the Apache License, Version 2.0 (the
           "License"); you may not use this file except in compliance
           with the License.  You may obtain a copy of the License at
           .
             http://www.apache.org/licenses/LICENSE-2.0
           .
           Unless required by applicable law or agreed to in writing,
           software distributed under the License is distributed on an
           "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
           KIND, either express or implied.  See the License for the
           specific language governing permissions and limitations
           under the License.

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

**The basic steps that will be performed**

  - Download and Extract 2.3.1 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 vcld service

# Detailed steps for upgrade from 2.3 to 2.3.1

1. follow instructions on VCL 2.3.1 Release page to download and verify apache-VCL-2.3.1.tar.bz2 and put in in /root
2. **extract VCL 2.3.1 code**
    
        :::BashLexer
        tar xjf apache-VCL-2.3.1.tar.bz2

3. **Shutdown** the httpd and vcld services
           
        :::BashLexer
        service httpd stop or /etc/init.d/httpd stop
        service vcld stop or /etc/init.d/vcld stop

4. We will **create a backup of the vcl database**. This will provide a restore point if necessary.

        :::BashLexer
        mysqldump vcl > ~/vcl-pre2.3.1-upgrade.sql

5. This step **updates the mysql schema**.

        :::BashLexer
        cd /root/apache-VCL-2.3.1
        mysql vcl < mysql/update-vcl.sql

6. **Update the web code**. This step we will move the 2.3 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.

        :::BashLexer
        cd /var/www/html
        mv vcl ~/vcl_2.3_web

7. **Copy the new code** in place
	
        :::BashLexer
        cd /root/apache-VCL-2.3.1
        cp -r web /var/www/html/vcl

8. **Copy your 2.3 config files**
	
        :::BashLexer
        cd ~/vcl_2.3_web/.ht-inc
        cp conf.php secrets.php pubkey.pem keys.pem /var/www/html/vcl/.ht-inc

9. **Make the maintenance directory writable by the web server user**. Normally this is the apache user,  if using 
a different user change below cmd accordingly.
	
        :::BashLexer
        chown apache /var/www/html/vcl/.ht-inc/maintenance

11. **Restart httpd service**

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

12. **Update management node code** This step will make a backup copy of the 2.3 vcl code base and then copy 
the new code over the existing code to preserve any drivers or other files you've added.
	
        :::BashLexer
        cd <your vcl MN code root path>
        ie. cd /usr/local/
        cp -r vcl ~/vcl_2.3_managementnode

13. **Copy in the 2.3.1 code base to /usr/local**, copying in should preserve any drivers or other files you've added.
	
        :::BashLexer
        /bin/cp -r /root/apache-VCL-2.3.1/managementnode/* /usr/local/vcl

14. **Run install_perl_libs.pl** to add any new perl library requirements:
	
        :::BashLexer
        /usr/local/vcl/bin/install_perl_libs.pl

15. **Restart vcld service**
	
        :::BashLexer
        service vcld start or /etc/init.d/vcld start

16. Make some test reservations and watch the vcld.log to verify everything is working correctly.

        :::BashLexer
        tail -f /var/log/vcld.log