====== Upgrading Magento ======

===== 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.**

  - Backup your database
  - Backup all the code you modified yourself, and don't forget to keep the original installation archive
  - Take care of saving the media directory that contains all the uploaded product/category images
  - Create a backup copy of app/etc/local.xml file
  - Download a new installation archive or run SVN update if you checked it out  from the Magento repository
  - Extract and upload all the files it contains to your server
  - Delete var/cache and var/session directories
  - Point your browser to any Magento page
  - Database upgrades should happen automatically
  - You are done!

===== Upgrading Magento using the MagentoConnect Manager =====
  - Go to http://your.server.com/magento/downloader
  - Log in using a user who has full permissions
  - Make sure to select "Clear all sessions after successfull 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
  - Click 'Select all upgradable extensions'
  - Click 'Commit changes'
  - Watch the console progress for error messages
  - After successfully upgrading click the 'Refresh' button that will appear under the console frame.

===How to upgrade specific extensions===
  - For each desired extension upgrade choose 'Upgrade' in the dropdown
  - 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===
  - 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.
  - Enter ''magento-core/Mage_Downloader'' in the Extension key input field and click Install.
  - 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=====
  - To initialize the Magento PEAR command line registry, run the following command from the shell. Make sure you are in the Magento root folder: 
  - ''./pear mage-setup .'' 
  - (make sure to include the second '.')
  - select php version (unix): ''MAGE_PEAR_PHP_BIN=/usr/local/bin/php; 
  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:
  - ''./pear install magento-core/Mage_All_Latest''

=== How to upgrade all available extensions ===
  - ''./pear upgrade-all''

=== How to upgrade specific extensions ===
  - ''./pear upgrade magento-core/Mage_Core_Modules magento-core/Mage_Core_Adminhtml''
  - ''./pear upgrade magento-core/Interface_Adminhtml_Default magento-core/Interface_Frontend_Default magento-core/Interface_Install_Default''

=== How to upgrade MagentoConnect Manager ===
  - If MagentoConnect Manager is not installed as a PEAR package yet:
  - ''./pear install magento-core/Mage_Downloader''
  - After it is installed it will be upgraded just as any other extension.