Anleitung Drupal Core Update

Schritt 1 - Datensicherung

Zunächst sollten alle Dateien und die Datenbank gesichert werden. Eine vollständige Sicherung erleichtert es, zur vorherigen Version zurückzukehren, falls das Update fehlschlägt.

Wurden manuelle Änderungen an Dateien wie .htaccess, composer.json oder robots.txt vorgenommen, sollten diese Dateien separat gesichert und leicht auffindbar abgelegt werden. Nach der Installation des neuen Drupal-Kerns müssen diese Änderungen erneut angewendet werden. Zum Beispiel erstellt Acquia Dev Desktop eine .htaccess-Datei im obersten Verzeichnis, ohne die nur die Startseite der Website funktioniert.

Es wird dringend empfohlen, im Falle schwerwiegender Fehler während des Updates eine Sicherungskopie wiederherzustellen.

Schritt 2 - Wartungsmodus

Bei Drupal als Administrator anmelden und die Website in den Wartungsmodus versetzen:

• In der Admin-Oberfläche zu Konfiguration -> Entwicklung -> Wartungsmodus navigieren.
• Das Kontrollkästchen „Website in den Wartungsmodus versetzen“ aktivieren.
• Auf „Konfiguration speichern“ klicken.

Schritt 3 - Alte Verzeichnisse löschen

Folgende Schritte durchführen, um die Dateien im obersten Verzeichnis sowie in den Verzeichnissen „core“ und „vendor“ zu entfernen, ohne die Verzeichnisse „modules“, „profiles“, „sites“ und „themes“ zu löschen:

• Ins Drupal-Verzeichnis navigieren.
• Alle Dateien im obersten Verzeichnis (auch versteckte Dateien, die mit einem Punkt beginnen) sowie die Verzeichnisse „core“ und „vendor“ markieren und löschen. Die Verzeichnisse „modules“, „profiles“, „sites“ und „themes“ müssen erhalten bleiben.

Schritt 4 - Optional

Manchmal enthält ein Update Änderungen an den Dateien default.settings.php oder default.services.yml. Dies ist in den Release Notes vermerkt. Die jeweiligen Versionshinweise sind auf https://www.drupal.org/project/drupal unter „Downloads“ abrufbar.

Falls die default.settings.php geändert wurde, folgendermaßen vorgehen:

• Die Datei settings.php im Verzeichnis /sites/* (normalerweise sites/default) finden.
• Eine Sicherungskopie der settings.php Datei erstellen.
• Eine Kopie der neuen default.settings.php erstellen und in settings.php umbenennen (überschreibt die vorhandene settings.php).
• Benutzerdefinierte und standortspezifische Einträge aus der gesicherten Datei in die neue settings.php übernehmen, insbesondere die Datenbankinformationen und weitere Anpassungen.

Schritt 5 - Neuste Version Herunterladen

Die neueste Drupal-Version von https://www.drupal.org/download herunterladen und außerhalb des Webroot-Verzeichnisses speichern.

• Das Archiv extrahieren.
• Mit einem FTP-Client die Verzeichnisse „core“ und „vendor“ sowie die Dateien im obersten Verzeichnis ins Drupal-Verzeichnis hochladen.

Schritt 6 - Optional

Erneut manuelle Änderungen an Dateien wie .htaccess, composer.json oder robots.txt anwenden.

Schritt 7 - Datenbank Update starten 

Im Browser update.php ausführen (z.B. http://www.meine-website.de/update.php), um die Kerndatenbanktabellen zu aktualisieren.

Schritt 8 - Status Abrufen und Testen der Seite

Schritt 8.1 - Statusreport

Im Drupal-Admin anmelden und unter Administration -> Reports -> Status sicherstellen, dass alles wie erwartet funktioniert (Keine Fehler angezeigt werden).

Schritt 8.2 - Cache Leeren

Unter "Konfiguration -> Entwicklung -> Leistung" den Cache leeren

Schritt 8.3 - Wartungsmodus deaktivieren

Den Wartungsmodus wieder deaktivieren:

• Zu Konfiguration -> Entwicklung -> Wartungsmodus navigieren.
• Das Kontrollkästchen „Website in den Wartungsmodus versetzen“ deaktivieren.
• Auf „Konfiguration speichern“ klicken.

Schritt 8.4 - Website Testen

Die Website aufrufen (am besten mit einem anderen Browser / anderen Gerät) und ausgiebig testen.

Fertig

Die Drupal-Core-Aktualisierung wurde erfolgreich durchgeführt. Falls Unterstützung bei einem Update benötigt wird, stehe ich gern zur Verfügung. Nehmen Sie einfach mit mir Kontakt auf.