This page is about upgrading from version 0.9.0.x to 0.9.1

The latest documentation for upgrading is included in your blog bundle, in the doc directory, for example doc/upgradefrom_b2evo.en-UK.html. The following documentation refers to that included with version 0.9.1, with some minor changes.

Upgrading from a previous version of b2evolution

Before you begin, please note that some network features of b2evolution require you to agree to our simple Terms of service. Also note that there will be some minor downtime to your blog by following these instructions:

1. Backup all your b2evolution files. The easiest way to do this is to rename the b2evolution directory on your server. However you do it, take special care of the files you may have modified, including /conf, skins, blog templates, stubfiles, etc…
2. You should also backup your database if you can. This functionality should be provided by your host.
3. Delete all your existing b2evolution files from your site before uploading the new ones! This will ensure you don’t keep unnecessary files on your server after upgrading. It’s also better for security.
4. Upload all new b2evolution files to your site. We cannot stress this enough: ALL FILES! And that means you can’t reuse your customized files, including /conf, skins, blog templates, stubfiles, etc. as they are! That means you will have to customize all these files again. We’re sorry but, due to the pace of development and adding of new features, we cannot guarantee that anything will work if you keep older files in place. However, since you have backed up all these files in step 1, you can try to partially reuse them once the upgrade process is done. See step 8 below.
5. Run the installation script on your server. It is located in http://yoursite.com/yourblogsfolder/install. Then, simply follow the on screen instructions. The installer will ask you basic configuration settings (unless you have already updated /conf/_config.php before uploading), then allow you to run a database upgrade from any b2evolution version to the new one.
6. Check to make sure the new installation works.
7. On production servers, it is recommended that you delete the /install subfolder. This prevents others overwriting your settings.
8. It’s now time to bring back your previous customizations. We recommend you get yourself a diff/merge tool like WinMerge. This will allow you to easily compare your old (backed-up) files with the new files (even whole directories at once) and report changes accordingly.
9. After basic install is done, there are a few tricky things you may need to take care of (online manual).