Ein Typo-Ugrade bzw. Update ist immer eine heikle Sache. Damit dabei nichts schief geht habe ich einmal die wichtigsten Schritte festgehalten. Diese Anleitung gilt sowohl für “.zip” sowie “tar.gz” Pakete.
1. Vorbereitung
- Überprüfen der PHP Version, TYPO3 4.2 benötigt mindestens PHP 5.2.0.
- Überprüfung aller installierten Extensions auf Kompatibilität mit Typo3 4.2.
2. Typo3 Source-Files downloaden
Von der TYPO3 Homepage die letzte stabile Version downloaden und lokal auf dem Computer speichern. Zwei Source-Files stehen zu Auswahl:
- tar.gz Source
- ZIP Source
Je nach Bedarf und Vorliebe entsprechende Source wählen.
3. TYPO3 Source-Files auf den Server laden
Mit einem FTP-Programm (z.B. Filezilla) die Files in das Root Verzeichnis des Servers laden:
normalerweise /public_html/ oder /htdocs/
Hinweis: Das Root Verzeichnis beinhaltet die Typo3 Verzeichnisse: typo3, t3libs, typo3config,…
4. Source Files auf dem Server entpacken
Hinweis: Ab hier wird Ihre Homepage nicht mehr verfügbar sein bis Sie das Update vollzogen haben!
Abhängig vom heruntergeladenen Source-Code bitte entsprechendes Vorgehen auswählen:
Für das tar.gz package:
- Benützen sie ein SSH-Programm wie z.B. Putty und loggen Sie sich damit auf Ihrer Homepage. Navigieren sie zum Root Verzeichnis.
- Den Source-Code mit folgenden Kommandos extrahieren:
tar -xzpvf typo3_src-4.2.0.tar.gz
Hinweis: den Filenamen an Ihre aktuelle Version anpassen
- Den Symlink von TYPO3 löschen mit:
rm typo3_src
- Einen neuen TYPO3 symlink anlegen:
ln -s typo3_src-4.2.0 typo3_src
Hinweis: der erste Buchstabe ist ein kleines „L“
Hinweis: den Filenamen an Ihre aktuelle Version anpassen
Für das zip package:
- Das Verzeichnis /t3lib/ auf /t3libOLD/ umbenennen.
- Das Verzeichnis /typo3/ auf /typo3OLD/ umbenennen.
- Das Verzeichnis /misc/ auf /miscOLD/ umbenennen.
- Das File index.php auf index.old umbenennen.
- Den Zip Source-Code im Root-Verzeichnis entpacken, aber beachten sie, dass dies stark von der Server-Konfiguration abhängt. Besser das Zip-File lokal entpacken und dann per FTP hochladen.
- In Ihrem Rootverzeichnis sollten jetzt die Verzeichnisse typo3, t3libs, misc sowie die Datei index.php vorhanden sein.
5. Install-Tool aktiviern
Im Verzeichnis: /typo3conf/
das File: ENABLE_INSTALL_TOOL anlegen.
Dadurch wird das Install-Tool im TYPO3 Backend freigeschaltet. Ein Tutorial zum Freischalten des Install-Tool findet Ihr hier.
6. Datenbank updaten
- Im Typo3 Backend einloggen und hier werden sie feststellen das bereits eine gelbe Warnbox auf sie wartet. Sie werden hingewiesen das sie ein Update durchgeführt und die Datenbank noch nicht auf die neue Version upgedatet haben. Ebenso sollten sie darauf hingewiesen werden, dass das Install-Tool aktiviert ist.
- In der linken Backend-Navigation auf das Install Tool wechseln und dort einloggen.
- Klicken Sie dort auf „Update Wizard“
- Bei den meisten Typo3 Installationen werden sie im Bereich Update Wizard jetzt 3 Boxen vorfinden:
- changeCompatibilityVersion
- removeNotInMenuDoktypeConversion
- mergeAdvancedDoktypeConversion
- Überspringen sie changeCompatibilityVersion und starten sie mit den anderen beiden. Bei removeNotInMenuDoktypeConversion und mergeAdvancedDoktypeConversion klicken Sie auf “Next” und dann auf “Perform updates!”.
- Zum Schluss gehen sie wieder zurück zu der ersten Box changeCompatibilityVersion. Klicken Sie auf “Next” und akzeptieren Sie ALLE Checkboxen. Mit Klick auf “Perform updates!” führen sie die Änderung durch.
Hinweis: Beim RTE gab es eine wesentliche Änderung, dass bisherige InlineCSS wurde abgeschafft! Mehr dazu erfahren Sie in Punkt 8. - Im nächsten Schritt gehen sie zum „Database Analyzer“ und scrollen bis ganz nach unten bis zum Schritt “COMPARE”. Durch Klick auf „Write to Database“ werden die Änderungen mit der Datenbank abgeglichen.
7. Nicht benötigte Extensions deinstallieren
Einige Extensions wurden in den TYPO3 4.2 Core aufgenommen und sind deshalb obsolete. Sie sollten diese Extensions im Extension Manager deinstallieren:
- sr_static_info
- p2_menudom
- ter_update_check
- newloginbox
- dkd_redirect
8. Rich Text Editor CSS einbinden
Bei frühere Versionen vom Rich Text Editor (RTE) in TYPO3 wurden die CSS Styles als inlineCSS in den Text eingebunden. Die neue Version vom RTE fügt Style-Tags hinzu um die Formatierung über externen Style Sheets steuern zu können. Damit der formatierte Text auch weiterhin korrekt angezeigt wird, müssen Sie das RTE-Style Sheet noch im Header einbinden.
- Klicken Sie dazu im Backend im linken Menü auf Template.
- Wählen Sie Ihr ROOT-Template aus.
- Klicken Sie auf Info/Modify im Drop-Down Menu
- Gehen sie in den Setup Bereich
- Um das Style Sheet einzufügen müssen Sie folgenden Code im Setup-Bereich hinzufügen:
page.headerData.2 = TEXT page.headerData.2.data = path:EXT:rtehtmlarea/res/contentcss/default.css page.headerData.2.wrap = <link rel="stylesheet" type="text/css" href="|" />
- Nachdem alles eingefügt wurde auf “Speichern” klicken.
- Nicht vergessen den Cache zu leeren!
Nun sollten die Formatierungen vom RTE wieder korrekt gerendert werden.
9. Installtool aus Sicherheitsgründen wieder sperren
Im Verzeichnis: /typo3conf/
das File: ENABLE_INSTALL_TOOL umbennen auf DISABLE_INSTALL_TOOL.
Dadurch wird das Install-Tool im TYPO3 Backend wieder gesperrt.
10. Webseite überprüfen
Das Upgrade ist hiermit abgeschlossen und die Homepage sollte wie gewohnt funktionieren… wie gesagt sollte 
Bei mir gab es kleine Probleme mit der Tabellendarstellung im RTE, aber diese konnte ich durch erneutes speichern ganz einfach beheben.
