Upgrade (Admin Tools)

Only available if typo3/cms-install is installed with system maintainer permissions.

The backend module Admin Tools > Upgrade offers tools to system maintainers that are useful during Major upgrades (TYPO3 explained).

Admin Tools -> Upgrade, Overview

The tools listed here are mainly used during Major Upgrades of the TYPO3 Core or a third party extension.

Some tools can also be used to access the quality of custom TYPO3 extensions.

Core updater

In classic mode TYPO3 installations that fulfil certain criteria you can use this function to automatically do patch level TYPO3 Core updates.

Upgrade wizard

The upgrade wizard should be checked before each major Core or extension upgrade. If tasks have been left open they should be resolved before proceeding.

After each upgrade, especially major or minor upgrades, you should check if there are new upgrade wizards that need to be executed.

The upgrade wizards can only be run if no tables or columns are missing. If any are missing, create them using the Database Analyzer.

Use console commands to list and run the upgrade wizards:

# List upgrade wizards that need to be run
vendor/bin/typo3 upgrade:list

# Run a specific upgrade wizard
vendor/bin/typo3 upgrade:run myExtension_exampleUpgradeWizard

# Run all upgrade wizards
vendor/bin/typo3 upgrade:run myExtension_exampleUpgradeWizard
Copied!
# List upgrade wizards that need to be run
typo3/sysext/core/bin/typo3 upgrade:list

# Run a specific upgrade wizard
typo3/sysext/core/bin/typo3 upgrade:run myExtension_exampleUpgradeWizard

# Run all upgrade wizards
typo3/sysext/core/bin/typo3 upgrade:run myExtension_exampleUpgradeWizard
Copied!

Or access module Upgrade from the Admin Tools or Install Tool and then click on Run upgrade wizard....

Some upgrade wizards are not mandatory. You can choose the option "No, do not execute" to skip them.

The TYPO3 Core contains upgrade wizards for two consecutive major versions. Third party extensions can contain additional upgrade wizards for their own purposes (commonly changes to extension database records).

The extension wapplersystems/core-upgrader contains upgrade wizards older than the last two TYPO3 versions. It can be used to migrate the data from installations that need to be upgraded across more than two major versions at once.

View upgrade documentation (Changelogs)

You can read all the changelog entries that affect the current Core version in the module Admin Tools > Upgrade or read them online: TYPO3 Core Changelog Online.

The module allows you to mark changelog entries as read. Read entries are automatically hidden.

Check TCA in ext_tables.php

TCA must not be defined in file ext_tables.php. This is because TCA is required in the frontend context and this file is only loaded in backend context.

This tool can be used to check for incorrect or historical definitions of TCA in ext_tables.php.

Check for broken extensions

This tool tries to load the files ext_localconf.php and ext_tables.php from all the installed extensions. It can help you to detect which extensions are causing errors.

Extension scanner: Scan extension files

The extension scanner report with strong and weak matches

Deprecations as strong and weak matches in the extension scanner for EXT:news

When functionality is to be dropped or changed in the TYPO3 Core in the next major version it is usually already marked as deprecated in the current TYPO3 version.

Therefore, by dealing with deprecations in the current TYPO3 version you can prepare your custom extensions to also work in the next TYPO3 Core version.

The extension scanner can be used to find deprecated code in extensions.

Using the extension scanner to update custom extensions is described in more detail in Extension scanner.