User Tools

Site Tools


installation:upgrade

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
installation:upgrade [2013/03/27 11:42]
Timbow
installation:upgrade [2016/11/19 16:42] (current)
laptopacademy edited based on http://get-simple.info/forums/showthread.php?tid=8839&pid=58370#pid58370
Line 2: Line 2:
 ====== Upgrading to the Latest Version of GetSimple ====== ====== Upgrading to the Latest Version of GetSimple ======
  
-===== Upgrade 3.x to 3.2.x =====+Note: In all versions, you can usually retain your old copies of the files ''​gsconfig.php''​ and ''​.htaccess''​ (especially for minor upgrades, meaning a version number change of less than 1). That's handy if those files contain your custom configs
  
-**Backup your Site First!**+For major upgrades, their structure or content may be changed in the new version of GS, in which case you can't simply retain the old copies of ''​gsconfig.php''​ and ''​.htaccess''​. ​
  
-This is the normal upgrade procedure: Nothing needs to be uninstalled,​ there is no install program, you just download ​the new version ​then extract and ftp the new folders and files to your serveroverwriting the old ones. The simplest procedure is just to upload everything in the zip file to your site rootso that all the old files are overwritten.+Check the release notes for the new version-- it should indicate whether you need to replace those files with the new ones. If socompare your old copies with the new ones. Compare pathssalts, rewrite base etc. Apply your custom configs ​the new files if necessary. 
 +===== Upgrade 3.x to 3.x.x =====
  
-If you don't want to overwrite everything because for instance you have customised or edited ​your old files or themes then the minimum you need to upload is the folder ''/​admin/''​ and the file ''​index.php''​ .+**[[how_to:​backup_website|Backup ​your Site First!]]**
  
 +This is the normal upgrade procedure. Nothing needs to be uninstalled. [[http://​get-simple.info/​download/​|Download]] the new version then extract and ftp the new folders and files to your web server, overwriting the old ones. The simplest procedure is just to upload everything in the zip file to your site root, so that all the old files are overwritten.
  
-===== Upgrade 2.x to 3.x =====+If you don't want to overwrite everything because for instance you have customised or edited your old files or themes then the minimum you need to upload is the folder ''/​admin/''​ and the file ''​index.php'' ​.
  
-  - Take a [[how_to:​backup_website|backup of your site]] first +After uploading open yoursite.com/admin to complete the upgrade
-  - On your server, copy or delete the folder: ''/​admin/''​Sometimes the easiest thing to do is to copy ''​/admin/'' ​to ''/​admin-old/''​.  +====Important==== 
-    * **HINT:** If you have a language file other than en_US.php, make sure you save off a copy from within ''​/admin/​lang/''​ +**New with 3.3.0** - You **must** visit yoursite.com/​admin ​to complete ​the upgradeYour front end will be temporarily closed ​and the site inaccessible until the upgrade ​is completed.
-  - Upload ​the new ''/​admin/''​ folder from the [[http://​get-simple.info/​download/​|download]] you unzipped. +
-  - Update your root level ''​index.php''​ file from the one within the downloaded zip file +
-  - Fix the ''​.htaccess''​ file's rewrite rules to look like this: ''​RewriteRule /?​([A-Za-z0-9_-]+)/?​$ index.php?​id=$1 [QSA,​L]''​ The underscore "​_"​ is what's different here. +
-  - The first time you try and log in after uploading, ''​update.php'' ​will run and attempt to re-organize all the data XML files. This is required in order to support multi-user capabilities+
  
-==== Troubleshooting ==== +**New with 3.3.9** The htmleditor included ​with GS, CKEDITOR has been bumped from 3.x to 4.5.7, this is major upgrade for ckeditor and any custom configurations settings, themes, and plugins you are using may not be compatibleit is recommended you remove them then slowly add them back, or check ckeditors web site for updated versions of plugins and themes that are compatible with 4.x. Check your gsconfig.php ​for any GSEDITOROPTIONS definitions and adjust as necessary. If you are using a custom_config js script, ​you may also want to check it for plugins ​and update with the config.js included in the ckeditor. folder.
-If you encounter problems logging in or during ''​update.php'',​ you can try and take one of these two drastic steps to help reinstall your site: +
- +
-=== Option #1 === +
-  ​Create a new installation of GetSimple on your server ​with the download of 3.+
-  - Complete the installation so you now have blank 3.0 GetSimple ​site+
-  - Copy over the following files/​folders from your old site: +
-    * ''/​data/​pages''​ +
-    * ''/​data/​other''​ (for 3.1) +
-    * ''​gsconfig.php''​ +
-    * Any languages ​you might have installed in ''/​admin/​lang''​ +
-    * Any plugins ​you might have installed in ''/​plugins''​+
  
 +If you need assistance please see forums. eg. http://​get-simple.info/​forums/​showthread.php?​tid=8361
 +===== Upgrade 2.x to 3.x =====
  
-=== Option #2 ===+Instructions for [[Upgrading from GetSimple V2.x]] have been moved. ​
  
-  - Delete/Copy off **website.xml**,​ **user.xml** and **cpsettings.xml** from your server'​s ''/​data/​other/''​ folder. +======Links====== 
-    * You will need to remember the settings within these files so when you go thru the installation again, you can put back the settings. +Back to the GetSimple Wiki [[:​start|Contents Page]] 
-  - Make sure that setup.php and install.php are still located within your ''/​admin/''​ folder (they get deleted by the install if it thinks everything is already installed) +==Pages in this Section== 
-    We are effectly tricking the install to think that this is brand new installation,​ and it will re-create these files upon install. ​ +===Installation=== 
-  ​- Try to login. It should redirect you to a brand new install page. A new installation ​will never touch existing page files. +  ​*[[:​installation|Installation on Web Server or a Local Server]] 
-  ​- When you are logged in, remember ​to re-setup all your settings that were lost when you deleted ​the 3 files from step #1. Remember to go in and re-[[themes:installation|choose your theme]].+  *[[installation:​migrating|MigratingMoving ​and Uploading Complete Sites]] 
 +  ​*[[installation:​requirements|Server requirements and Apache Modules]] 
 +  ​*[[installation:​upgrade|Upgrading ​to the Latest Version of GetSimple]] 
 +  *[[installation:​specific-webhosters|Guidance for Specific Hosting Companies]]
  
  
installation/upgrade.1364384571.txt.gz · Last modified: 2013/04/19 14:56 (external edit)