Upgrading GetSimple

This is the normal upgrade routine. if you are upgrading to a new major version, please see below.

1. Back up your site
2. Download the latest version
3. Unzip the contents to a new folder on your local computer.
4. Upload everything that was unzipped except for the “theme”, “backups” and “data” folders with an FTP client to your host where the original GetSimple installation is.

Note: If upgrading from 3.0 to 3.1, you may want to change some settings in your gsconfig.php file. Read more

Note: If you want to automatically pull down the latest svn beta, check out this script.

These are instructions on how to upgrade your 1.x installation of GetSimple to the new 2.0 release.

1. Take a backup of your site.
2. (Optional) To be extra safe, you can log into your site via FTP and copy all the files and folders for your GetSimple site. This includes the /admin/, /data/, /theme/, /backups/ folders and the .htaccess and index.php files.
3. Log into your site via FTP if you haven't done so yet and delete the whole /admin/ folder.
4. Upload the new 2.0 /admin/ folder and index.php file that you got with your new 2.0 download.
5. When this new folder is finished uploading, log back into your site and verify everything looks OK.
6. IMPORTANT: It is also imperative that you go to Support → Health Check to make sure that you've uploaded all necessary .htaccess files. Some folders in your installation have sensitive data and should not be accessible to outside visitors.

1. Take a backup of your site first
2. 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/
3. Upload the new /admin/ folder from the download you unzipped.
4. Update your root level index.php file from the one within the downloaded zip file
5. 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.
6. 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.

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:

1. Create a new installation of GetSimple on your server with the download of 3.0
2. Complete the installation so you now have a blank 3.0 GetSimple site.
3. 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

1. Delete/Copy off website.xml, user.xml and cpsettings.xml from your server's /data/other/ folder.
   • You will need to remember the settings within these files so when you go thru the installation again, you can put back the settings.
2. 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.
3. Try to login. It should redirect you to a brand new install page. A new installation will never touch existing page files.
4. 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-choose your theme.