TYPO3 Umzugs-Tipps

Wenn Sie Ihr TYPO3-System von einem Server auf einen anderen übertragen wollen, empfiehlt es sich meistens, gleich ein Update des TYPO3-Systems mit einzuplanen, da man hier so oder so in das TYPO3-System eingreifen muss.

Das Quell-System herunterladen

Zunächst laden Sie das Quellsystem mit einem geeigneten FTP-Programm herunter. Wenn Sie auf dem Zielsystem bereits das neue TYPO3-System installiert haben, brauchen Sie nur die Verzeichnisse "/fileadmin", "/typo3conf" und "/uploads", sowie alle Dateien im Stamm- oder Root-Verzeichnis (meist sind das die Dateien ".htaccess", "robots.txt" und evtl. z.B. eine "google.....html".

Aber auch auch diesen Verzeichnissen brauchen Sie nicht unbedingt alle Dateien.
Im Verzeichnis "fileadmin" befindet sich auch ein Verzeichnis "_processed_". Hier sind alle von TYPO3 skalierten Bilder gespeichert. Je nach Webseite können das sehr viele Dateien sein. In Verbindung mit der Datenbank-Tabelle "sys_file_processedfile" kann hier die Gelegenheit zum Aufräumen genutzt werden.
Das Verzeichnis "typo3conf" enthält unter "l10n" alle Übersetzungen der einzelnen Erweiterungen. Diese können Sie im TYPO3-Backend mit "Adminwerkzeuge/Sprachen" jederzeit aktualisieren.
Wenn Sie noch resoluter aufräumen wollen, können Sie im Quellsystem unter Erweiterungen nachsehen, welche Erweiterungen, die unter "typo3conf/ext/" liegen, vielleicht deaktiviert sind (Wenn kein grüner "Klotz" neben dem Namen erscheint). Diese Erweiterungen können Sie am Besten im Erweiterungsmanager sauber löschen. Aber falls Sie sich hier nicht sicher sind, machen Sie das lieber auf dem Zielsystem, solange die "Alte" Seite noch aktiv ist.
Last but not Least liegen im Verzeichnis "uploads/*" von jeder Erweiterung, die es in Ihrer Konfiguration verlangt, je ein Verzeichnis. Wenn Sie dort auch Verzeichnisse mit sehr alten Erstellungsdaten sehen ist das zumindest schon mal ein Indiz für eine veraltete Erweiterung. Hier solten Sie sich aber sicher sein, dass die Erweiterung wirklich nicht mehr existiert.

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/ext) oder Templates ( im Verzeichnis fileadmin/ ) an, die Ihnen den Überblick über Ihr TYPO3-System erschweren:

TYPO3-Umzug

<- 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 alles unter typo3temp/*. Alle Verzeichnisse und Dateien in diesem Verzeichniss werden beim Aufrufen des TYPO3-Backends und -Frontends automatisch erzeugt. Um diesen Prozess zu beschleunigen, können Sie diese auch im InstallTool unter "Folder structure" erstellen lassen.

Dann übertragen Sie, sofern vorhanden, wichtige Dateien aus dem TYPO3-Verzeichniss typo3conf/. Hierbei lassen Sie zunächst die Datei LocalConfiguration.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.

Die Datei typo3conf/LocalConfiguration.php

Zum Schluß bearbeiten wir noch die Datei typo3conf/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 erst auf dem Zielsystem verändern:

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

Wenn Sie TYPO3 manuell installiert haben, tragen Sie hier die Zugangsdaten zur neuen Datenbank ein.
Das sind die Einstellungen des Datenbankzugangs, und alle Zeilen, die mit 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 ("'im_path' => '...',).

Außerdem sollten folgende Zeilen des neuen Systems erhalten bleiben:

 'SYS' => [
        [....]
        'encryptionKey' => '....',
        [...]
    ],
Der Abschnitt
'EXT' => [
        'extConf' => [
...

        ],
    ],
zusammen mit der Datei "PackageStates.php"

enthält die installierten TYPO3-Erweiterungen und deren Einstellungen für das TYPO3-Frontend und TYPO3-Backend, die Sie im Erweiterungsmanager vornehmen können. Diese Zeilen sollten Sie aus der alten Konfigurationsdatei ü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.