Upgrade to TYPO3 6.2

Jochen Weiland Stefan Frömken

Riona Kuthe !

T3DD14 - Eindhoven - The Netherlands

Facts

• Customers love LTS

• Most Projects still on 4.5

Facts

• 3.5 Years since Release of 4.5

• 34 Releases since then

Facts

• 5 Major Releases:4.5 4.6 4.7 6.0 6.1 6.2 Each with many new features!

Thanks to Patrick Lobacher (who keeps track of the changes)

550+ Pages of Changeshttp://typo3.org/download/release-notes/whats-new/

www.lobacher.de

Facts

• 500.000+ Web Sites made with TYPO3

• less than 300 days left to update!

• ~ 2.000 Updates per work day!

Facts

• ~ 1.000 TYPO3 Agencies

• ~ 500 Upgrades for each Agency

• ~ 2.5 Upgrades per day

Preparing the Upgrade

Important

• Never ever on live site!

• Use a copy of live site for upgrade!

• Make sure you have a backup!

Your Choice:

• Clean-up installation, then make copy

• faster, but changes in live site

• Make copy, then clean-up installation

• safer, but slower

Clean-up first: smaller database and project to copy, but you make changes in live system !Copy-first: you are on the safe side, but copying takes longer

Creating a Copy

• Copy complete project file structure

Creating a DB Copy

• Create new, empty database

• Collation: utf8_general_ci

• Duplicate the database: mysqldump --opt -u user1 -ppassword1 olddatabase | mysql -u user2 -ppassword2 newdatabase

in typo3conf: !../../tools/mysqldump --opt -u root -psecret muster-45 | ../../tools/mysql -u root -psecret muster-t3dd14 !if database host is NOT 127.0.0.1, you need to specify host with -h host

Finalize Copy

• Create new domain (virtual host) and update domain records accordingly

• localconf.php (or Install Tool): Enter new database parameters

• TypoScript: Adjust baseURL

Clean Up Installation• Remove local, uninstalled Extensions

Remove installed, unused Extensions

in our example we removed: lorem_ipsum, veguestbook, timtab, adminpanel, sbaccessiblecontent, lib, div

when you try to delete an extension, the number of records in the database will be shown

Obsolete Extensions

• May work in 6.2, but logfiles can’t be created anymore

Clean Up Installation

!

• Run Database Analyzer in Install Tool

• Update Required Tables

• Remove unused tables

Remove unused Tables

Shrink Database

• Decrease table size:

• cache_ …

• cachingframework_ …

• cf_ …

• sys_log, sys_stat, …

• tx_realurl_errorlog, …

SQL statement TRUNCATE will empty a table, DROP will delete a table

For other tables: use phpmyadmin !For very large tables: delete (drop) table and re-create via install tool (compare table structure)

Update Extensions for 4.5

Extension Versions (4.5)

Warning during Upgrade TYPO3 Version

Warning during Upgrade PHP Version

Some Extensions have update scripts

Deprecation Log

Namespacingtypo3/sysext/core/Migrations/Code

for IDE:

Check PHP Version

• TYPO3 4.5, 4.6 work with PHP 5.2-5.5

• TYPO3 4.7 and higher require PHP 5.3-5.5

some old extensions my not be compatible with PHP 5.3+ !update realurl Extension

Enable Error Display

Check ExplicitAllow/Deny

Important: if setting in field explicitADmode is empty, you need to change it to explicitDeny !in TYPO3 6.2, default is explicitAllow

Reference Index

Make sure that all internal Database references are up-to-date !Using shell: make sure that path to php-cli version is correct !Make sure that user _cli_lowlevel exists

Reference Index

Smooth Migration

• Make sure that extensions extbase and fluid are installed

• Install extension smoothmigration

• Create BE user _cli_smoothmigration

• Reload Backend

smoothmigration extension can be used in TYPO3 4.5-4.7, after upgrading to 6.2 you can uninstall it

Smooth Migration

Overview

Run the checks first, then switch to „Report“. Note that the spinner during „Check“ will never stop, so just start the „Check“ process, wait a minute or so and then look up the „Report“

Database utf-8

In most cases you can’t change the MySQL server setting yourself, you need to make sure to use the forceCharset and setDBinit settings in the Install Tool correctly (see next slide)

Database utf-8

Important: if you change these settings, you may end up with unpredictable results in your database. It may be necessary to convert the database to UTF-8 format!

require_once

changed in cron_printlink (pi1, pi2) and sr_language_menu (pi1) !other occurrences will be fixed after updating extensions

Change Symlink

• Change to new TYPO3 version:typo3_src -> typo3_src-6.2.x

• Update index.php in DOC_ROOT

Updating index.php only necessary if not symlinked !

Go to Install Tool

if from BE „no input file specified“: use URL project/typo3/install instead !if connection to DB fails with IP 127.0.0.1, use localhost instead !Note: on jweiland.net Hosting Packages the DB server is at 127.0.0.3 !

After Uninstalling

Upgrade Wizard

Check Database

Don’t remove/rename fields yet, only add/modify if necessary

Clear Cache

Admin User TSconfig

• options.clearCache.system = 1

Update Extensions

Version not supported?

ext_emconf.php

Ext not in TER? Try GIT!

• git.typo3.org

• Repository from author, e.g.github.com/jweiland-net/rlmp_tmplselector

Extensions from git

• in typo3conf/ext:git clone https://github.com/jweiland-net/rlmp_tmplselector

sr_language_menu: Plugin neu konfigurieren, Static modules: static_info_tables und sr_language_menu neu einfügen !DefaultISOlanguage in TS setzen: plugin.tx_srlanguagemenu.settings.defaultLanguageISOCode = DE

Changes in TypoScript

file.treatIdAsReference = 1

DAM to FAL Migration

• First, let’s see how files are handled

TYPO3 4.x

local file

uploads/media uploads/pics

uploads/

fileadmin/….

direct upload RTE upload

upload through element browser

contentelement

typo3temp/…

BROWSER

rendered images

RTE linked files

TYPO3 6.x - FAL

local file

fileadmin/user_uploaddirect upload

upload through element browser RTE upload

fileadmin/_processed_

BROWSER

rendered images

fileadmin/….

TYPO3 4.x DAMlocal file

fileadmin/… uploads/media uploads/pics uploads/

tx_dam/….

upload in backend

index and meta-extraction

use in content

tx_dam_categories

local file

FTP Upload

TYPO3 4.x DAMlocal file

fileadmin/… uploads/media uploads/pics uploads/

tx_dam

upload in backend

index and meta-extraction

use in content

tx_dam_categories

local file

FTP Upload

add’l data

DAM to FAL Migrationtx_dam

tx_dam_categories

sys_file

sys_category

sys_file_metadata

ext:filemetadata

some information may be lost (e.g. copyright)

some fields may be lost (if they don’t exist in sys_file_metadata)

DAM to FAL Migration• Extension dam_falmigration

https://github.com/froemken/t3ext-dam_falmigration

• Migrates tx_dam records to sys_file

• Migrates tx_dam metadata to sys_filemetadata

• Migrates media-tags from RTE to link-tags

• Migrates dam_category to sys_category

DAM to FAL Migration

• typo3/cli_dispatch.phpsh extbase… [help] dammigration:migratedamrecords dammigration:migraterelations dammigration:migratedamcategories dammigration:migratedamcategoryrelations dammigration:migratedamselections dammigration:migratemediatagsinrte

execute this after upgrade has been made in install tool execute before editing content

Update Language Packs

Changes in Extbase

• New Property Mapper

• Recursive Validation

Scheduler Tasks

• It may be necessary to re-create scheduler tasks

Questions ?

Download Slides

• http://jweiland.net/t3dd14

Let us be your host