Location : Web Hosting - Web Hosting Knowledge Base - PostNuke CMS Tutorial

PostNuke upgrade Tutorial

Upgrading postnuke is very much similar to a new postnuke installation, below are detail steps for the upgrade process.

Preparing for upgrade

Before upgrade, there are a couple of things that you should do to ensure a smooth upgrade process, do not rush to the upgrade process, as the upgrade process make a lot of modification to your mysql database as well as the core PostNuke program, and you can loose your entire website if you have not done it properly.

Backup before upgrade

First of most important of all, backup mysql database of the postnuke website you are going to upgrade, also backup the entire postnuke program folder as well, this backup is going to regain a previously working condition postnuke website should anything go wrong in the upgrade.

Check extensions compatibility with new PostNuke version

If you have install any plugins, addons, extensions to your PostNuke website, be sure to check their status at the official PostNuke website and community forum to ensure there is no compatibility issues with the new PostNuke version, if there are issues with any of the plugins you should reconsider scheduling the upgrade to a later date till there is a compatible version of the extension ready. If there is no issues with the extensions, download the latest stable copy of all these extensions in your computer, extract and prepare them like you did during installation. We will need to reinstall these extensions after the PostNuke core program upgrade.

Starting the upgrade

After getting your backup done, checking and preparing all your extensions, you can proceed on to the upgrade process :-

  1. visit the PostNuke official website and download the latest stable release
  2. FTP to your hosting account and rename the current PostNuke program folder to another name
  3. Uncompress the file and upload it to your hosting account, place it in the same folder name as your PostNuke program folder (the folder name you just renamed), this means that your PostNuke website is now using this newly uploaded program file instead of the old copy
  4. copy the config.php and config-old.php from the renamed folder into this current PostNuke folder (so that the upgrade know what database to connect etc.)
  5. set the file permission for both config.php and config-old.php (newly copied) file to CHMOD 666 (so that the upgrade process can write to them)
  6. Open up your browser and enter the URL to the install.php file in your PostNuke program folder (i.e. http://www.yourdomain.com/postnuke_path/install.php), hit enter to begin the upgrade process
  7. Follow the instruction on screen and when it prompted for either a new install or an upgrade, select upgrade (NOTE: select new install will remove your database and content in it will be erased, be careful)
  8. Pick the PostNuke version you are upgrading from (important: different version introduce different modification to the database, be sure to select the exact version you are upgrading from)
  9. Upgrade process does some backend updating, check and see if there is error shown on screen
  10. if there is no error, that means you have successfully upgraded the PostNuke core program
  11. set the file permission for config.php and config-old.php back to CHMOD 644 and remove the install folder and install.php like you do in an installation
  12. follow the install postnuke module tutorial to install all your extensions back to the new PostNuke