Ein Serverwechsel kann sich anfühlen wie der Umzug in ein neues Haus: Aufregend, aber auch voller potenzieller Fallstricke. Besonders wenn es um Ihr geschätztes MediaWiki geht – sei es ein internes Wissensportal, eine Community-Plattform oder ein öffentliches Wiki – möchten Sie, dass der Übergang so reibungslos und stressfrei wie möglich verläuft. Niemand möchte Ausfallzeiten, Datenverlust oder frustrierte Benutzer. Doch keine Sorge! Mit der richtigen Planung und einer detaillierten Schritt-für-Schritt-Anleitung wird Ihr MediaWiki Umzug zu einem Spaziergang. Dieser Artikel führt Sie durch alle Phasen eines erfolgreichen Serverwechsels, von der Vorbereitung bis zum Go-Live und darüber hinaus.
Warum ein Serverwechsel für MediaWiki?
Es gibt viele Gründe, warum Sie Ihr MediaWiki auf einen neuen Server umziehen möchten. Vielleicht ist der aktuelle Server zu langsam, überlastet oder erreicht das Ende seiner Lebensdauer. Möglicherweise benötigen Sie mehr Speicherplatz, eine bessere Performance für wachsende Benutzerzahlen oder erweiterte Sicherheitsfunktionen. Vielleicht wechseln Sie auch den Hosting-Anbieter, um Kosten zu sparen oder von besseren Supportleistungen zu profitieren. Unabhängig vom Grund ist das Ziel immer dasselbe: Eine minimale Beeinträchtigung des Betriebs und die Bewahrung Ihrer wertvollen Inhalte.
Phase 1: Die akribische Vorbereitung – Das A und O eines stressfreien Umzugs
Eine gute Vorbereitung ist die halbe Miete. Nehmen Sie sich ausreichend Zeit für diesen Schritt. Er wird Ihnen später viel Ärger ersparen.
1.1 Bestandsaufnahme der aktuellen Umgebung
Bevor Sie etwas anfassen, dokumentieren Sie detailliert Ihre aktuelle MediaWiki-Installation. Dazu gehören:
- MediaWiki-Version: Welche Version ist aktuell installiert?
- PHP-Version: Welche PHP-Version wird verwendet?
- Datenbank-System und Version: MySQL, MariaDB oder PostgreSQL? Welche Version?
- Webserver: Apache oder Nginx?
- Erweiterungen (Extensions) und Skins: Eine Liste aller installierten und aktivierten Erweiterungen und verwendeten Skins. Notieren Sie auch deren Versionen.
- Serverkonfiguration: Besonderheiten in der Apache/Nginx-Konfiguration (.htaccess, Virtual Host-Konfiguration), PHP-Einstellungen (php.ini, z.B. memory_limit, max_execution_time).
- Dateipfade: Absolute Pfade zu Ihrem MediaWiki-Verzeichnis und dem
images
-Verzeichnis.
Diese Informationen sind entscheidend, um die Kompatibilität auf dem neuen Server sicherzustellen und potenzielle Probleme frühzeitig zu erkennen.
1.2 Das essenzielle Backup – Ihr Rettungsanker
Dies ist der wichtigste Schritt im gesamten Prozess! Erstellen Sie ein vollständiges Backup Ihrer MediaWiki-Installation. Ein Backup schützt Sie vor Datenverlust, falls während des Umzugs etwas schiefgeht. Es besteht aus drei Hauptkomponenten:
- Datenbank-Backup: Exportieren Sie Ihre MediaWiki-Datenbank vollständig. Nutzen Sie Tools wie
mysqldump
(für MySQL/MariaDB) oder die Exportfunktion von phpMyAdmin.mysqldump -u [username] -p [datenbankname] > mediawiki_backup.sql
Geben Sie dabei das Passwort ein, wenn Sie dazu aufgefordert werden.
- Dateien-Backup: Kopieren Sie Ihr gesamtes MediaWiki-Verzeichnis. Dazu gehören die Core-Dateien, die
LocalSettings.php
, alle hochgeladenen Bilder und Dateien (imimages/
-Verzeichnis) sowie Ihre Erweiterungen und Skins. Komprimieren Sie das Verzeichnis am besten zu einer ZIP- oder Tar-Datei.tar -czvf mediawiki_files_backup.tar.gz /pfad/zum/mediawiki
LocalSettings.php
: Diese Datei ist das Herzstück Ihrer Konfiguration. Sichern Sie sie gesondert und überprüfen Sie darin, ob absolute Pfade verwendet werden, die auf dem neuen Server angepasst werden müssen.
Überprüfen Sie nach dem Backup die Integrität der Dateien. Versuchen Sie, die Datenbank und einige Dateien lokal zu entpacken, um sicherzustellen, dass sie nicht beschädigt sind.
1.3 Planung der neuen Umgebung
Basierend auf Ihrer Bestandsaufnahme richten Sie den neuen Server ein. Idealerweise sollte die neue Umgebung (PHP-Version, Datenbank-Version, Webserver) der alten entsprechen oder eine kompatible, neuere Version sein, um Inkompatibilitätsprobleme zu vermeiden. Installieren Sie die notwendigen Abhängigkeiten wie GD Library, XML Parser etc., die von MediaWiki und Ihren Erweiterungen benötigt werden.
1.4 Kommunikation und Zeitplan
Informieren Sie Ihre Wiki-Benutzer frühzeitig über den geplanten Umzug und mögliche (kurze) Ausfallzeiten. Legen Sie einen detaillierten Zeitplan fest, idealerweise zu Zeiten geringer Nutzung, um die Auswirkungen zu minimieren.
Phase 2: Der Umzug im Detail – Schritt für Schritt zur neuen Heimat
Jetzt geht es ans Eingemachte. Führen Sie die folgenden Schritte sorgfältig aus.
2.1 Einrichtung des neuen Servers
Stellen Sie sicher, dass Ihr neuer Server die notwendige Software installiert und konfiguriert hat:
- Betriebssystem: Meist Linux (Ubuntu, CentOS).
- Webserver: Apache oder Nginx. Konfigurieren Sie den Virtual Host für Ihre Domain und stellen Sie sicher, dass PHP richtig integriert ist.
- PHP: Installieren Sie die zuvor ermittelte oder eine kompatible PHP-Version und alle erforderlichen PHP-Erweiterungen (z.B.
php-mysql
,php-curl
,php-mbstring
,php-gd
,php-xml
,php-intl
). - Datenbank: Richten Sie MySQL/MariaDB oder PostgreSQL ein und erstellen Sie eine neue, leere Datenbank sowie einen Benutzer mit entsprechenden Berechtigungen für MediaWiki. Notieren Sie sich den Datenbanknamen, Benutzernamen und das Passwort.
2.2 Übertragung der Daten
Nun verschieben Sie Ihre gesicherten Daten auf den neuen Server.
- Datenbankimport: Importieren Sie die zuvor exportierte SQL-Datei in die neue, leere Datenbank.
mysql -u [username] -p [datenbankname] < mediawiki_backup.sql
Oder nutzen Sie die Importfunktion von phpMyAdmin.
- Dateien übertragen: Entpacken Sie Ihr gesichertes Dateiverzeichnis in das gewünschte Verzeichnis auf dem neuen Server. Achten Sie darauf, dass der Webserver (z.B. Benutzer
www-data
oderapache
) Lese- und Schreibrechte für das MediaWiki-Verzeichnis und insbesondere für dasimages/
-Verzeichnis hat. Korrigieren Sie gegebenenfalls die Berechtigungen mitchmod
undchown
.chown -R www-data:www-data /pfad/zum/mediawiki
chmod -R 755 /pfad/zum/mediawiki
chmod -R 777 /pfad/zum/mediawiki/images
(Letzteres ist wichtig, damit MediaWiki Bilder schreiben kann, aber 755/775 ist oft ausreichend und sicherer.)
2.3 Konfiguration auf dem neuen Server
Jetzt muss MediaWiki wissen, wo es sich befindet und wie es mit der Datenbank kommuniziert.
LocalSettings.php
anpassen: Kopieren Sie Ihre gesicherteLocalSettings.php
in das Hauptverzeichnis Ihrer MediaWiki-Installation auf dem neuen Server. Öffnen Sie die Datei und passen Sie folgende Parameter an:$wgDBserver
,$wgDBuser
,$wgDBpassword
,$wgDBname
: Aktualisieren Sie diese auf die neuen Datenbankzugangsdaten.$wgScriptPath
: Falls sich der Pfad auf dem Server ändert (z.B. von/var/www/html/wiki
zu/var/www/wiki
).$wgUploadDirectory
und$wgUploadPath
: Überprüfen Sie die Pfade zu Ihremimages/
-Verzeichnis und passen Sie sie gegebenenfalls an die neue Serverstruktur an.$wgServer
: Aktualisieren Sie dies auf die neue Domain (z.B."https://www.ihredomain.de"
).- Caching: Überprüfen Sie die Caching-Einstellungen, besonders wenn Sie ein fortgeschrittenes Caching wie Memcached oder Redis nutzen.
- Webserver-Konfiguration: Stellen Sie sicher, dass Ihre Webserver-Konfiguration (z.B. Apache
.htaccess
oder Nginx-Konfigurationsdateien) korrekt ist, insbesondere für URL-Rewriting (Permalinks), falls Sie suchmaschinenfreundliche URLs nutzen.
2.4 Testen, Testen, Testen!
Bevor Sie Ihre DNS-Einstellungen ändern, ist es unerlässlich, das MediaWiki auf dem neuen Server ausgiebig zu testen. Da Ihre Domain noch auf den alten Server zeigt, müssen Sie einen Workaround finden:
- Hosts-Datei bearbeiten: Bearbeiten Sie die Hosts-Datei auf Ihrem lokalen Computer (
C:WindowsSystem32driversetchosts
unter Windows oder/etc/hosts
unter Linux/macOS). Fügen Sie eine Zeile hinzu, die Ihre Domain auf die IP-Adresse des *neuen* Servers verweist:[IP_des_neuen_Servers] ihredomain.de www.ihredomain.de
Speichern Sie die Datei und leeren Sie Ihren DNS-Cache (
ipconfig /flushdns
unter Windows,sudo killall -HUP mDNSResponder
unter macOS). - Umfassende Prüfung: Rufen Sie Ihr Wiki im Browser auf.
- Funktionieren alle Seiten?
- Sind Bilder sichtbar? Funktionieren Uploads?
- Können Sie sich anmelden, bearbeiten, speichern?
- Funktionieren alle Erweiterungen?
- Gibt es fehlerhafte Links oder Weiterleitungen?
- Überprüfen Sie die PHP-Fehlerprotokolle des Servers für eventuelle Fehlermeldungen.
Beheben Sie alle aufgetretenen Fehler. Erst wenn Sie absolut sicher sind, dass alles einwandfrei funktioniert, gehen Sie zum nächsten Schritt über.
Phase 3: Der Go-Live und die Nachbereitung
Der Moment der Wahrheit ist gekommen!
3.1 DNS-Umstellung
Melden Sie sich bei Ihrem Domain-Registrar oder Hosting-Anbieter an und ändern Sie die A-Record-Einträge Ihrer Domain so, dass sie auf die IP-Adresse des *neuen* Servers zeigen. Die DNS-Umstellung kann einige Zeit in Anspruch nehmen (bis zu 24-48 Stunden, sogenannte DNS-Propagation), bis die Änderungen weltweit wirksam sind. Während dieser Zeit können einige Benutzer noch auf den alten Server geleitet werden.
Um Dateninkonsistenzen während der Propagation zu vermeiden, setzen Sie Ihr Wiki auf dem alten Server während dieser Übergangsphase in den Nur-Lese-Modus (durch Hinzufügen von $wgReadOnly = 'Umzug';
in der LocalSettings.php
des alten Wikis). Sobald der DNS-Cache auf Ihrem System aktualisiert ist (entfernen Sie den Eintrag aus Ihrer Hosts-Datei!), sollte Ihr Browser Sie auf den neuen Server leiten.
3.2 Abschließende Überprüfung
Sobald die DNS-Propagation abgeschlossen ist, überprüfen Sie Ihr MediaWiki erneut gründlich. Fordern Sie Freunde oder Kollegen auf, Ihre Website zu besuchen und die Funktionalität zu testen, um sicherzustellen, dass aus verschiedenen Netzwerkperspektiven alles reibungslos läuft.
3.3 Monitoring und alter Server
Behalten Sie die Performance und die Fehlerprotokolle des neuen Servers in den ersten Tagen genau im Auge. Erst wenn Sie sicher sind, dass der Umzug erfolgreich und stabil war, können Sie den alten Server abschalten oder löschen. Behalten Sie das alte Backup noch für eine gewisse Zeit als zusätzliche Sicherheitsebene.
Häufige Fallstricke und Tipps für den reibungslosen Ablauf
Selbst mit bester Planung können Probleme auftreten. Hier sind einige häufige Fallstricke und wie Sie sie vermeiden:
- Inkompatible PHP- oder Datenbank-Versionen: Stellen Sie sicher, dass die Versionen auf dem neuen Server mit Ihrer MediaWiki-Version und den Erweiterungen kompatibel sind. Ein Update von MediaWiki *vor* dem Umzug kann ratsam sein, wenn die alte Version sehr veraltet ist.
- Fehlende PHP-Erweiterungen: MediaWiki benötigt spezifische PHP-Module (z.B. GD für Bildbearbeitung, XML, Intl). Überprüfen Sie die PHP-Info-Seite auf dem neuen Server.
- Rechteprobleme: Falsche Datei- und Verzeichnisberechtigungen sind eine der häufigsten Ursachen für Fehler (z.B. Bilder können nicht hochgeladen werden, oder es treten 500er-Fehler auf).
- Absolute Pfade in
LocalSettings.php
: Viele Probleme entstehen, wenn absolute Pfade im alten System fest codiert wurden und auf dem neuen Server nicht mehr stimmen. Nutzen Sie, wo möglich, relative Pfade oder Variablen. - Caching-Probleme: Nach dem Umzug kann es zu Darstellungsproblemen kommen, wenn alter Cache aktiv ist. Leeren Sie den MediaWiki-Cache (z.B. durch Löschen des Caches-Ordners oder über
php maintenance/rebuildData.php
bei älteren Versionen, bzw.php maintenance/update.php
für Datenbank-Updates) und den Browser-Cache. - Zeichensatzprobleme (UTF-8): Stellen Sie sicher, dass Ihre Datenbank und PHP auf dem neuen Server UTF-8 korrekt handhaben, um Anzeigefehler bei Sonderzeichen zu vermeiden.
- URL-Rewriting (Permalinks): Wenn Sie schöne URLs verwenden, muss die Webserver-Konfiguration (
.htaccess
für Apache, Nginx-Konfigurationsdatei) korrekt eingerichtet sein. - Testumgebung nutzen: Wenn möglich, führen Sie den gesamten Umzugsprozess zunächst in einer Staging- oder Testumgebung durch, bevor Sie ihn auf dem Live-System anwenden.
- Schritt-für-Schritt vorgehen: Gehen Sie nicht zu schnell vor. Überprüfen Sie jeden Schritt sorgfältig, bevor Sie zum nächsten übergehen.
- Dokumentieren: Halten Sie jeden Schritt, jede Konfigurationsänderung und jedes aufgetretene Problem fest. Dies hilft Ihnen nicht nur beim aktuellen Umzug, sondern auch bei zukünftigen Wartungsarbeiten.
Fazit: Ihr MediaWiki – stressfrei im neuen Zuhause
Ein stressfreier Serverwechsel ist keine Utopie, sondern das Ergebnis sorgfältiger Planung und gewissenhafter Ausführung. Indem Sie die Vorbereitung ernst nehmen, umfassende Backups erstellen, die neue Umgebung sorgfältig konfigurieren und ausführlich testen, minimieren Sie die Risiken erheblich. Ihr MediaWiki wird nahtlos in sein neues Zuhause umziehen, und Ihre Benutzer werden den Übergang kaum bemerken. Atmen Sie tief durch, folgen Sie diesen Schritten und genießen Sie die verbesserte Performance und Stabilität Ihres MediaWiki auf dem neuen Server!