[Junior]

Diese Anleitung beschreibt, wie man eine bestehende TYPO3 Installation auf die neueste Version aktualisiert. Sie bezieht sich auf die Version 3.8.0, ist aber prinzipiell auch auf andere Versionen übertragbar.

Wichtiger Hinweis: diese Update Anleitung bezieht sich auf Unix/Linux Systeme mit Shellzugang. In Kürze wird diese Anleitung auf Hinweise zu Windows Installationen ergänzt.

Vorüberlegungen

Jetzt schon updaten?
Bei vielen Softwarepaketen gilt nach dem Erscheinen einer neuen Version: erst einmal abwarten, bis die gröbsten Fehler beseitigt sind! Bei TYPO3 Version 3.8.0 sind jedoch vor Freigabe umfangreiche Tests durchgeführt worden, ein Update zu einem frühen Zeitpunkt birgt daher nur wenige Risiken. Auch bei der Vorgängerversion 3.7.0 gabe es keine anschliessenden "Bugfix"-Updates. Kleinere Problemchen sind zwar nicht 100%ig auszuschließen, aber die neue Version hat sicherlich keine gravierenden Mängel.

Direktes Update 3.5.0 auf 3.8.0?
Grundsätzlich ist es empfehlenswert, die einzelnen Versionsschritte mitzumachen, statt das System jahrelang unverändert zu lassen. Neue Versionen bringen nicht nur neue Features, sondern bieten meist auch eine erhöhte Sicherheit. Daher kann sich ein Update auch dann lohnen, wenn keine neuen Funktionen genutzt werden. Prinzipiell ist ein direktes Update von einer Vor-Vorgänger Version (wie z.B. 3.5.0 oder 3.6.x) auf die Version 3.8.0 möglich. Je älter jedoch die bisher installierte Version ist, desto grösser ist die Wahrscheinlichkeit eventuell auftretender Probleme (da sich einfach viel mehr Dinge verändert haben).

Update von einer Version vor 3.7.0 auf 3.8.0
Mit Erscheinen der Version 3.7.0 wurden einige Änderungen in der Struktur der Extensions gemacht. Einige Extensions, die vorher z.B. global (in TYPO3/ext) oder lokal (in typo3conf/ext) installiert waren, sind jetzt System-Extensions (in TYPO3/sysext). Betroffen sind die folgenden Extensions

• aboutmodules
• context_help
• extra_page_cm_options
• func_wizards
• info_pagetsconfig
• install
• setup
• tsconfig_help
• wizard_crpages
• wizard_sortpages
• extrep_wizard (ersetzt durch "kickstarter")

Falls sich eine dieser Extensions (d.h. Verzeichnis mit diesem Namen) in den Ordnern typo3conf/ext oder TYPO3/ext befindet, muss das jeweilige Verzeichnis gelöscht werden. Weitere Informationen gibt es im TYPO3 Wiki (englisch).

Mögliche Probleme
Obwohl die neue Version vor der Freigabe ausgiebig getestet wurde, können im Einzelfall Probleme auftreten. Insbesondere bei Verwendung unsauber programmierter Extensions, die die offizielle Programmierschnittstelle (API) umgehen kann es zu Fehler kommen. Hier ist dann ein Update der jeweiligen Extension erforderlich. TYPO3 Erweiterungen, bei denen Probleme in Zusammenhang mit der Version 3.8.0 bekannt auftreten, werde ich künftig an dieser Stelle auflisten.

Probleme mit Extensions

gsi_whoisonline (V 0.3.1)

Fehlermeldung mit Version 3.8.0: "Filereference, "/.../typo3conf/ext/gsi_whoisonline/pi1/locallang.php", not found!"

Abhilfe: einfach eine leere Datei locallang.php im angegebenen Verzeichnis erstellen.

jh_random_records (V 0.0.7)
Diese Extension scheint mit 3.8.0 nicht zu funktionieren. Es wird nicht ein Datensatz aus der Liste angezeigt, sondern alle

Das ideale Update
Wer die Möglichkeit dazu hat. führt das Update zunächst an einer Kopie seines Projekts durch. Dann kann in Ruhe getestet werden, ob alles reibungslos funktioniert ohne den Livebetrieb zu stören. Ist alles ok, wird das Update am Livesystem durchgeführt. Das automatische Erstellen einer Kopie jede Nacht beschreibe ich in einem der nächsten Tutorials.

Was ist neu in der Version 3.8.0?
Eine detaillierte Liste der Änderungen gegenüber früheren Versionen ist im ChangeLog aufgelistet.
Erster Schritt: Backups erstellen

Auch wenn das Update auf eine neue TYPO3 Version meist reibungslos abläuft, sollte man für den Fall der Fälle trotzdem vorher unbedingt eine Datensicherung anlegen. Gesichert müssen neben den Dateien insbesondere die verwendete Datenbank.

Sichern der Datenbank
Prinzipiell kann die Datenbank über ein Tool wie phpmyadmin in eine Datei gesichert werden. Dies funktioniert jedoch nicht mit größeren Datenbanken (mehr als einige Megabyte). Mit dem Tool mysqldump können jedoch über die Kommandozeile (Eingabeaufforderung unter Windows bzw. Shell unter Unix/Linux) beliebig große Datenbanken in eine Datei gesichert werden. Die Befehlszeile lautet:

mysqldump --opt -h localhost -u username -ppasswort datenbankname > backup.sql

Die Parameter für Username, Passwort und Datenbankname müssen natürlich an die jeweilige Installation angepasst werden. Befindet sich die Datenbank auf einem anderen Server, muss statt 'localhost' die Adresse angegeben werden (z.B. db123.1und1.de oder eine IP-Adresse). Die Daten können der Seite 1 des Install-Tools von TYPO3 entnommen werden:

Eigentlich wäre es nicht nötig, auch die Dateien zu sichern: beim Update der TYPO3 Version werden die Dateien des Projekts (in den Verzeichnissen fileadmin, uploads, typo3conf) nicht verändert. Bei sorgfältiger Implementierung des Projekts werden auch keine Änderungen innerhalb des Verzeichnisbaums mit dem TYPO3 Quellcode vorgenommen. Diese Änderungen würden durch ein Update überschrieben. Dies gilt auch für die Templates, die bei global installierten Extensions mitgeliefert werden. Da mit dem Sourcecode auch einige globale Erweiterungen installiert werden, können (je nach Installation) diese Templates überschrieben werden. Wurden Änderungen direkt an diesen Vorlagen durchgeführt, gehen diese bei einem Update verloren. (Daher sollten Änderungen immer an Kopien von Templates durchgeführt werden, die unterhalb des fileadmin-Verzeichnisses liegen.)

Um auf Nummer sicher zu gehen, ist es ratsam, von allen Dateien ein Backup anzulegen.

Neuen Quellcode herunterladen
Der TYPO3 Quellcode ist auf www.sourceforge.net erhältlich. Am einfachsten ist es, den Code direkt auf den Zielserver herunter zu laden, ohne den Umweg über einen lokalen Rechner zu gehen. Dazu ist auf dem Server ein Shellzugang erforderlich. Zu den Downloadseiten gelangt man entweder über www.typo3.org oder direkt über die Dateiliste auf sourceforge. Für Unix/Linux Systeme mit Shellzugang wählt man die tar.gz-Datei, für Windows und Systeme ohne Shellzugang die ZIP Version.

Auswahl eines passenden Mirrors für den Download (MESH ist eine gute Wahl für Deutschland).

Jetzt wird der Pfad zur gewählten Datei angezeigt und der Download beginnt automatisch. Es reicht allerdings, wenn wir den Link kopieren und den Download abbrechen (bei Shellzugang).

Anschliessend über einen Shellzugang (z.B. mit Putty) einloggen und in das Verzeichnis wählen, in dem der neue Sourcecode als Unterverzeichnis installiert werden soll. Im Beispiel heisst das Verzeichnis typo3cms, darunter liegen auch die Verzeichnisse mit den eigentlichen Projekten.

wget mesh.dl.sourceforge.net/sourceforge/TYPO3/typo3_src-3.8.0.tar.gz

Ein paar Sekunden später befindet sich der gepackte Sourcecode auf dem Server.

Das Archiv kann jetzt mit dem folgenden Befehl entpackt werden, dabei wird automatisch ein neues Unterverzeichnis typo3_src-3.8.0 erstellt:

tar -xzf typo3_src-3.8.0.tar.gz

Hinweis: je nach Betriebssystem und Systemkonfiguration kann es erforderlich sein, die Rechte und Benutzergruppe für den TYPO3 Code anzupassen. (Bei den Managed Servern von 1&1 und Schlund ist dies nicht erforderlich). Die folgenden Kommandos können verwendet werden, um die Rechte auf 755 und die Gruppe auf www-data (d.h. die Gruppe, unter der auch der Webserver läuft) zu setzen:

chmod -R 755 typo3_src-3.8.0/ chgrp -R www-data ../typo3_src-3.8.0/

Anschliessend muss bei der Datei index.php im Verzeichnis typo3_src-3.8.0/typo3/install die Zeile 45 (mit der 'die'-Funktion) auskommentiert werden.

Wurde ein Backup angefertigt? Wenn nicht, dann ist jetzt die letzte Möglichkeit dazu!

Symlink ändern
Jetzt kommt einer der grossen Vorteile von Unix/Linux zum Tragen: durch die Änderung eines einzigen Symlinks sorgen wir dafür, dass unser TYPO3 Projekt ab jetzt den neuen Sourcecode verwendet. Standardmässig heisst dieser Symlink typo3_src und liegt im gleichen Verzeichnis wie das Quellcode Paket, das vorher heruntergeladen wurde.

Am einfachsten lässt sich der Symlink im Midnight-Commander (mc) mit der Tastenkombination CTLX-X-S ändern. Der bisherige Verweis auf das Verzeichnis typo3_src-3.7.0 wird geändert in typo3_src-3.8.0:

Falls der Midnight Commander nicht installiert ist, kann der alte Symlink mit folgenden Befehlszeilen gelöscht und neu angelegt werden:

rm typo3_src ln -s typo3_src-3.8.0 typo3_src

Ab diesem Zeitpunkt verwendet unser TYPO3 Projekt den neuen Quellcode. Im Frontend werden jetzt statt des gewohnten Inhalts nur noch Fehlermeldungen zu sehen sein - also rasch zu den nächsten Schritten:

Die neue Version bringt nur Fehlermeldungen...

Nun das Install-Tool aufrufen und dort den Menüpunkt 2 - "Database Analyzer". Dort bei "Update required tables" auf den Link "COMPARE" klicken.

Es folgt eine mehr oder weniger lange Liste von Änderungsvorschlägen. An deren Ende klicken wir auf den Button "Write to database" um die vorgeschlagenen Änderungen durchzuführen (es gibt doch ein Backup der Datenbank, oder?).

Anschliessend wird noch bei "Dump static data" ein IMPORT durchgeführt, um die Änderungen an den statischen Templates einzuspielen.

Die Checkbox "Import the whole file..." wird ausgewählt und anschliessend auf "Write to database" geklickt.

Jetzt sollte ein Login ins Backend möglich sein. Der Login-Bildschirm präsentiert sich im neuen Layout:

Nach dem Login muss der Cache sowie die Dateien temp_CACHED... im Verzeichnis typo3conf gelöscht werden. Dies geschieht über die beiden Links am unteren Ende des linken Menüs.

Wird ein Beschleuniger für PHP (z.B. der PHP Accelerator) eingesetzt, dann müssen auch dessen Cache-Dateien gelöscht werden. Bei den von mir durchgeführten Installationen befindet sich diese im Verzeichnis typo3cms/tools/php_accelerator/phpa_cache. Dort müssen die Rechte für alle Dateien beginnend mit phpa auf 777 gesetzt werden, anschliessend können sie gelöscht werden. Dazu wechselt man in das Verzeichnis phpa_cache und gibt die folgenden Befehle ein:

chmod 777 phpa* rm phpa*

Im Anschluss kann das Frontend der Webseite wieder aufgerufen werden, die Fehlermeldungen sollten verschwunden sein:

Es sollten jetzt natürlich noch alle Funktionen der Webseite überprüft werden. Falls zusätzliche Extensions global installiert waren, müssen die entsprechenden Verzeichnisse unter typo3_src-3.7.0/ext nach typo3_src-3.8.0/ext kopiert werden. Generell empfiehlt es sich, zusätzlich benötigte Extensions lokal statt global zu installieren, sie bleiben bei einem Update dann erhalten.

Mit der Version 3.8.0 hat sich die Installation der Sprachpakete für das Backend geändert. Mit dem Sourcecode wird nur noch das englischsprachige Benutzerinterface ausgeliefert. Weitere Sprachen müssen als Extension installiert werden. Der Name der Extension ist jeweils chs_ gefolgt vom ISO-Ländercode, also z.B. csh_de für die deutsche Sprache.

Wenn man schon mal beim Updaten ist, kann es sinnvoll sein, auch die verwendeten Extensions auf den neuesten Stand zu bringen. Hier sollte jedoch unbedingt vorher die Dokumentation der Erweiterung vorher gelesen werden, da nach einigen Updates (z.B. tt_news von Version 1.x auf 2.x) Änderungen am Typoscript Setup notwendig sind.

© www.jweiland.net