Manuelles Aktualisieren des Drupal-Cores

Bevor Sie beginnen

Falls noch nicht geschehen, wird empfohlen, diese Einführung zu lesen, die alle Optionen zusammenfasst, die Sie für das Aktualisieren von Drupal 8 wählen können.

PS! Dieses Update-Verfahren ist auch im Benutzerhandbuch beschrieben.

Wenn Sie zusätzliche Module mit Drittanbieter-Abhängigkeiten über Composer installiert haben, müssen Sie andere Update-Optionen verwenden, da diese Anleitung das Verzeichnis vendor/ überschreibt.

Drupal 8 Core manuell aktualisieren

Schritte zur Aktualisierung des Drupal 8 Cores mittels manueller Installation und Kommandozeile (Shell):

1. Erstellen Sie ein Backup Ihrer Dateien und Datenbank. Ein vollständiges Backup ermöglicht eine einfache Rückkehr zur vorherigen Version, falls das Update fehlschlägt.

Optional: Falls Sie manuelle Änderungen an Dateien wie .htaccess, composer.json oder robots.txt vorgenommen haben, kopieren Sie diese an einen leicht auffindbaren Ort. Denn nach der Installation des neuen Drupal-Cores müssen diese Änderungen erneut angewendet werden. Zum Beispiel platziert Acquia Dev Desktop die .htaccess-Datei im Hauptverzeichnis, ohne die nur die Startseite Ihrer Website funktioniert.

Bei fatalen Fehlern während des Updates immer auf das Backup zurückgreifen.

2. Melden Sie sich in Drupal als Benutzer mit der Berechtigung „Software-Updates verwalten“ an.

3. Versetzen Sie Ihre Site in den Wartungsmodus. Dazu:

  - Navigieren Sie im Admin-Interface zu Administration > Konfiguration > Entwicklung > Wartungsmodus.

  - Aktivieren Sie die Checkbox „Site in den Wartungsmodus versetzen“.

  - Klicken Sie auf „Konfiguration speichern“.

4. Wählen Sie eine der folgenden zwei Methoden, um Dateien im Hauptverzeichnis sowie die Verzeichnisse „core“ und „vendor“ zu löschen, wobei die Verzeichnisse „modules“, „profile“, „sites“ und „themes“ erhalten bleiben:

Shell verwenden

  1. Wechseln Sie in Ihr Drupal-Installationsverzeichnis:

cd /pfad/zu/ihrer/drupal/installation

  2. Löschen Sie die Verzeichnisse „core“ und „vendor“:

rm -rf core vendor

  3. Löschen Sie alle Dateien im Hauptverzeichnis:

rm -f *.* .[a-z]*

FTP-Client verwenden

  1. Navigieren Sie zum Drupal-Verzeichnis.
  2. Wählen Sie alle Dateien im Hauptverzeichnis (einschließlich versteckter Dateien, die mit Punkt beginnen) sowie die Verzeichnisse „core“ und „vendor“ aus und löschen Sie sie. Löschen Sie nicht die Verzeichnisse „modules“, „profiles“, „sites“ und „themes“.

5. Manchmal beinhalten Updates Änderungen an der Datei default.settings.php. Dies wird in den Release Notes angegeben. Sie finden die Release Notes für Ihre Version unter https://www.drupal.org/project/drupal. Nutzen Sie am Ende der Projektseite unter „Downloads“ den Link für Ihre Drupal-Version, um die Release Notes einzusehen. Falls Ihre Version nicht gelistet ist, klicken Sie auf „Alle Releases anzeigen“. Dort können Sie nach Ihrer Version suchen und die Release Notes lesen. Falls das Update Änderungen an der Datei default.settings.php enthält, gehen Sie wie folgt vor:

• Kopieren Sie benutzerspezifische und sitespezifische Einträge aus Ihrem Backup in die neue Datei settings.php. Besonders wichtig sind die Datenbank-Zeilen, aber auch alle weiteren von Ihnen hinzugefügten Einstellungen sollten übernommen werden.
• Erstellen Sie eine Kopie der neuen Datei default.settings.php und benennen Sie diese in settings.php um (überschreiben Sie damit Ihre bisherige settings.php).
• Erstellen Sie eine Sicherungskopie Ihrer settings.php mit einem anderen Namen.
• Finden Sie die Datei settings.php im Verzeichnis /sites/* (normalerweise sites/default).

6. Wählen Sie eine der folgenden zwei Methoden, um die neuen Dateien in das Hauptverzeichnis sowie die Verzeichnisse „core“ und „vendor“ zu kopieren:

Shell verwenden

  1. Nutzen Sie unter Unix/Linux folgende Befehle zum Herunterladen und Entpacken:

wget https://ftp.drupal.org/files/projects/drupal-x.y.z.tar.gz
tar zxf drupal-x.y.z.tar.gz

  2. Der Befehl legt ein neues Verzeichnis drupal-x.y.z/ an, das alle Drupal-Dateien enthält. Wechseln Sie in das Verzeichnis und kopieren Sie „core“ und „vendor“ sowie alle Dateien aus dem Hauptverzeichnis in Ihre Drupal-Installation:

cd drupal-x.y.z
cp -R core vendor /pfad/zu/ihrer/drupal/installation
cp *.* .[a-z]* /pfad/zu/ihrer/drupal/installation

Browser und FTP-Client verwenden

• Laden Sie die aktuelle Drupal 8.x.x Version von https://www.drupal.org/download herunter und speichern Sie sie außerhalb Ihres Webroots.
• Entpacken Sie das Archiv.
• Nutzen Sie einen FTP-Client, um die Verzeichnisse „core“ und „vendor“ sowie alle Dateien aus dem Hauptverzeichnis in Ihre Drupal-Installation hochzuladen.

7. Wenden Sie bei Bedarf manuell Änderungen an Dateien wie .htaccess, composer.json oder robots.txt erneut an.

8. Öffnen Sie in Ihrem Browser update.php unter http://www.example.com/update.php (ersetzen Sie www.example.com durch Ihre Domain). Dadurch werden die notwendigen Datenbanktabellen aktualisiert.

  Optional: Falls Sie nicht als Benutzer mit der Berechtigung „Software-Updates verwalten“ oder als Site-Benutzer (während der Installation angelegt) angemeldet sind, haben Sie keinen Zugriff auf update.php. Gehen Sie wie folgt vor, um diese Beschränkung zu umgehen:

    - Öffnen Sie die Datei settings.php in einem Texteditor.
    - Suchen Sie die Zeile

$settings['update_free_access'] = FALSE;

    - Ändern Sie FALSE auf TRUE:

$settings['update_free_access'] = TRUE;

    - Rufen Sie die Seite /update.php erneut auf.
    - Nach Abschluss der Updates ändern Sie diese Einstellung aus Sicherheitsgründen wieder auf FALSE zurück.

9. Melden Sie sich als Administrator in Drupal an und navigieren Sie zu Administration > Berichte > Statusbericht. Vergewissern Sie sich, dass alles ordnungsgemäß funktioniert.

10. Bleiben Sie im Browser angemeldet, gehen Sie zu Administration > Konfiguration > Entwicklung > Wartungsmodus. Deaktivieren Sie die Checkbox „Site in den Wartungsmodus versetzen“ und speichern Sie die Einstellungen.

11. Löschen Sie nach dem Update die heruntergeladene Drupal-Version:

rm drupal-x.y.z.tar.gz
rm -rf drupal-x.y.z/

12. Fertig. Sie haben den Drupal 8 Core erfolgreich manuell mit Shell/Browser aktualisiert. :)