Drupal upgraden

In einer Edge für Private Cloud-Installation des Apigee Developer Services-Portals (oder einfach im Portal) erhalten Sie möglicherweise eine Benachrichtigung, dass eine neue Version von Drupal verfügbar ist. Eine neue Version kann ein Release einer Drupal-Funktion, ein Patch, ein Sicherheitsupdate oder eine andere Art von Drupal-Update sein. Bei einem Sicherheitsupdate sollten Sie Ihre Drupal-Installation so schnell wie möglich aktualisieren, damit Ihre Website sicher bleibt.

Drupal Core upgraden

Im Folgenden wird beschrieben, wie Sie eine Private Cloud-Installation von Drupal 7.x.y auf eine andere Nebenversion aktualisieren (z. B. Drupal 7.54 auf 7.59).

Hinweis:

  • Mit diesem Verfahren wird nur Ihre Drupal-Installation aktualisiert. Die Apigee-Software, die im Rahmen des Portals ausgeliefert wird, wird nicht aktualisiert. Informationen zum Upgrade der Apigee-Portalsoftware finden Sie unter Upgrade des Portals.

    Wenn während eines Upgrades der Private Cloud (z. B. von 4.18.05 auf 4.19.01) das Apigee-Update-Dienstprogramm tatsächlich ein Downgrade Ihrer Drupal-Version ausführt, müssen Sie das Drupal-Upgrade-Dienstprogramm möglicherweise noch einmal ausführen. Weitere Informationen finden Sie unter Drupal-Upgrade noch einmal ausführen.

  • Sie müssen die Drush-Befehle (Drupal Shell) vom Stammverzeichnis der Portalwebsite aus ausführen. Standardmäßig wird das Portal installiert unter:
    • /opt/apigee/apigee-drupal/wwwroot (Nginx)
    • /var/www/html (Apache)
    Bei den folgenden Schritten wird von einer Nginx-Serverinstallation am oben angegebenen Standardspeicherort ausgegangen.

Aktuelle Drupal-Version ermitteln

Bevor Sie mit dem Drupal-Update beginnen, können Sie Ihre aktuelle Drupal-Version ermitteln. Führen Sie dazu den folgenden Befehl aus dem Drupal-Installationsordner aus. Standardmäßig ist Drupal in /opt/apigee/apigee-drupal/wwwroot installiert:

cd /opt/apigee/apigee-drupal/wwwroot
drush status | grep 'Drupal version'

Die Ausgabe sollte im folgenden Format angezeigt werden:

Drupal version          :  7.54

Wenn Sie Drupal in einem anderen Verzeichnis als /opt/apigee/apigee-drupal/wwwroot installiert haben, müssen Sie in dieses Verzeichnis wechseln, bevor Sie den Befehl drush ausführen.

Drupal-Version aktualisieren

In diesem Abschnitt wird beschrieben, wie Sie Drush-Befehle über eine Befehlszeile verwenden, um Ihre Drupal-Version zu aktualisieren. Siehe auch Drupal mithilfe von Drush aktualisieren (Drupal.org).

So aktualisieren Sie Ihre Drupal-Installation:

  1. Wechseln Sie in das Verzeichnis /opt/apigee/apigee-drupal/wwwroot oder in das Verzeichnis, in dem Sie das Portal installiert haben.
  2. Erstellen Sie eine vollständige Sicherung aller Dateien, Verzeichnisse und Datenbanken. Speichern Sie die Sicherung an einem Speicherort außerhalb der Drupal-Installation. Eine ausführliche Anleitung finden Sie unter Portal sichern.

    Wenn Sie Änderungen an Dateien wie .htaccess, robots.txt oder defaults.settings.php (im Verzeichnis sites) vorgenommen haben, müssen Sie die Änderungen nach der Aktualisierung noch einmal anwenden. Außerdem müssen Sie alle im Verzeichnis sites/all vorgenommenen Anpassungen noch einmal anwenden.

  3. Versetzen Sie Ihre Website in den Wartungsmodus:
    drush vset --exact maintenance_mode 1
    drush cache-clear all
  4. Installieren Sie die gewünschte Version von Drupal mit dem folgenden Befehl:
    drush pm-update drupal-version

    Dabei ist version die gewünschte Version.

    Alternativ können Sie drush pm-update drupal ausführen, um ein Update auf die neueste Drupal-Kernversion durchzuführen. Sie können drush pm-updatestatus ausführen, um verfügbare kleinere Updates für Drupal-Kern- und Beitragsprojekte aufzulisten.

  5. Wenden Sie alle Änderungen, die an .htaccess, robots.txt oder defaults.settings.php (im Verzeichnis sites) vorgenommen wurden, noch einmal an.
  6. Wenden Sie alle Änderungen, die Sie im Verzeichnis sites/all vorgenommen haben, noch einmal an.
  7. Deaktivieren Sie den Wartungsmodus für Ihre Website:
    drush vset --exact maintenance_mode 0
    drush cache-clear all

PHP- und Drupal-Beitragsmodule aktualisieren

Wenn Sie Drupal mithilfe der obigen Anleitung in diesem Abschnitt aktualisieren, werden auch die von Drupal verwendeten Module wie contrib und PHP aktualisiert. Allerdings sollten Sie zwischen den Private Cloud-Releases über die neuesten Drupal-Module auf dem Laufenden bleiben.

Wenn sich das Modul in /profiles/apigee/modules/contrib befindet, können Sie es durch eine neuere Version dieses Moduls ersetzen. Speichern Sie dazu die neuere Version in /sites/all/modules/contrib. Edge for Private Cloud verwendet die neuere Version in /sites/all/modules/contrib anstelle der älteren Version in /profiles/apigee/modules/contrib. Weitere Informationen findest du unter Module aktualisieren (Drupal.org).

Wenn Sie eine neue Private Cloud-Version installieren, die eine neuere Version des Moduls enthält, die zuvor in /sites/all/modules/contrib gespeichert wurde, entfernen Sie das Modul aus /sites/all/modules/contrib. Weitere Informationen finden Sie unter Module und Themen verschieben (Drupal.org).

Was ist, wenn während des Updates ein Problem auftritt?

Stellen Sie den vorherigen Zustand Ihrer Website mithilfe der von Ihnen erstellten Sicherungsdateien wieder her. Wenden Sie sich an den Apigee Edge-Support und geben Sie alle Fehlermeldungen an, die während des Updates gemeldet wurden.