.. ==================================================
.. FOR YOUR INFORMATION
.. --------------------------------------------------
.. -*- coding: utf-8 -*- with BOM.

.. include:: ../../../Includes.txt


.. _administrators_migration_upgradewizard:


Upgrade Wizard
==============

.. note::
  Upgrade Assistant is extremely resource hungry. You certainly need to adjust the memory_limit of your php.ini.
  You can also upgrade without the Upgrade Assistant. See next chapter: :ref:`typo3_console <administrators_migration_typo3console>`


Step 1
------

The Upgrade Wizard will display the quantity of plugins, which will be migrated:

.. figure:: typo3_browser2xblog_01.jpg
	:width: 800px
	:alt: TYPO3 browser2xblog: Upgrade Wizard Step 1


Step 2
------

**You MUST enable** the option "Show database queries performed". Only then you will get an important report.
See step 3 of the Upgrade Wizard.

.. figure:: typo3_browser2xblog_02.jpg
	:width: 800px
	:alt: TYPO3 browser2xblog: Upgrade Wizard Step 2


Step 3
------

The report of the Upgrade Wizard has three parts:

#. A list with urls with pages with one or more migrated plugins
#. A SQL query for your database. Query will prompt all plugins with a so called ":ToDo:"
   These plugins could not migrated proper properly. It's a good idea to check them manually.
#. The performed queries.

.. figure:: typo3_browser2xblog_03.jpg
	:width: 800px
	:alt: TYPO3 browser2xblog: Upgrade Wizard Step 3


Upgrade Wizard Step 4
---------------------

If you start the Upgrade Wizard again, you have to options:

* You can cancel the migration. This will restore all plugins of the EXT:browser
* You can delete the former plugins of the EXT:browser. You run this Upgrade Wizard, if
  you are satisfied and like to have a cleaned up installation 

.. figure:: typo3_browser2xblog_04.jpg
	:width: 800px
	:alt: TYPO3 browser2xblog: Upgrade Wizard Step 4