LTS Upgrade Process

When the preparations are complete, the upgrade process is the same as before for minor level releases. (E.g. 6.1 to 6.2.)

You can skip intermediate minor versions, so there is no need to do an intermediate upgrade to upgrade from 4.5 (or 4.7) to 6.2.

Attention

You need to have upgraded to at least TYPO3 4.5 in order to upgrade to 6.2!

Several things will be done automatically when you run the Install Tool of the new version for the first time. Some actions will even happen before the Install Tool opens. So don’t forget to make a backup!

  • The file:typo3conf/localconf.php will be adapted to the new 6.x style of configuration and saved as LocalConfiguration.php.
  • Information about installed extensions will be moved to PackageStates.php file.
  • The ‘’saltedpasswords’’ extension will be installed and activated if it was not previously used.
  1. Make sure you have gone through “Preparation in 4.x”.
  2. Update the typo3_src symlink to point to the new release core.
  3. Open the Install Tool in the browser.
  4. Use the “System Environment” module to see if your system fullfills all required preconditions.
  5. Use the “Important Actions”, item “Check for broken Extensions”. If there are extensions that might break your current installation (i.e. calling removed methods in their ext_localconf.php or ext_table.php), you must remove them until they are updated.
  6. Use the “Upgrade Wizard” as usual to migrate your installation.

After the upgrade

If you have not used DAM before and were just using regular files with TYPO3 Content Elements, the “Upgrade Wizards” will have converted your structure to FAL and you are all set and ready.

If you were working with “DAM” (Digital Asset Management) in TYPO3 4.5 or 4.7, you will want to migrate your data to the core “FAL” (File Abstraction Layer).

DAM and its related extensions no longer work with TYPO3 CMS 6.x. For this, read on in the next chapter.

In TYPO3 CMS 4.5 languages could be defined by setting config.language = xy in TypoScript and having according labels in <languageKey index="xy" type="array"> in language files. In TYPO3 CMS 6.2 by default this is possible only for those language keys that have been defined in typo3/sysext/core/Classes/Localization/Locales.php. If you want to use a language without a definition there (e.g. en_US), you have to add it on your own as described here: Custom languages.