Typo3 Upgrade in mehreren Schritten

TYPO3-Upgrade mehreren Schritten

Wenn eine neue TYPO3-Version erscheint, sollten zunächst die nachfolgenden Upgrade-
Informationen, sowie der “changelog” der vorliegenden, neuen TYPO3-Version, aufmerksam
gelesen werden. Es kann sein, dass ein neuer Bestandteil Auswirkungen auf die Arbeitsweise
der Internetseite hat. Zeilen, die mit “!!!” gekennzeichnet sind, sind besonders wichtig und
sollten deswegen unbedingt beachtet werden.
Generell sind die folgenden Schritte zum Upgrade einer TYPO3-Internetseite notwendig:

1. Backup
2. Den neuen Quellcode installieren
3. Die Datenbank vergleichen und ein Update durchführen
4. Installation der neuen statischen Tabellen
5. Cache leeren
6. “temp_CACHED_”-Dateien entfernen
7. “Changelog” beachten

Bevor Sie Ihr eigenes Upgrade starten sollten Sie diese Anleitung zuvor komplett gelesen
haben!

1. Backup
Erstellen Sie zunächste ein Backup der beiden “/uploads”-Verzeichnisse und der Datenbank.
Es besteht natürlich auch die Möglichkeit zuerst ein Upgrade mit einer Kopie seiner
Internetseite durchzuführen. Dies bietet sich in erster Linie dann an, wenn es viele
Änderungen in der neuen TYPO3-Version gibt und diese mit der eigenen Internetseite zu
Störungen führen könnten. Beachten Sie hierbei den “changelog” der neuen Version.

2. Den neuen Quellcode installieren
An dieser Stelle werden die Quellcode-Dateien der alten Version durch die der neuen ersetzt.
Wenn Sie eine tgz-Veröffentlichung bzw. Version verwenden, dann beachten Sie bitte diesen
Artikel. Sollten Sie die zip-Veröffentlichung bzw. -Version von TYPO3 verwenden, dann
überschreiben Sie die folgenden Dateien und Verzeichnisse: “media/”, “t3lib/”, “tslib/”,
“typo3/”, “index.php” and “showpic.php”.

3. Die Datenbank vergleichen und ein Update durchführen
Besuchen Sie als nächstes unter “../typo3/install” das Installations-Werkzeug Ihrer TYPO3-
Internetseite.
Klicken Sie dort auf “Database Analyser” und prüfen Sie, ob die Datenbankeinstellungen
korrekt sind (siehe oben).
Klicken Sie dann auf “COMPARE” neben “Update required tables”:
Hierbei werden alle “tables.sql”-Dateien von TYPO3 selbst, sowie von den Extensions,
ausgelesen und mit den aktuellen Tabellen und Feldern der Datenbank verglichen. Sämtliche
Abweichungen werden aufgezeigt und Sie können mit Hilfe von SQL-Abfragen Ihre
Datenbank passend zur neuen TYPO3-Version umstrukturieren.
Achtung: Achten Sie bitte darauf, dass Sie willentlich Felder und/oder Tabellen in Ihre
Datenbank hinzugefügt haben könnten! Diese Tabellen und Felder werden natürlich nur
gelöscht, wenn Sie diese zum löschen markieren. Allerdings müssen Sie aufpassen, dass Sie
diese nicht übersehen!

Entfernen Sie unbenutzte Felder und Tabellen, wenn Sie möchten und klicken Sie auf “Write
to database”.
Auf jeden Fall werden die Felder und Tabellen, die Sie löschen wollten, zuerst umbenannt.
Nun können Sie entscheiden, ob Sie sie vorerst beibehalten und später, wenn Sie sicher sind,
dass Sie sie nicht mehr benötigen, löschen oder direkt.
Am Ende sollten Sie das sehen:
Achtung! Wie bereits oben erwähnt, könnten Sie selbst u.U. eigene Felder und/oder Tabellen
in die Datenbank inplementiert haben. Löschen Sie diese (natürlich) nicht!
Erfahrende TYPO3-Entwickler benennen Ihre Felder/Tabellen zur besseren Identifizierung
u.a. bei Upgrades mit dem Präfix “user_”. TYPO3 erkennt diesen Präfix und zeigt beim
Upgrade ein kleines Warnzeichen, so dass Sie einfacher entscheiden können, ob die Felder
oder Tabellen entfernt werden sollen oder nicht.
Tabellen, die von Extensions definiert und verwaltet werden, werden automatisch behandelt.
Sie brauchen sich also nicht um diese zu kümmern.

4. Installation der neuen statischen Tabellen
Die Tabelle “static_template” (und auch andere “static_”-Tabellen) enthalten Informationen,
die Sie niemals manuell ändern sollten, weil diese explizite Informationen der TYPO3-
Versionen enthalten. Folgen Sie den folgenden Schritten, um die Tabelle(n) auf den
aktuellsten Stand zu bringen.
Kehren Sie zurück zum “Database Analyser” und klicken Sie dort auf “IMPORT” neben
“Dump static data”:
Aktivieren Sie die Checkbox “Import the whole file […]” und klicken Sie dann auf “Write to
database”.
… jetzt sollten Sie etwa folgendes sehen (wenn keine Fehler aufgetreten sind):

5. Cache leeren
Auf jeden Fall müssen Sie die Cache-Tabellen leeren. Dies bewerkstelligen Sie durch den
Link “Clear cache tables” (siehe oben) im “Database analyser”.
Desweiteren sollten Sie die “backend user preferences” leeren, falls dies für das Upgrade
notwendig sein sollte. Wir empfehlen Ihnen jedoch diesen Punkt auf jeden Fall zu erledigen.

6. “temp_CACHED_”-Dateien entfernen
Im Verzeichnis “typo3conf/” finden Sie zwischengespeicherte Dateien für die Dateien
“ext_localconf.php” und “ext_tabels.php” der Extensions. Diese zwischengespeicherten
Dateien müssen auch entfernt werden.
Also entfernen Sie als nächstes alle Dateien im Verzeichnis “typo3conf/”, die
“temp_CACHED_*_ext_localconf.php” oder “temp_CACHED_*_ext_tables.php” heißen.
Der einfachste Weg dies zu erledigen ist der, dass Sie im Backend einfach auf den Link
“Clear cache files in typo3conf/” klicken:
Auf jeden Fall sollten Sie das Verzeichnis “typo3conf/” auf Rückstände kontrollieren. Es
müssen alle “temp_CACHED”-Dateien gelöscht werden.

7. “Changelog” beachten
Beachten Sie – am besten bevor Sie ein Upgrade durchführen – den “Changelog” der neuen
TYPO3-Version, damit Sie sehen, welche Funktionalitäten, Felder, Tabellen und/oder Dateien
für Sie von Interesse sein können.
Beachten Sie besonders die Punkte, die mit “!!!” beginnen. Diese sind wichtig, da sie einen
erheblichen Effekt auf die Internetseite haben können!