TYPO3 Umzugs-Tipps

Wenn Sie Ihr TYPO3-System von einem Server auf einen anderen übertragen wollen, empfiehlt es sich meistens, gleich mit der neuesten TYPO3-Version an den Start zu gehen, da man hier so oder so in das TYPO3-System eingreifen muss.

Backup, Backup, Backup

Erstellen Sie von beiden TYPO3-Systemen ein Backup. Wie Sie das anstellen, finden Sie hier. Wenn Sie Dateien in diesen Backups bearbeiten müssen kopieren Sie diese Datei zunächst an einen anderen Ort. Lassen Sie die Original-Dateien immer unberührt!

TYPO3-Systeme überprüfen

Viele Provider bieten eine automatische Installation eines TYPO3-Systems an, ohne dass man sich um die Voraussetzungen und einzelnen Schritte kümmern muss. Manch ein System lässt hierüber sogar ein TYPO3-Update zu. Das sollten Sie auch nutzen.

Schauen Sie  sich nun im Zielsystem die Verzeichnisse fileadmin/ und typo3conf/ an. diese sollten nur die Verzeichniss und Dateien enthalten, die bei einer neuen TYPO3-Installation vorhanden sind. Manche Provider empfehlen Ihnen hiermit u. U. TYPO3-Erweiterungen (im Verzeichnis typo3conf) oder Templates ( im Verzeichnis fileadmin/ ) an, die Ihnen den Überblick über Ihr TYPO3-System erschweren:

TYPO3-Dateien nach der Installation

<- So sieht eine "jungfräuliche" TYPO3-Installation aus.

Alle Verzeichnisse, die Sie nicht im linken Bild finden, können Sie löschen.
ABER VORSICHT!: Bitte löschen Sie nur die Verzeichnisse, die zusätzlich in den oben beschriebenen Verzeichnissen sind. Bitte keine Verzeichnisse im Stammverzeichnis löschen, diese enthalten manchmal systemrelevante Ordner!

Übertragung der Dateien in das TYPO3-Zielsystem

Nun können Sie damit beginnen, die Daten Ihres alten TYPO3-Systems auf den neuen Server zu übertragen. Hierbei übertragen Sie nur folgende Verzeichnisse vollständig:

fileadmin/*, typo3conf/ext/* und uploads/*

Aus dem Quellverzeichniss löschen Sie alle Dateien unter typo3temp/* - diese werden beim Aufrufen der neuen Seite neu erstellt. Wichtig ist hier, dass Sie nur die Dateien, nicht die Verzeichnisse löschen, denn die wenigsten Verzeichnisse werden hier automatisch erstellt. Wenn Sie sich hier nicht sicher sind, können Sie auch die Dateien mit übertragen, das kann bei älteren TYPO3-Systemen aber auch eine ganze Menge sein. Und wo wir gerade aufräumen...

Dann übertragen Sie, sofern vorhanden, wichtige Dateien aus dem TYPO3-Verzeichniss typo3conf/. Hierbei lassen Sie zunächst die Datei localconf.php außer Acht. Hier sind wichtige Information für das TYPO3-System enthalten, die Sie nicht verändern sollten. Im Verzeichnis typo3conf können z.B. die Konfigurations-Dateien für die TYPO3-Erweiterungen coolURI (CoolUriConf.xml) oder realURL (realurl_autoconf.php) sein. Alle Cache-Dateien können Sie hierbei löschen, diese beginnen immer mit "temp_CACHED_".

Die Datei typo3conf/localconf.php bzw. LocalConfiguration.php

Zum Schluß bearbeiten wir noch die Datei typo3conf/localconf.php (seit TYPO3-Version 6.0 heißt Sie ("LocalConfiguration.php"). Hierbei müssen Sie äußerst behutsam vorgehen, da hier wichtige Daten für das TYPO3-System gespeichert werden und schon ein Punkt oder Semikolon zuwenig oder zuviel das gesamte TYPO3-System lahm legen kann - Aber Sie habe ja ein Backup gemacht ;-) . Folgende Zeilen sollten Sie nicht verändern:

$typo_db = 'datenbank-name';
$typo_db_host = 'hostderdatenbank'; -> meist "localhost"
$typo_db_username = 'benutzerderdatenbank';
$typo_db_password = 'passwortdesdb-benutzers';

ab TYPO3-Version 6.0 sieht dieser Teil so aus:

'DB' => array(
   'database' => 'datenbank-name',
   'extTablesDefinitionScript' => 'extTables.php',
   'host' => 'hostderdatenbank',
   'password' => 'passwortdesdb-benutzers',
   'username' => 'benutzerderdatenbank',
),

Das sind die Einstellungen des Datenbankzugangs, und alle Zeilen, die mit
$TYPO3_CONF_VARS['GFX']...
beginnen oder unter "'GFX' => array(" stehen, hier sind Einstellungen des Datenbankzugangs und der Bildverarbeitung enthalten, die der Provider meist auf sein System abgestimmt hat. Insbesondere die Pfade zu Imagemagick kennt der Provider wohl am Besten ("$TYPO3_CONF_VARS['GFX']['im_path'] = '...';).

Außerdem sollten folgende Zeilen des neuen Systems erhalten bleiben:
$TYPO3_CONF_VARS['SYS']['encryptionKey'] = '...';
$TYPO3_CONF_VARS["SYS"]["compat_version"] = '...';
<- Die installierte TYPO3-Version)

Die Zeilen
$TYPO3_CONF_VARS['EXT']['extList'] = '...';
$TYPO3_CONF_VARS['EXT']['extList_FE'] = '...'
$TYPO3_CONF_VARS['EXT']['extList_BE'] = '...'

enthalten die installierten TYPO3-Erweiterungen für das TYPO3-Frontend und TYPO3-Backend, alle Zeilen, die mit
$TYPO3_CONF_VARS['EXT']['extConf']['...'] = '...';
beginnen, enthalten die jeweiligen Einstellungen der Erweiterung. Diese Zeilen sollten Sie aus der alten Konfigurationsdatei übernehmen. Wenn Sie in Ihrem System die Erweiterung realURL installiert haben, findet sich die Konfiguration vielleicht auch unter
$TYPO3_CONF_VARS['EXTCONF']['realurl']['_DEFAULT'] = array(....
und den folgenden Zeilen (Das können auch sehr viele sein - ich betreue u.a. TYPO3-Systeme, in denen es ca. 250 Zeilen sind), diese sollten Sie dann auf jeden Fall übernehmen.

Übertragung der Datenbank

Sehr wahrscheinlich müssen Sie die SQL-Datei des Quell-Systems noch bearbeiten, da die Domainen auf den beiden Systemen während eines Umzugs mit Sicherheit nicht die gleichen sind. Ich setzte hierfür seit langem erfolgreich die Methode "generelles Ersetzen" in einem Text-Editor ein. Vergleichen Sie die Domaine der Quellsystems mit der des neuen TYPO3-Systems und ersetzen jeweils die Teile zwischen "http://" und dem letzten "/":

Soll die alte Domaine auch mit umziehen, können Sie diese, nachdem Sie das neue TYPO3-System auf Herz und Nieren überprüft haben, mit einem Datenbank-Export - suchen & ersetzen in umgekehrter Reihenfolge - und Reimport auch wieder zurücksetzen.

Nun übertragen Sie die alte Datenbank z.B. mit dem vom Provider meist angebotenen phpmyadmin in das neue TYPO3-System. Da Sie hiermit auch die Backend-User des alten Systems übertragen, müssten Sie sich nun in das neue Backend einloggen können.

Letzte Arbeitsschritte im TYPO3-Backend

Wenn Sie sich nun im neuen TYPO3-Backen mit Ihrem Account aus dem alten TYPO3-System anmelden können haben Sie alles richtig gemacht.

Herzlichen Glückwunsch!

Nun kommen aber noch ein paar wichtige Schritte, denn Ihr neues Frontend wird Sie (noch) alles andere als glücklich machen.

Als erstes löschen Sie den gesamten Cache des neuen TYPO3-Systems .

Dann müssen Sie noch die Datenbank an das neue System anpassen. Dazu erstellen Sie zunächst die Datei, die Sie in das Installations-Tool lässt mit dem Modul "Benutzerwerkzeuge/Einstellungen" unter dem Reiter "Adminfunktionen". Dort gibt es den Button "Aktivierungsdatei für Installationsprogramm erstellen", den Sie bitte klicken. Jetzt können Sie sich im Installtool einloggen und sollten mit dem "Upgrade Wizard " erst das System auf den neuesten Stand bringen. Folgen Sie hierzu den einzelnen Schritten, die Ihnen dort angeboten werden und führen Sie am Ende den Database Compare durch. Löschen Sie danach nochmal die Cache-Tabellen der Datenbank mit "Clear Tables"

Nun sollten Sie noch die TYPO3-Erweiterungen updaten. Das können Sie im "Extension Manager" mit folgenden Schritten tun:

  1. laden Sie mit "Import extensions" und "Retrieve/Update" die Liste der aktuellen TYPO3-Erweiterungen herunter - das kann etwas dauern. Erst wenn dort "Extension list updated" steht ist die Liste aktuell und Sie können mit
  2. "Check for Extension updates" Ihre Erweiterungen mit der aktuellen Liste vergleichen. Sollte bei der ein oder anderen TYPO3-Erweiterung unter "Hochladeanmerkung" etwas ähnliches wie "Security fix" stehen, sollten Sie diese auf jeden Fall aktualisieren. Steht dort etwas wie "TYPO3 4.X compatibility release" und geht es hier um Ihre neue TYPO3-Version ist ein Update auch auf jeden Fall zu empfehlen, da die Erweiterung ansonsten nicht richtig funktioniert. Alle anderen Erweiterungen können so bleiben wie sie sind, es sei denn Sie möchten die dort neu implementierten Funktionen auch nutzen.
  3. Eine tatsächliches Update einer TYPO3-Erweiterung führen Sie mit einem Klick auf den Erweiterungsnamen und einem anschließenden Klick auf "Import/Update" aus. folgen Sie hier den Ihnen angebotenen Schritten.
  4. Last but not least ist noch ein Update der Sprachdateien der TYPO3-Erweiterungen zu empfehlen. Diese finden Sie unter "Translation handling" Klicken Sie solange auf "Update from repository" bis in der darunter aufgeführten Liste woüberall entweder "Could not fetch translation status", "not available" oder "updated" steht. Dann sind auch alle Übersetzungs-Dateien auf dem neuesten Stand.

Sie haben zu diesem Artikel Fragen oder Anregungen? Dann zögern Sie nicht mich hier zu kontaktieren.

Sie möchten mit Ihrem TYPO3-System umziehen und möchten das lieber einem Profi überlassen? Hier können Sie Kontakt zu mir aufnehmen oder lassen Sie uns darüber telefonieren unter +49 40 4327 3227

Einen ähnlichen Artikel habe ich hier gefunden. Wenn Ihnen diese Vorgehensweise eher zusagt, steht Ihnen dies natürlich frei.