content/docs/UpgradePreviousVersions/UpgradeFrom2.2.1to2.2.2.mdtext

Title: Upgrade From 2.2.1 to 2.2.2
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.2.1 to VCL 2.2.2. Please 
note it only applies for the upgrade from 2.2.1 to 2.2.2, this may or may not work for 
other versions.


**The basic steps that will be performed**

  - Download and Extract 2.2.2 code 
  - Shutdown httpd service
  - Create backup of vcl database 
  - Create backup of web code
  - Upgrade web code
  - Restart httpd service

# Detailed steps for upgrade from 2.2.1 to 2.2.2

1. follow instructions on the [VCL download](http://vcl.apache.org/downloads/download.cgi) 
page to download and verify apache-VCL-2.2.2.tar.bz2 and put in in /root
1. **extract VCL 2.2.2 code**
    
        :::BashLexer
        tar xjf apache-VCL-2.2.2.tar.bz2

1. **Shutdown** the httpd service
           
        :::BashLexer
        service httpd stop or /etc/init.d/httpd stop

1. We will **create a backup of the vcl database**. This will provide a restore point 
if necessary. There are no updates to the database in this upgrade, but it is still a
good idea to have a backup.

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

1. **Backup the web code**. This step will move the 2.2.1 web directory out of the 
way so we can copy in the new web code base. 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.2.1_web

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

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

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

1. **Restart httpd service**

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

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

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