Documentation

Features

Differences

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

installation:upgrading 2009/01/20 09:38 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 =====
-    * [[http://www.68classifieds.com/blog/database-backup-with-phpmyadmin/|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.
Line 13: Line 16:
===== 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.
-Now upload all the new files and folders. This could take a little while but be sure all the old files are overwritten with the new ones.+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. 
 + 
 +***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: 
 +- 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.
===== Run the upgrade ===== ===== Run the upgrade =====
<nowiki> <nowiki>
-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.</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.
Line 25: Line 51:
<note important> <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> **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>
 +
 +<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.