Upgrade to TYPO3 6.

2
Jochen Weiland
Stefan Frmken
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 Changes
http://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 rst: smaller database and project to copy, but you make changes in live system

Copy-rst: 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 cant 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
Namespacing
typo3/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 eld 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 rst, 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 cant 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 xed 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 le specied: 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
Dont remove/rename elds 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 kongurieren,

Static modules: static_info_tables und sr_language_menu neu einfgen

DefaultISOlanguage in TS setzen: plugin.tx_srlanguagemenu.settings.defaultLanguageISOCode = DE
Changes in TypoScript
le.treatIdAsReference = 1
DAM to FAL Migration

First, lets see how files are handled

TYPO3 4.x
local file
uploads/media
uploads/pics
uploads/
fileadmin/.
direct upload
RTE upload
upload through
element browser
content
element
typo3temp/
BROWSER
rendered images
RTE linked les
TYPO3 6.x - FAL
local file
fileadmin/
user_upload
direct upload
upload through
element browser
RTE upload
fileadmin/_processed_
BROWSER
rendered images
fileadmin/.
TYPO3 4.x DAM
local 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 DAM
local 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
addl data
DAM to FAL Migration
tx_dam
tx_dam_categories
sys_file
sys_category
sys_file_metadata
ext:lemetadata
some information may be lost
(e.g. copyright)
some elds may be lost (if they dont exist in sys_le_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