Differences

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

--- installation:upgrade [2014/01/29 19:20]
Timbow [Upgrade 3.x to 3.3.x]
+++ 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 ======
-===== Upgrade 3.x to 3.3.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.
+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''.
+Check the release notes for the new version-- it should indicate whether you need to replace those files with the new ones. If so, compare your old copies with the new ones. Compare paths, salts, rewrite base etc. Apply your custom configs the new files if necessary.
+===== Upgrade 3.x to 3.x.x =====
 **[[how_to:backup_website|Backup your Site First!]]**
-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 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.
+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.
 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'' .
-**New with 3.3.0** - You must visit yoursite.com/admin to complete the upgrade. Your front end will be temporarily closed and the site inaccessible until the upgrade is completed.
+After uploading open yoursite.com/admin to complete the upgrade.
-===== Upgrade 2.x to 3.x =====
+====Important====
+**New with 3.3.0** - You **must** visit yoursite.com/admin to complete the upgrade. Your front end will be temporarily closed and the site inaccessible until the upgrade is completed.
-  - Take a [[how_to:backup_website|backup of your site]] first
+**New with 3.3.9** - The htmleditor included with GS, CKEDITOR has been bumped from 3.x to 4.5.7, this is a major upgrade for ckeditor and any custom configurations settings, themes, and plugins you are using may not be compatible. it 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.
-  - On your server, copy or delete the folder: ''/admin/''. Sometimes the easiest thing to do is to copy ''/admin/'' to ''/admin-old/''.
-    * **HINT:** If you have a language file other than en_US.php, make sure you save off a copy from within ''/admin/lang/''
-  - 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 ====
+If you need assistance please see forums. eg. http://get-simple.info/forums/showthread.php?tid=8361
-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:
+===== Upgrade 2.x to 3.x =====
-=== Option #1 ===
-  - Create a new installation of GetSimple on your server with the download of 3.0
-  - Complete the installation so you now have a 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''
-=== Option #2 ===
-  - Delete/Copy off **website.xml**, **user.xml** and **cpsettings.xml** from your server's ''/data/other/'' folder.
+Instructions for [[Upgrading from GetSimple V2.x]] have been moved.
-    * You will need to remember the settings within these files so when you go thru the installation again, you can put back the settings.
-  - 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)
-    * We are effectly tricking the install to think that this is a brand new installation, and it will re-create these files upon install.
-  - Try to login. It should redirect you to a brand new install page. A new installation will never touch existing page files.
-  - 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]].
 ======Links======

GetSimple CMS Wiki

User Tools

Site Tools

Differences

Page Tools