How do I upgrade/update to the latest CMSimple_XH version?

Please post answers on the most frequently asked questions about CMSimple
meister50
Posts: 1
Joined: Sun Dec 08, 2013 2:56 pm

Re: How do I upgrade/update to the latest CMSimple_XH versio

Post by meister50 » Sun Dec 08, 2013 3:17 pm

cmb wrote:Hello Community,

a German translation is available: Wie kann ich auf das neuste CMSimple_XH upgraden/updaten?

Update: if you're already running a CMSimple_XH version with the same minor version number (e.g. 1.5.1 -> 1.5.3), the update is usually pretty easy (note that the upgrade to CMSimple_XH 1.5.4 is slightly less simple):
  1. make a backup of your website
  2. download the update package for this minor version, unzip it, and upload all files to your server
  3. check, if everything works as it should
Some update packages install newer versions of jQuery4CMSimple. These will overwrite the existing plugin config.php to cater for the new version numbers of the jQuery/jQueryUI files. If you have "autoload" enabled, you have to set that again after the update.

Upgrade: if you're running an older version, things are not as straight forward, particularly if you're running a version, that's not UTF-8 encoded (typically all versions before CMSimple_XH 1.2, as well as CMSimple "classic", CMSimple SE, CMSimple LE):
  1. install the new version in a test environment (on your local machine or in a subfolder of your webspace)
  2. copy the content/ folder, secondary language folders, the template(s), the plugins and all images and downloads from your old installation to the new one. If your old version didn't have pagedata.php files, delete these files from the new version.
  3. manually reconfigure Settings->CMS and Settings->Website and redo any modifications you've made under Settings->Language (to ease this step you can use the language and config defaults)
  4. if Settings->Language->Meta->Codepage is not equal to 'utf-8', make it so, install Utf8migrator_XH and use it to convert all files to UTF-8 (it's important to specify the current encoding of the files!).
  5. thoroughly check the site -- if you're lucky, and everything works as it should, you just can replace the old site with the new one (but anyway: keep a backup of the old site!)
Troubleshooting:
  • links to CMSimple pages don't work anymore: that's probably caused by non ASCII characters in the page heading, which are encoded differently for ANSI resp. UTF-8. How to keep the old links working, is described in the XH wiki.
  • A plugin doesn't work as it should: some plugins don't reliably work with UTF-8 encoding (e.g. Genizforum). It's probably best to replace those plugins with UTF-8 encoded alternatives. If this is not possible, try to contact the plugin's author for help, or ask here in the forum
Any comments and additions are welcome!

Christoph
Thanks. This is very helpful. Appreciate it!

Angie

roze
Posts: 270
Joined: Tue Jun 03, 2008 7:13 am
Location: NL
Contact:

Re: How do I upgrade/update to the latest CMSimple_XH versio

Post by roze » Thu Jan 29, 2015 9:59 pm

I have the version:

CMSimple_XH 1.5.3 Released: 2012-03-19

And I want to update to the latest version CMSimple_XH 1.6.5

Can I use this update: CMSimple_XH-1.6.5.zip 2015-01-26 2.5 MB
Rob Zeijen,

Valkenswaard (NL)

cmb
Posts: 14225
Joined: Tue Jun 21, 2011 11:04 am
Location: Bingen, RLP, DE
Contact:

Re: How do I upgrade/update to the latest CMSimple_XH versio

Post by cmb » Thu Jan 29, 2015 10:05 pm

roze wrote:CMSimple_XH 1.5.3 Released: 2012-03-19

And I want to update to the latest version CMSimple_XH 1.6.5

Can I use this update: CMSimple_XH-1.6.5.zip 2015-01-26 2.5 MB
Not in the sense that you can simply upload it over an existing installation. You have to do an upgrade (aka. migration) as described in http://cmsimpleforum.com/viewtopic.php?f=4&t=4868 (section "Upgrading from an earlier UTF-8 encoded CMSimple_XH version"). You can use -1.6.5.zip instead of the mentioned -1.6.zip.
Christoph M. Becker – Plugins for CMSimple_XH

roze
Posts: 270
Joined: Tue Jun 03, 2008 7:13 am
Location: NL
Contact:

Re: How do I upgrade/update to the latest CMSimple_XH versio

Post by roze » Thu Jan 29, 2015 10:15 pm

thanx
Rob Zeijen,

Valkenswaard (NL)

Post Reply