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

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


.. _administrators_migration_typo3console:


TYPO3 Console
=============

Setup
-----

Install the EXT:typo3_console

This will install the file `public_html/typo3cms`.

List
----

List the available Upgrade Wizards

.. code:: bash

  my@server:~/public_html$ php typo3cms upgrade:list

  Wizards scheduled for execution:
  +----------------------+-------------------------+
  | Identifier           | Title                   |
  +----------------------+-------------------------+
  | browser2xblog_update | Browser2xBlog Migration |
  +----------------------+-------------------------+


Migration
---------

Run Browser2xBlog Migration

.. code:: bash

  my@server:~/public_html$ php typo3cms upgrade:wizard browser2xblog_update

  -----------------------------------------------------------------------
  Pages with a migrated xBlog plugin
  -----------------------------------------------------------------------
  Please paste and copy this list to a local file.
  https://die-exen.de/index.php?id=824
  https://die-exen.de/index.php?id=3426
  https://die-exen.de/index.php?id=3420
  https://die-exen.de/index.php?id=3433
  https://die-exen.de/index.php?id=3434
  https://die-exen.de/index.php?id=3444
  https://die-exen.de/index.php?id=3448
  https://die-exen.de/index.php?id=3448
  https://die-exen.de/index.php?id=3448
  https://die-exen.de/index.php?id=3426
  https://die-exen.de/index.php?id=3426
  https://die-exen.de/index.php?id=3514
  https://die-exen.de/index.php?id=3514
  https://die-exen.de/index.php?id=3514
  https://die-exen.de/index.php?id=3513
  -----------------------------------------------------------------------
  Please check, if there are to-dos
  -----------------------------------------------------------------------
  SELECT uid, pid, header, rowDescription FROM `tt_content` WHERE rowDescription LIKE "%ToDo:%" AND _migrated = 1 AND deleted = 0 ORDER BY pid, uid;
  -----------------------------------------------------------------------
  Queries:
  -----------------------------------------------------------------------


Canceling and clean up
----------------------

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 

.. code:: bash

  my@server:~/public_html$ php typo3cms upgrade:list

  Wizards scheduled for execution:
  +-----------------------+-----------------------------------+
  | Identifier            | Title                             |
  +-----------------------+-----------------------------------+
  | browser2xblog_cancel  | Browser2xBlog Migration Canceling |
  +-----------------------+-----------------------------------+
  | browser2xblog_cleanup | Browser2xBlog Migration Clean up  |
  +-----------------------+-----------------------------------+