Update von TYPO3 3.8 auf 4.x mit SSH/Shell

Vorgeplänkel

Vorab: Das Anwenden des Tutorials geschieht natürlich auf eigene Gefahr! Es wurde zwar oft getestet, aber garantieren kann ich für nichts :-]

Bei der mittlerweile recht betagten TYPO3 Version 3.8 (oder gar noch ältere) kommt es nach und nach zu Problemen mit den neuen Browsern, da sie nicht mehr alle Funktionen vom alten TYPO3 bereitstellen können. Weiterhin bieten die aktuellen Versionen eine ganze Reihe neuer Funktionen.

Mit SSH geht das sehr bequem :-)

(Hier gibt es das ganze mit FTP-Zugang.)

Altes TYPO3 sichern

Bevor man mit dem Update beginnt, sollte man seine aktuelle Installation sichern.

Per SSH wechselt man in das Verzeichnis seiner TYPO3 Installation.

Zuerst sollte man die Datenbank exportieren:

mysqldump -uNUTZER -pPASSWORT -h localhost DATENBANK > typo3-db.sql

... und packt alles in ein Packchen ;-)

tar -czf typo3-backup.tar.gz *

Das Paket enthält nun auch schon das DB-Abbild- die Datei kann man also wieder löschen, wenn man sich nicht zumüllen will ;-)

rm typo3-db.sql

Falls etwas schief geht, kann man seine alte Installation wieder herstellen :-)

Sicherheitshalber sollte man auch noch die Liste der Extensions exportieren, damit man notfalls weiß, welche man "drüber installieren" muss, wenn sie nach dem Update nicht mehr angezeigt werden (z. B. Tabelle komplett markieren und in Excel kopieren).

RTE deinstallieren

Da die aktuellen Versionen von TYPO3 den RTE-Editor schon als System-Extension mitbringen, sollte man diesen deinstallieren, falls installiert, da es sonst zu Konflikten kommen kann.

TYPO3 Paket herunterladen

Zuerst muss man sich die aktuellste Version von TYPO3 herunterladen von http://typo3.org/download/packages/ - und zwar das "Source with Dummy"-Paket und lädt es am besten in ein Verzeichnis parallel zu der TYPO3 Installation hoch.

Wenn man wget o.ä. auf seinem Server hat, kann man sich das umherladen des Pakets sparen und es gleich auf seinen Server ziehen.

Hinweis

Ab dem nächsten Schritt sind deine Seiten im Web vorerst nicht mehr aufrufbar! Man sollte also ab diesem Punkt das Update bis zum Ende durchziehen!

Alte Dateien und Ordner löschen

Folgende Ordner und Dateien löschen:

  1. rm -rf t3lib/ 
  2. rm -rf tslib/ 
  3. rm -rf typo3/ 
  4. rm -rf media/ 
  5. rm showpic.php 
  6. rm index.php

Neue Dateien und Ordner kopieren

Das neue TYPO3-Paket wird entpackt:

  1. tar -xzf typo3_src-???.tar.gz

Und folgende Ordner kopiert man einfach mit

  1. cp -R QUELLE ZIEL

über die alte Installation:

  • t3lib/
  • typo3/
  • index.php

Optional kann man auch noch folgende Dateien kopieren (Dokumentation). Sie werden aber für den "Betrieb" nicht benötigt.

  • _.htaccess
  • ChangeLog
  • GPL.txt
  • INSTALL.txt
  • LICENSE.txt
  • NEWS.txt
  • README.txt
  • RELEASE_NOTES.txt

Für den folgenden Ordner muss man die Rechte erweitern:

  1. chmod -R 0777 typo3/ext

Fehlende Ordner erstellen

Nun müssen noch zwei Ordner angelegt werden:

  1. mkdir typo3temp/GB 
  2. mkdir typo3conf/l10n

TYPO3 Backend: Cache leeren

Das Backend von der TYPO3 Installation sollte nun wieder erreichbar sein und nicht anders als vorher aussehen.

Man loggt sich nun mit einem Administrator-Account ein und löscht zuerst einmal den Cache ("Clear cache in typo3conf/" und "Clear FE cache").

BTW: Nicht erschrecken, dass jetzt plötzlich alles in Englisch ist- das reparieren wir noch :-)

Install Tool

Nun müssen noch nötige Änderungen an der Datenbank ausgeführt werden. Man geht dazu im TYPO3 Backend im Menü auf Installation (Menü-Gruppe Tools) um das Install Tool aufzurufen. Ggf. muss man noch die Datei

  • typo3conf/ENABLE_INSTALL_TOOL

erstellen (kann auch leer sein).

Im Install Tool geht man dann auf 2: Database Analyser und dort fast ganz unten auf COMPARE (neben Update required tables).

Die (wahrscheinlich sehr vielen) vorgeschlagenen und angehakten Änderungen mit dem Button Write to Database (ganz unten) ausführen. Damit werden nun benötigte Tabellen, Felder in bestehenden Tabellen angelegt und überflüssige Tabellen/Felder gelöscht.

Nun geht man im Install Tool auf 3. Update Wizard und folgt dort unter changeCompatibilityVersion den Anweisungen. Das dient dazu, dass TYPO3 intern auch wie TYPO3 4.x arbeitet und ist sehr wichtig! Im letzten Schritt bestätigt man die Änderungen mit 3-Perform updates! nachdem man alle Häkchen gesetzt hat.

Nochmal unter 1: Basic Configuration kontrollieren, ob auch wirklich alles okay ist.

TYPO3 Backend: Referenz Index aufräumen

Im Backend wählt man links im Menü den Punkt DB Check (Gruppe Tools) aus, wählt aus dem Dropdownfeld Manage Reference Index aus und klickt auf Update now!. Damit werden die Referenzen aktualisiert.

Extension Manager

Nun ab in den Ext Manager (Menü-Gruppe Tools)! Oben im Dropdown (Menü:) ist Loaded Extensions zu wählen um die installierten Extensions anzuzeigen. Dort entfernt man die Extension German language pack (falls vorhanden), denn die braucht man jetzt nicht mehr ;-)

Nun aktualisiert man die vorhandenen Extensions:

Oben im Dropdown (Menü:) ist nun Settings auszuwählen, man setzt dort das Häkchen für Enable extensions without review (basic security check) und klickt unten auf Update.

Jetzt wählt man oben im Dropdownfeld (Menü:) auf Import extensions und klickt auf den Button Retrieve/Update- damit sollten nun Aktualisierungen zu den installierten Extensions angeboten werden; meiner Erfahrung nach funktioniert das nicht so, wie es soll ;-) Zur Not muss man dies also Händisch machen, indem man den Namen der Extension eingibt und Look up klickt. Ist die gesuchte Extension nicht im Repository, dann kann man sie auch auf http://typo3.org/extensions/ herunterladen und über Upload extension file directly hochladen und "drüberinstallieren" (Häkchen für Overwrite any existing extension setzen!).

Eindeutschen

Um das Backend wieder in gewohnter deutscher Sprache zu haben bleiben wir im Ext Manager. Dort wählt man nun oben Translation Handling, markiert in der Auswahlliste Deutsch (und ggf. andere gewünschte Sprachen), dann Save Selection und dann auf Update from repository. Schon wird die deutsche Sprache für TYPO3 heruntergeladen.

Cache nochmal leeren und es sollte nun alles wieder auf Deutsch sein :-)

Neues Layout gefällig?

Das Backend ist ja noch im trüben, braunen 3.8er Layout :-(

Aber das ist auch noch zu schaffen: Im Ext Manager aus dem Dropdown Install extensions auswählen, fast ganz unten ist die Extension TYPO3 skin (t3skin), die man durch einen Klick auf das zugehörige graue '+' installiert.

Caches leeren und das neue Layout sollte sich zeigen :-)

Glückwunsch

Die TYPO3 Installation ist nun up-to-date :-D

 

Kategorien
TYPO3-Tutorials
Suche