Dec 18, 2015 Tag: TYPO3
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:
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”:
Cleanup the database until it’s perfect:
Check the Update wizard of 4.5: Is something left to do with the current installation?
Cleanup everything
and
Fix the reference index using the 4.5 installation. Either run this from the commandline:
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.
Be patient - updating the reference index may take a while
Clear all Caches
Log out
Check system health and do what’s necessary:
Make sure the installation can download files. Enable Curl if necessary:
Check the graphics functionality!
Is there more to do, repair or set? For example:
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:
Clear cache:
Make sure all extensions can be loaded:
You should see:
I’m using Git to make a backup:
public_html/typo3conf
a Git repository
and add ext/
to the repo.
So we are freezing everything from ext/
.Update the list of extensions in the extension manager
Manage extensions.
Update extensions that can be updated:
Remove extensions totally if they are not needed or if you plan to reinstall from TER.
Uninstall:
Delete from server:
Get the latest version from https://github.com/nxpthx/typo3-upgradereport and install as extension.
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 “”“Version number in composer manifest of package “sr_feuser_register” is missing or invalid”“”
The fix:
typo3conf/ext/sr_feuser_register/composer.json
Go to ‘configure’ in the extensionmanager:
Scan only what’s necessary:
Run a check:
And see the result:
Tip: Save the result frame as HTML-file!
You better become a core developer and learn that this will work in 6.2:
but this will not:
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.
Reinstall extensions where necessary. For example ‘ext:t3sportstats’:
I’m still on my way! Stay tuned!