Magento upgrade guide: Magento upgrade from 1.4.x / 1.3.x version to Magento 1.5.x / 1.6.x / 1.7.x | Magento Design and Magento Development

I have upgraded many website 1.3.x to 1.7x, if any one is intrested, contact me

This is the most comprehensive description of the Magento 1.3.x, 1.4.x, 1.5.x, 1.6.x and 1.7.x upgrade process. It contains step-by-step instructions and troubleshooting information.


Prepare for Magento upgrade (for 1.3.x / 1.4.x version only)


Lets imaging that you have old Magento 1.3.x / 1.4.x store and you need to upgrade it to latest Magento 1.6.x or 1.7.x version. First of all it is highly recommended to backup your live store files / database and disable Magento compiler cache.


Next you need to get SSH access from your hosting provider and connect to your server via SSH protocol (using Linux command shell or Putty program for Windows). After connection via SSH, go to your store folder and execute these commands:


1 – Change permissions on lib/pear folder to writable (recursively):


chmod -R 777 lib/PEAR


2 – Execute this command to prepare Magento for upgrade:


./pear mage-setup


Most likely you will see this result after command execution:


Channel “” is already initialized




Upgrade from Magento 1.3.x / Magento 1.4.x to Magento


This step is necessary even if you upgrade your Magento store to 1.6 or 1.7 versions.


3 – Execute Magento upgrade command:


./pear upgrade -f magento-core/Mage_All_Latest-stable


Output of the command will show you what core packages were upgraded:


upgrade ok: channel://
upgrade ok: channel://
upgrade ok: channel://
upgrade ok: channel://
upgrade ok: channel://


4 – When this part of the upgrade will be complete, enter these commands:


chmod 550 ./mage
./mage mage-setup .


You will see this result after command execution:


Successfully added:


It means that Magento connect 2.0 channel was added to the channels list successfully.


5 – Next, enter this command:


./mage sync


The result will be:


Successfully added: community/Mage_Locale_en_US-
Successfully added: community/Interface_Install_Default-
Successfully added: community/Phoenix_Moneybookers-1.2.3
Successfully added: community/Mage_Downloader-
Successfully added: community/Lib_Google_Checkout-


Upgrade to Magento is complete and now you can proceed with upgrade to Magento 1.6.x or 1.7.x version.




Upgrade from Magento 1.4.x / Magento 1.5.x to Magento 1.6.x or Magento 1.7.x


Now you can upgrade your store to version 1.6 or 1.7.


Before proceeding with this part of Magento upgrade, it is very important to see to what version Magento upgrade scripts will upgrade your store. Enter this command to check this:


./mage list-upgrades


If you will see this result:


Updates for community:
Mage_All_Latest: =>
Lib_Js_Mage: =>
Lib_Varien: =>


It means that your Magento will be upgraded to version If it is not what you need you can change upgrade channel to “beta” and upgrade your Magento to version RC1.


6 – Enter this command to change the upgrade channel to stable (remember, “stable” channel will upgrade your Magento to version):


./mage config-set preferred_state stable


After this the “./mage list-upgrades” command will show you this result:


Updates for community:
Mage_All_Latest: =>
Lib_Js_Mage: =>
Lib_Varien: =>
Lib_Phpseclib: =>
Mage_Core_Adminhtml: =>
Mage_Core_Modules: =>


7 – After channel selection you can upgrade your Magento to (or to Magento RC1) using this command:


./mage upgrade-all –force


You will see upgraded packages on your screen:


Package upgraded: community/Mage_Locale_en_US
Package upgraded: community/Lib_Mage
Package upgraded: community/Lib_ZF
Package upgraded: community/Lib_Js_Prototype
Package upgraded: community/Lib_ZF_Locale


Now the upgrade is complete and you can execute database upgrade visiting your Magento store in your browser, this process will take several minutes, so be patient. If everything was upgraded correctly, you will see upgraded store in your browser.


You can check version of your store in the footer of Magento administration panel.


Leave a Reply

XHTML: You can use these tags: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>