upgrade auf typo3 6 - jweiland.net extension can be used in typo3 4.5-4.7, after upgrading to 6.2...
TRANSCRIPT
Upgrade auf TYPO3 6.2
Jochen Weiland !!
TYPO3camp München 2014
Fakten
• Kunden lieben LTS Versionen
• Die meisten Projekte laufen mit 4.5
Fakten
• 3.5 Jahre seit dem Release 4.5
• 34 Release seitdem
Fakten
• 5 Major Releases:4.5 4.6 4.7 6.0 6.1 6.2 Jedes mit vielen neuen Features!
Dank an Patrick Lobacher (der alle Änderungen dokumentiert)
550+ Seiten Änderungenhttp://typo3.org/download/release-notes/whats-new/
www.lobacher.de
Fakten
• 500.000+ Web Seiten mit TYPO3
• weniger als 200 Tage zum Updaten!
• ~ 2.500 Updates pro Werktag!
Fakten
• ~ 1.000 TYPO3 Agenturen
• ~ 500 Upgrades für jede Agentur
• ~ 3 Upgrades pro Tag
Upgrade Vorbereiten
Wichtig
• Niemals ein Update direkt auf der Live-Seite
• Upgrade immer auf einer Kopie vornehmen
• Backup vorhanden? Wirklich?
Eure Wahl:
• Installation aufräumen, dann Kopie erstellen
• schneller, aber Änderungen an Live-Seite
• Kopie erstellen, dann Aufräumen
• sicherer, aber langsamer
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
Kopie Erstellen
• Komplette Dateistruktur des Projekts kopieren
Kopie der Datenbank
• Neue, leere Datenbank erstellen
• Collation: utf8_general_ci
• Datenbank duplizieren: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
Kopie Fertigstellen
• Neue Domain (VHost) erstellen und Domain-Records anpassen
• localconf.php (oder Install Tool): Zugangsdaten Datenbank anpassen
• TypoScript: baseURL anpassen
Installation Aufräumen• Lokale, nicht installierte Extensions
entfernen
Installierte, nicht benötigte Extensions
deinstallieren
Tipp: Extension „Additional Reports“
in our example we removed: lorem_ipsum, veguestbook, timtab, adminpanel, sbaccessiblecontent, lib, div
Ext: additional_reports
when you try to delete an extension, the number of records in the database will be shown
Obsolete Extensions
• Funktioniert vielleicht in 6.2, aber Logfiles werden nicht mehr erstellt
Installation Aufräumen
!
• Database Analyzer im Install Tool
• Update Required Tables
• Remove unused tables
Remove unused Tables
Datenbank Verkleinern
• Tabellen leeren:
• 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)
Extensions in 4.5 Aktualisieren
Extension Versionen (4.5)
Warnungen beim Upgrade
Warnung PHP Version
Extensions mit Update Skript
Deprecation Log
Namespacingtypo3/sysext/core/Migrations/Code
für IDE:
PHP Version Prüfen
• TYPO3 4.5, 4.6 arbeiten PHP 5.2-5.5
• TYPO3 4.7 und höher benötigen PHP 5.3-5.5
some old extensions my not be compatible with PHP 5.3+ !update realurl Extension
Error Display Einschalten
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
Referenz 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
Referenz Index
Smooth Migration
• Erweiterungen extbase und fluid müssen installiert sein
• Extension smoothmigration installieren
• BE User _cli_smoothmigration anlegen
• Backend neu laden
smoothmigration extension can be used in TYPO3 4.5-4.7, after upgrading to 6.2 you can uninstall it
Smooth Migration
Smooth Migration
Übersicht
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“
Datenbank 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!
phpmyadmin
require_once
changed in cron_printlink (pi1, pi2) and sr_language_menu (pi1) !other occurrences will be fixed after updating extensions
Symlink Aktualisieren
• Auf neue TYPO3 Version ändern:typo3_src -> typo3_src-6.2.x
Updating index.php only necessary if not symlinked !
Install Tool Aufrufen
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
Datenbank Prüfen
Don’t remove/rename fields yet, only add/modify if necessary
Cache Leeren
Admin User TSconfig
• options.clearCache.system = 1
Extensions Aktualisieren
Version nicht unterstützt?
ext_emconf.php
Nicht im TER? GIT Probieren!
• git.typo3.org
• Repository from author, e.g.github.com/jweiland-net/rlmp_tmplselector
Extension von 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
Änderungen TypoScript
file.treatIdAsReference = 1
DAM to FAL Migration
• Schauen wir uns mal an, wie Dateien behandelt werden
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 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
Änderungen in Extbase
• New Property Mapper
• Recursive Validation
Scheduler Tasks
• It may be necessary to re-create scheduler tasks
Fragen ?
Download Slides
• http://jweiland.net/t3dd14
Let us be your host