Serverumzug Contao 3 Installation
- 3.5
Hinweis
Dieser Blogartikel bezieht sich auf Contao 3, diese Version ist veraltet und erhält keinen Support mehr. Falls du noch eine Installation mit Contao 3 (oder einer älteren Version) hast, solltest du unbedingt ein Update durchführen. Informationen zum Update findest du in unseren Online-Kursen oder in der offiziellen Contao-Dokumentation.
Spezielle Hinweise für das Update von Contao 3 auf Contao 4 erhältst du in unserem Blogbeitrag "Update Contao 3 auf Contao 4."
Videoanleitung
Hinweis: Umzung von Contao 4
Dieses Tutorial bezieht sich auf den Umzug einer Contao 3 Installation. Unter Contao 4 musst du etwas anders vorgehen. Wie das geht, erfährst du Schritt für Schritt in unserem Contao 4 Basiskurs oder in der offiziellen Contao-Handbuch.
1. Systemwartung durchführen
Bevor du mit dem eigentlichen Umzug deiner Contao Installation startest, solltest du eine Systemwartung durchführen. Hiermit reduzieren wir die Datenmenge der Datenbank und löschen nicht benötigte temporäre Cache-Dateien.
Zum Ausführen der Systemwartung loggst du dich im Backend ein und wählen unter System, den Menüpunkt Systemwartung. Hier wählen wir bei Daten bereinigen die Checkbox "alles auswählen" und klicken dann auf den Button Daten bereinigen. Normalerweise musst du nicht unbedingt alles bereinigen, aber so ist erst einmal alles aufgeräumt. (Abbildung 1)
Hinweis: Durch die Bereinigung wird der Suchindex gelöscht. Dieser muss nach dem Umzug entweder manuell über die Systemwartung neu erzeugt werden oder es geschieht automatisch im Hintergrund durch den Aufruf der einzelnen Seiten.
2. Datenbank exportieren
Es gibt mehrere Möglichkeiten und die Datenbank zu exportieren. Hier erfährst du den Weg über das Tool phpMyAdmin, da es eigentlich bei jedem Hosting verfügbar ist.
Logge dich nun beim phpMyAdmin ein und wähle die korrekte Datenbank aus, in der Contao installiert ist.
Nun wählst du den Menüpunkt Exportieren und als Exportmethode "Schnell – nur notwendige Optionen anzeigen" aus. Bei älteren phpMyAdmin-Versionen kann es sein, dass die Methode "Schnell" nicht verfügbar ist, dann kannst du diese Einstellungen nutzen.
Speichere die SQL-Datei lokal ab. Du benötigst das Backup für den Import auf dem Zielserver.
3. Download Dateien
Wenn du eine lokale Contao-Installation nutzt, kannst du diesen Schritt überspringen. Beim Umzug auf einen anderen Webserver musst du zunächst alle Dateien herunterladen. Dazu verwendest du ein FTP-Programm (z. B. FileZilla).
Wichtig: Du solltest die komplette Installation von Contao mit allen Ordnern und versteckten Dateien herunterladen. Je nach Größe der Installation kann das ein paar Minuten dauern.
Tipp: Einige Hoster bieten ein WebFTP-Tool an. Damit kannst du eine komplette ZIP-Datei der Installation erzeugen, wodurch dein Download beschleunigt wird und es zu weniger Fehlern kommt.
4. Dateien auf neuen Server übertragen
Nun verbindest du dich per FTP mit deinem neuen Server und lädst deine komplette Contao-Installation hoch. Je nach Internetverbindung kann das etwas Zeit in Anspruch nehmen.
Wenn deine Contao-Dateien erfolgreich übertragen sind, kann es bei manchen Hostern nötig sein, die Berechtigungen der Dateien anzupassen. Wie das geht, erfährst du beim Support deines Anbieters.
Tipp: Bei manchen Hostern kannst du direkt die ZIP-Datei hochladen und über ein WebFTP entpacken. Das spart Zeit und reduziert Übertragungsfehler.
5. Datenbank importieren
Zusätzlich zu den Dateien benötigen wir noch unsere Datenbank. Erstelle dazu auf dem Zielserver eine neue Datenbank für Contao. Nun importieren wir mit dem Tool phpMyAdmin unsere vorher exportierte SQL-Datei.
Wählen dazu die neue leere Datenbank aus und klicken auf den Menüpunkt Importieren. Anschließend wählst du deinen lokalen SQL-Dump aus und startest den Import.
Nach erfolgreichem Import der Datenbank kannst du den phpMyAdmin schließen.
6. Datenbankverbindung anpassen
Da sich beim Umzug die Zugangsdaten zur Datenbank verändert haben, müssen wir nun die Datenbankverbindung anpassen. Dazu öffnest du das Contao-Installtool (/contao/install.php). Das Passwort für das Installtool hat sich nicht geändert.
Nun trägst du deine neuen Zugangsdaten für die Datenbank ein.
7. Umzug abgeschlossen
Der Umzug ist damit abgeschlossen, und du kannst dich jetzt ins Backend von Contao einloggen.
Bei Problemen kannst du versuchen, die Caches über die Systemwartung zu leeren. Überprüfe zudem die Berechtigungen auf dem Dateisystem und stelle sicher, dass du die gleiche PHP-Version verwendest. Manchmal kann es auch vorkommen, dass Dateien fehlerhaft übertragen oder versehentlich übergangen wurden.
Möchtest du über neue Artikel informiert werden?
Dann trage hier deine E-Mailadresse ein und klicke auf „Abonnieren". Du erhältst regelmäßig aktuelle Infos über Contao und die Contao-Academy.
Über den Autor
Christian Feneberg ist der Initiator und Dozent der Contao Academy. Er bringt über 15 Jahre Praxiswissen in der professionellen Umsetzung von Contao-Websites mit. Zudem ist er Teil des Teams von trakked.io. Er liebt es, sich neues Wissen anzueignen und es weiterzugeben. Abseits des Bildschirms verbringt er am liebsten Zeit mit seiner Familie und in der Natur.
Folge Christian jetzt bei LinkedIn.
1 Kommentare
gusedesign
Danke für den tollen Beitrag. In meinem Fall muss ich noch die Domain ändern. Wenn ich über die neue Domain das Contao-Installtool aufrufe, leitet das Tool leider auf die alte Domain weiter und führt durch das Contao-Installtool aus. Wie kann ich das umgehen?
Liebe Grüße,
Hannes
Hallo Hannes,
evtl. hast du noch einen falschen Eintrag in der .htaccess-Datei.
Oder dein Browser hat noch irgendetwas im Cache.
Hast du schon mal zum Test den Cache geleert?
Einen Kommentar schreiben