HOWTO:Upgrade to a newer version of e107 0.7xx

From e107 Wiki

This page is a stub. You can help e107 by expanding it.

This page describes how to upgrade from one version of 0.7xx to a later version.

Note: If you have been using CVS versions, there is a possibility that upgrading to a released version will not complete quite as expected. In these circumstances some manual intervention may be necessary - updating databases, making sure preferences are set and so on.

1 Preparation
2 Update
3 Verify
4 Configure
5 Finalise

[edit]

Preparation

Download the most appropriate upgrade package, and unzip it on your PC.
If you have modified any core files, make sure you have copies separate from your site. Compare against the updated core files; it may be necessary to update your modified files as well.
Do a database 'integrity check' and fix any errors.
Back up your database via phpMyAdmin (described in this how to) and any other relevant files.
Look at any 'readme' file which is included in the upgrade package
Make sure that you have copies of everything needed to restore your site if everything should go wrong - usually that will ensure its not needed!
If you are using any non-core plugins, check that they will run with the new version (or if you have concerns, uninstall them and back up any related database tables separately before upgrading)

[edit]

Update

Place your site into maintenance mode - by activating the site's maintenance flag
Copy all the modified files onto the existing installation. (Make sure your FTP client is set to 'overwrite always' rather than 'overwrite if newer' to avoid problems). Make sure you don't overwrite e107_config.php.
If your site uses a language other than English, also copy across updated language files.

[edit]

Verify

Log on as main admin.
Check that the new version is correctly shown on the main admin screen.
Run File Inspector - confirm that all files verify (other than any you have changed)
Run the Database 'Check for Updates' option - carry out any updates required (there may not be any)
Select plugin Manager - carry out any plugin upgrades which are required.
Go to Admin-->Database and run the Database 'integrity check' - correct any errors
Go to Admin-->Database and run the Plugin Scanner. This will update certain things to work with the newest plugin features, and generally clean up.
If your site uses a language other than English, go to Admin-->Database, and run the language file checker.

[edit]

Configure

Check out any new feature in the admin menu in detail
Run through all admin configuration menus - make sure any new options are properly set
Run through all plugins (especially those which required upgrade) to make sure all options are as you wish.

[edit]