Upgrading Magento

Last modified by jjhixon on Thu, June 24, 2010 15:33
Source|Old Revisions  

This is an old revision of the document!

Upgrading Magento with a full package or via SVN

Here are the steps for upgrading Magento with a full package or via SVN. Steps for upgrading with the MagentoConnect Manager are below.

  1. Backup your database
  2. - In Magento go to Admin, System → Tools → Backups
  3. - You can use PHPMyAdmin (but this may fail due to time-limits on php scripts)
  4. - You can export in SSH by typing...
  5. - mysqldump -u USER -p DBNAME > dump.sql
  6. - Reimport using mysql -u USER -p DBNAME < dump.sql
  7. Backup all the code you modified yourself, and don’t forget to keep the original installation archive
  8. Take care of saving the media directory that contains all the uploaded product/category images
  9. Create a backup copy of app/etc/local.xml file
  10. Download a new installation archive or run SVN update if you checked it out from the Magento repository
  11. Extract and upload all the files it contains to your server
  12. Delete var/cache and var/session directories
  13. Point your browser to any Magento page
  14. Database upgrades should happen automatically
  15. You are done!

Upgrading Magento using the MagentoConnect Manager

  1. Go to http://<YOUR_SERVR>/downloader
  2. Log in using a user who has full permissions
  3. Make sure to select “Clear all sessions after successful install or upgrade”

How to upgrade from tarball installation

It is possible that you will see no extensions in MagentoConnect Manager. This means that you have just uploaded the files without using PEAR downloader. In that case enter magento-core/Mage_All_Latest in the extension key field and click Install button. This will install all latest MagentoConnect core packages on top of existing files and will allow future upgrades through MagentoConnect.

NOTE: if, after the install has completed and you hit Refresh, you get a 500 error, and you get the same on your regular admin page and your storefront, you may need to change permissions on your .php files. SSH into your server, navigate to your Magento directory, and issue this command to change the permissions on all your .php files to 644 (the -v switch will make it verbose, so you will see all the changes as they are made):

find -type f -name ‘*.php’ -exec chmod -v 644 {} ;

Reload downloader/index.php to continue.

How to upgrade all available extensions

There should be at least one extension marked in yellow, which means a higher version is available on the MagentoConnect server

  1. Click ‘Select all upgradable extensions’
  2. Click ‘Commit changes’
  3. Watch the console progress for error messages
  4. After successfully upgrading click the ‘Refresh’ button that will appear under the console frame.

How to upgrade specific extensions

  1. For each desired extension upgrade choose ‘Upgrade’ in the dropdown
  2. To upgrade Magento Core modules choose the following packages, and all required dependencies will be upgraded automatically:
    • magento-core/Interface_Adminhtml_Default
    • magento-core/Interface_Frontend_Default
    • magento-core/Interface_Install_Default
    • magento-core/Mage_Core_Adminhtml
    • magento-core/Mage_Core_Modules

How to upgrade MagentoConnect Manager

  1. MagentoConnect Manager is not installed as a PEAR package by default. If you wish to upgrade it, you will first need to install it as a PEAR package.
  2. Enter magento-core/Mage_Downloader in the Extension key input field and click Install.
  3. After it is installed the first time, you can upgrade it the same way as other extensions.

You can not uninstall MagentoConnect Manager

Using SSH shell access

You need to discuss the folder/file permissions here!!!

  1. To initialize the Magento PEAR command line registry, run the following command from the shell. Make sure you are in the Magento root folder:
  2. ./pear mage-setup .
  3. (make sure to include the second ‘.’)
  4. select php version (unix): MAGE_PEAR_PHP_BIN=/usr/local/bin/php; export MAGE_PEAR_PHP_BIN
    • for 1and1.com hosting, to use PHP5: MAGE_PEAR_PHP_BIN=/usr/local/bin/php5; export MAGE_PEAR_PHP_BIN

How to upgrade from tarball installation

If you have not used MagentoConnect or PEAR command line to install Magento, you will need to enter this command for initial PEAR installation of all Magento core modules:

  1. ./pear install magento-core/Mage_All_Latest

(You may have to upgrade pear extensions using the next step for this step to work).

How to upgrade all available extensions

  1. ./pear upgrade-all

How to upgrade specific extensions

  1. ./pear upgrade magento-core/Mage_Core_Modules magento-core/Mage_Core_Adminhtml
  2. ./pear upgrade magento-core/Interface_Adminhtml_Default magento-core/Interface_Frontend_Default magento-core/Interface_Install_Default

How to upgrade MagentoConnect Manager

  1. If MagentoConnect Manager is not installed as a PEAR package yet:
  2. ./pear install magento-core/Mage_Downloader
  3. After it is installed it will be upgraded just as any other extension.