Upgrading Magento

Last modified by KWAVE 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. Backup all the code you modified yourself, and don’t forget to keep the original installation archive
  3. Take care of saving the media directory that contains all the uploaded product/category images
  4. Create a backup copy of app/etc/local.xml file
  5. Download a new installation archive or run SVN update if you checked it out from the Magento repository
  6. Extract and upload all the files it contains to your server
  7. Delete var/cache and var/session directories
  8. Point your browser to any Magento page
  9. Database upgrades should happen automatically
  10. You are done!

Upgrading Magento using the MagentoConnect Manager

  1. Go to http://<YOUR_SERVER>/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.

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:
    • Interface_Adminhtml_Default
    • Interface_Frontend_Default
    • Interface_Install_Default
    • Mage_Core_Adminhtml
    • 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.