TYPO3 Update von 4.2.x auf 4.3.0

Aus aktuellem Anlass habe ich mal eine Anleitung geschrieben wie sich TYPO3 von Version 4.2.x auf 4.3.0 aktualisieren lässt. Die Anleitung soll dabei als Zusammenfassung dienen und ist nicht als vollständig anzusehen, auch werden TYPO3-Grundkenntnisse (z.B. der Umgang mit dem Install Tool und Extensions) vorausgesetzt.

Ich selbst habe noch einige System-Updates vor mir und verwende die folgenden Schritte sozusagen als Leitfaden, vielleicht sind sie ja auch für den ein oder anderen mit ähnlichen Szenario hilfreich.

Ausgangssituation:

• TYPO3 4.2.10
• RealURL 1.5.3
• tt_news 2.5.2

Als Informationsgrundlage für das Update dient die knapp gehaltene Anleitung in der TYPO3 Wiki Upgrading to 4.3 und die TYPO3 4.3 Release Notes.

1. TYPO3 Source tauschen

Zunächst wird der neue TYPO3 Source wie gewohnt oberhalb des Document Root entpackt und dann daraus verlinkt:

$ tar xvzf typo3_src-4.3.0.tar.gz
$ ln -fs ../typo3_src-4.3.0 typo3_src

2. Install Tool

Nachdem der Source getauscht wurde wechselt man ins Install Tool und führt dort folgende Schritte aus:

2.1 Update Wizard

• changeCompatibilityVersion
• installSystemExtensions
• installNewSystemExtensions
• installVersioning

Unter changeCompatibilityVersion nehme ich gerne die Option CSS Styled Content: htmlspecialchars in menu content elements mit, diese behebt z.B. Probleme mit & (kaufmännisches Und) in Seitentiteln.

Bei installSystemExtensions, installNewSystemExtensions und installVersioning kann man die angebotenen Extensions den eigenen Anforderungen entsprechend übernehmen oder weglassen.

2.2 Database Analyser

Anschließend führt man im Database Analyser ein COMPARE DATABASE aus, dies bring die Tabellenstruktur der Datenbank auf den aktuellen Stand. Ich führe hier auch immer ein TRUNCATE TABLE cache_hash; mit aus.

3. temp_CACHED Dateien löschen

Nun löscht man im typo3conf Verzeichnis noch alle temp_CACHED Dateien:

$ rm -f temp_CACHED*

4. Alle Caches löschen

Das eigentliche System-Update ist damit soweit schon angeschlossen, bevor man nun die Ausgabe im Frontend kontrolliert sollte man noch alle Caches im TYPO3-Backend leeren.

5. Extensions deinstallieren

Grundlegend empfiehlt es sich nicht verwendete bzw. benötigte Extensions zu deinstallieren. Bei mir stehen z.B. folgende System-Extension je nach Projekt zur Diskussion:

5.1 Backend

• t3editor (funktioniert leider aktuell noch nicht in WebKit-Browsern)
• version (je nach Bedarf)

5.2 Frontend

• feedit (kann ggf. auch durch feeditadvanced ersetzt werden)
• simulatestatic (bei Verwendung von RealURL)

6. Extensions aktualisieren

Auch alle verwendeten Extensions sollten aktualisiert werden, dies geschieht im Erw-Manager:

• [Settings: Enable extensions without review (basic security check)] *
• Import Extensions: Retrieve/Update
• Check for extension updates

* natürlich auf eigenes Risiko

Unter Check for extension updates werden, nachdem man das Repository aktualisiert hat, alle Updates für die installierten Extensions aufgeführt. Durch einen Klick auf den Namen der jeweiligen Extension kann man diese aktualisieren, anschließend das Update nicht vergessen.

Wichtig sind vor allem die Updates von RealURL und tt_news da diese die Kompatibilität zu TYPO3 4.3 sicherstellen. Beim Update von tt_news sollte man vorher einen Blick in die Datei tt_news_3.0_changes.sxw werfen. Dort wird genau beschrieben was man alles beim Update beachten sollte. tt_news bring außerdem zusätzlich einen Updater mit der dabei hilft eine bestehende tt_news 2.5.x Installation auf 3.x.x zu portieren.

7. Translation Handling

Abschließend kann man im Erw-Manager auch noch das Translation Handling aktualisieren:

• Translation handling: Update from repository

Damit ist das Update vollständig und TYPO3 samt Extensions auf dem aktuellen Stand. Ob alles glatt ging zeigt eine anschließende umfangreiche Funktionsprüfung. Viel Glück!

Anregungen, Tipps, Kritik etc. kann übrigens gerne in den Kommentaren hinterlassen werden.