Dec 18, 2015 Tag: TYPO3

Upgrade TYPO3 from 4.5 to 6.2

Lessons I’m learning

Rumors say upgrading a TYPO3 installation from 4.5 to 6.2 is easy and straightforward. My experience: It’s not! As usual it is the extensions that are causing problems. Here is my very own checklist of upgrade steps. It has not come to an end yet!

Updated on Mar 10, 2016

Navigate this page:

1 Preparations

  • Find a server where you can “play god” and safely work.
  • Make a copy of your installation. Only work on the copy!
  • Use a powerful editor or IDE like PhpStorm for PHP work
  • Become a “master of GIT” - that’s really helpful.

2 In the 4.5 Installtool

  • Logout from the backend. Best: remove all relevant cookies.

  • Make sure the system and PHP is ok. Use the Installtool!

  • If you’ll be running PHP from the commandline too: Make sure commandline PHP is configured properly.

  • Use a system with “endless” resources to prevent timeouts or “insufficient memory”:

    001

  • Cleanup the database until it’s perfect:

    002

  • Check the Update wizard of 4.5: Is something left to do with the current installation?

    003

  • Cleanup everything

    011

    and

    012

3 Update the Reference Index

  • Fix the reference index using the 4.5 installation. Either run this from the commandline:

    013

    or go to System, DB-Check, Check and update global reference index in the backend. We take this way since the system has been given enough resources for this.

    014

  • Be patient - updating the reference index may take a while

    015

4 In the 4.5 Backend

  • Clear all Caches

    016

  • Log out

5 Switch the TYPO3 Source to 6.2

Download:

017

Unpack, symlink and create semaphore file:

019

6 In the 6.2 Installtool

  • Check system health and do what’s necessary:

    004

  • Make sure the installation can download files. Enable Curl if necessary:

    037

  • Check the graphics functionality!

7 In the 6.2 Installtool: More to do?

Is there more to do, repair or set? For example:

System Locale Settings

Warning:

009

Find out:

007

Set:

010

System Environment

Choose the system environment:

008

Use “Development”:

006

The details:

005

8 In the 6.2 Installtool

  • Execute the Update wizard step by step. Be patient! Some steps need a lot of time.

Better:

  • Excute step one of the Update wizard first. It changes database tables and fields.

  • Run the normale “Compare Database” of the Installtool and double check. Fix what’s left.

  • Continue with Update wizard

  • Finally: Compare Database again and adjust again if necessary until everything is perfect:

    020

  • Clear cache:

    021

  • Make sure all extensions can be loaded:

    022

    You should see:

    023

9 Backup the extensions in typo3conf/ext

I’m using Git to make a backup:

  • Make public_html/typo3conf a Git repository and add ext/ to the repo. So we are freezing everything from ext/.

10 In the 6.2 Backend

  • Update the list of extensions in the extension manager

  • Manage extensions.

  • Update extensions that can be updated:

    024

  • Remove extensions totally if they are not needed or if you plan to reinstall from TER.

    Uninstall:

    025

    Delete from server:

    026

11 Use the ‘Smoothintegration’ Tool

Get the latest version from https://github.com/nxpthx/typo3-upgradereport and install as extension.

Overcome Error 1

For me and in TYPO3 6.2 on a case sensitive filesystem the “Report” function throws an error. To overcome this make a copy of module.html:

cp -p typo3conf/ext/smoothmigration/Resources/Private/Layouts/module.html \
      typo3conf/ext/smoothmigration/Resources/Private/Layouts/Module.html

Overcome Error 2

Overcome error “”“Version number in composer manifest of package “sr_feuser_register” is missing or invalid”“”

027

The fix:

  1. Remove or rename typo3conf/ext/sr_feuser_register/composer.json
  2. Clear cache in the backend
  3. Go to backend module “smoothintegration” again

Configure the “smoothintegration” tool

Go to ‘configure’ in the extensionmanager:

028

Scan only what’s necessary:

029

Use ‘smoothmigration’ To Run Checks

Run a check:

030

And see the result:

031

Tip: Save the result frame as HTML-file!

Uah#1: Attention!

You better become a core developer and learn that this will work in 6.2:

032

but this will not:

033

Uah#2

So what? ext:div2007 v1.6.0 claims to be compatible with 6.2.

034

But smoothmigration lists a lot of stuff. So I’ll add it to the list of extensions to exclude from being check in ext:smoothmigration:

035

Note: ext:div2007 seems to be used by ext:sr_feuser_register only.

12 Fix the PHP Code of Extension

At least include/include_once issues need to be addressed. You may use ‘smoothintegration’ to have those changes done automatically (on the commandline only). I tried that but wasn’t successful.

So I now prefer to uncomment the critical lines manually.

13 Continue With Extensions

Reinstall extensions where necessary. For example ‘ext:t3sportstats’:

036

99 The Happy Ending!?

I’m still on my way! Stay tuned!

Comments

comments powered by Disqus

Previous topic

TYPO3 Usergroup Meeting in Münster

Next topic

Upgrade to Python 2.7.11 on Ubuntu 14.04 LTS

Tags

Archives

Languages

Recent Posts

This Page