Documentation

Features

Differences

This shows you the differences between the selected revision and the current version of the page.

installation:upgrading 2008/08/23 18:13 installation:upgrading 2011/02/24 15:34 current
Line 1: Line 1:
 +==== Please read this entire page and understand the steps before you begin. ====
 +
 +
====== Upgrading ====== ====== Upgrading ======
From time to time it will be necessary to upgrade your 68 Classifieds installation to the latest version, either to gain new features or to fix newly discovered bugs. From time to time it will be necessary to upgrade your 68 Classifieds installation to the latest version, either to gain new features or to fix newly discovered bugs.
===== Make a Backup ===== ===== Make a Backup =====
-    * Backup your database and all your tables. (Please make sure the backup will actually run in case problems arise.) +    * [[http://www.68classifieds.com/blog/database-backup-with-phpmyadmin/|Backup your database]] and all your tables. 
-    * Backup your connections/classifieds.php file and all your templates.+    * Backup your connections/classifieds.php file and any template files you have changed.
    * Backup any modules or changes you have made.     * Backup any modules or changes you have made.
===== Download your new files ===== ===== Download your new files =====
-You will need to login to 68 Classifieds member section to download the latest release. Once you are logged and are at the download page you should see two different versions. One labeled install and one labeled upgrade.+You will need to login to [[http://www.68classifieds.com/customers|68 Classifieds customer section]] to download the latest release.
===== Upload your new files ===== ===== Upload your new files =====
-You will need to open your FTP program and connect to your server where you have 68 Classifieds installed.+  - Open your FTP program and connect to your server
 +  - In the server pane of your FTP program, navigate to where you have 68 Classifieds installed.  
 +  - In the local pane of your FTP program, navigate to the contents of the 'upload' folder.  
 +  - Upload all of the folders and files contained in the 'upload' folder overwriting what's there.  
 + 
 +You do not have to upload the following folders: 
 +  * cache  
 +  * catimages 
 +  * Connections 
 +  * ioncube 
 +  * license 
 +  * modules 
 +  * photos 
 +  * templates (See note below) 
 +  * thumbs 
 +  * uploads 
 + 
 +Why can we skip uploading some folders? 
 + 
 +The reason you can skip most of the folders above is that they are empty. You may skip the ioncube folder because if your current installation is working properly, there's no reason to replace the loaders that are there now.
-Now upload all the new files from the Zip you downloaded. This could take a little while but be sure all the old files are overwritten with the new ones+***templates** folder: Read the list of changes in the changelog.txt file that is included in the download. If no changes have been made to the template files from the version you're currently using through the present version, uploading the templates directory is not necessary. If you do need to upload the template directory, we recommend that you rename the template directory you're using if: 
-Step 4. Run the upgrade+- you're using the '3col', 'deepsea', 'default' or 'purple' templates  
 +AND 
 +- you've made custom changes to that template 
 +By renaming the folder, you're preserving the changes you have made. You will need to reapply your styling changes to the newly uploaded files OR apply the code changes to the older template files you were using after completing the upgrade.
-After all the new files have been uploaded visit (http://www.yoursite.com/setup/ for v4.x.x) or (http://www.yoursite.com/install/ for v3.1.x) and follow the upgrade steps. It will ask you what version you are upgrading from that way the correct database changes are made.+===== Run the upgrade ===== 
 +<nowiki> 
 +After all the new files have been uploaded, visit (http://www.yoursite.com/setup/ for v4.x.x) and follow the upgrade steps. It will ask you what version you are upgrading from that way the correct database changes are made.</nowiki>
-The final step after upgrading will be to COMPLETELY DELETE THE ENTIRE 'SETUP' DIRECTORY. If this is not done, your site will not work correctly.+The final step after upgrading will be to **COMPLETELY DELETE THE ENTIRE 'SETUP' DIRECTORY**. If this is not done, your site will not work correctly.
-===== Notes: =====+<note important> 
 +**Please Note** - Our upgrade script will upgrade your site from your current version to the latest. You do not need to go through each individual version.</note>
-Our upgrade script will upgrade your site from your current version to the latest. You do not need to go through each individual version.+<note important> 
 +**PLEASE** - MAKE SURE THAT YOU FOLLOW THE **UPGRADE** STEPS WHEN UPGRADING! Following the 'Installation' steps will overwrite your database!</note>

Have more questions? Visit our community forums.