< CMS Certified Integrator 13 LTS

Upgrade Wizards

TYPO3

Show in app

Description

The Upgrade Wizard is a tool available to system maintainers that checks for and executes pending migration tasks after a TYPO3 Core or extension upgrade. Integrators need to know when and how to run these wizards, what prerequisites must be met beforehand, and how to execute them both via the backend and the CLI.

Goals

  • I know the purpose of the upgrade wizards.
  • I know how to reset an upgrade wizard (mark to re-run).
  • I know that upgrade wizards are accessible via the backend module and require system maintainer permissions and the typo3/cms-install package.
  • I know that upgrade wizards can only be executed if no database tables or columns are missing, and that the Database Analyzer must be run first if any are absent.
  • I know that upgrade wizards should be checked after every major or minor Core upgrade and after installing or updating third-party extensions that ship their own wizards.
  • I know the CLI commands to list and run upgrade wizards: vendor/bin/typo3 upgrade:list and vendor/bin/typo3 upgrade:run.
  • I know that upgrade:run without an argument runs all pending wizards, and that a specific wizard can be targeted by passing its identifier as an argument.
  • I know that some upgrade wizards are optional and can be skipped.
  • I know that all upgrade wizards of the current major version must be completed before upgrading to the next major TYPO3 version.

Maintainer

Oliver Thiele Web Development Oliver Thiele