Well we all know that the upgrade of the magento system must be the worsed job to be handed,
Well there is a way and it seems to work!!
This is the most comprehensive description of the Magento 1.4 (1.4.1.1), 1.5 (1.5.1.0), 1.6 (1.6.0.0) upgrade process. It contains step-by-step instructions and troubleshooting information. Hope this information will help you to upgrade your Magento store up to the latest version with no troubles.
Prepare for Magento upgrade
Lets imaging that you have Magento 1.4.1.1. web store and you need to upgrade it to 1.5. or 1.6 version. First of all it is highly recommended to backup your live store files and database.
Next you need to get SSH access from your hosting provider and connect to your server via SSH protocol. 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 “connect.magentocommerce.com/core” is already initialized
Upgrade from Magento 1.4.1.x to Magento 1.4.2.0
This step is necessary even if you upgrade your Magento store to 1.5 or 1.6 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://connect.magentocommerce.com/core/Mage_Centinel-1.4.2.0
upgrade ok: channel://connect.magentocommerce.com/core/Interface_Frontend_Base_Default-1.4.2.0
upgrade ok: channel://connect.magentocommerce.com/core/Phoenix_Moneybookers-1.2.3
upgrade ok: channel://connect.magentocommerce.com/core/Find_Feed-1.0.7
upgrade ok: channel://connect.magentocommerce.com/core/Interface_Adminhtml_Default-1.4.2.0
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: http://connect20.magentocommerce.com/community
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-1.4.2.0
Successfully added: community/Interface_Install_Default-1.4.2.0
Successfully added: community/Phoenix_Moneybookers-1.2.3
Successfully added: community/Mage_Downloader-1.5.0.0
Successfully added: community/Lib_Google_Checkout-1.4.2.0
Upgrade to Magento 1.4.2.0 is complete and now you can proceed with upgrade to Magento 1.5.1.0 or 1.6.0.0 version.
Upgrade from Magento 1.4.2.0 to Magento 1.5.10 or Magento 1.6.0.0
Now you can upgrade your store to version 1.5 or 1.6.
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: 1.4.2.1 => 1.6.0.0
Lib_Js_Mage: 1.4.2.0 => 1.6.0.0
Lib_Varien: 1.4.2.0 => 1.6.0.0
Lib_Phpseclib: 1.4.2.0 => 1.5.0.0
It means that your Magento will be upgraded to version 1.6.0.0. If it is not what you need you can change upgrade channel to “stable” and upgrade your Magento to version 1.5.1.0.
6 – Enter this command to change the upgrade channel to stable:
./mage config-set preferred_state stable
After this the “./mage list-upgrades” command will show you this result:
Updates for community:
Mage_All_Latest: 1.4.2.1 => 1.5.1.0.1
Lib_Js_Mage: 1.4.2.0 => 1.5.1.0
Lib_Varien: 1.4.2.0 => 1.5.1.0
Lib_Phpseclib: 1.4.2.0 => 1.5.0.0
Mage_Core_Adminhtml: 1.4.2.0 => 1.5.1.0
Mage_Core_Modules: 1.4.2.0 => 1.5.1.0
7 – After channel selection you can upgrade your Magento to 1.5.1.0 (or to Magento 1.6.0.0) using this command:
./mage upgrade-all –force
You will see upgraded packages on your screen:
…
Package upgraded: community/Mage_Locale_en_US 1.6.0.0
Package upgraded: community/Lib_Mage 1.6.0.0
Package upgraded: community/Lib_ZF 1.11.1.0
Package upgraded: community/Lib_Js_Prototype 1.7.0.0.1
Package upgraded: community/Lib_ZF_Locale 1.11.1.0
Now the upgrade is complete and you can execute database upgrade visiting your Magento store in your browser. 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.
Need any help with Magento upgrade?
Turnkeye.com offers professional Magento support services (including Magento development and Magento upgrade service), feel free to contact our team.
Troubleshooting
1 – Magento upgrade script error:
upgrade-all: Please check for sufficient write file permissions.
Error: upgrade-all: Your Magento folder does not have sufficient write permissions, which downloader requires.
Execute this command to correct the error:
chmod -R 777 Upgrade
2 – Magento upgrade script error:
upgrade-all: Invalid stability in compareStabilities argument.
Execute these commands, it will fix the issue:
./mage channel-add connect20.magentocommerce.com/community
./mage channel-add connect20.magentocommerce.com/core
./mage sync
3 – Server error:
“Internal Server Error” instead of Magento storefront page or administration zone pages.
Most likely issue is connected with wrong permissions.
Fix this issue using these recursive commands:
find . -type f -exec chmod 644 {} \;
find . -type d -exec chmod 755 {} \;
4 – Magento error: Different errors in Magento database.
Re-index your database in Magento administration panel and clear Magento cache.
5 – Magento error:
“Invalid mode for clean() method”.
Clear Zend cache (all files, including “Backend” folder) in [magento_folder]/app/code/core/Zend/Cache/
rm -rf app/code/core/Zend/Cache var/cache/* var/session/* (nice little command for you!!!)
6 – Magento error:
“Call to a member function toHtml() on a non-object in …/Layout.php”.
Open [magento_folder]/app/design/frontend/default/[your_theme]/layout/page.xml and replace this line of the code:
<block type=”core/profiler” output=”toHtml”/>
With:
<block type=”core/profiler” output=”toHtml” name=”core_profiler”/>
7 – Magento error:
“Maximum key size must be smaller 32″.
Clear Magento cache.