Drupal upgraden

Edge for Private Cloud v4.19.01

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

Upgrade des Drupal-Kerns durchführen

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 Lieferumfang des Portals enthalten ist, wird nicht aktualisiert. Informationen zum Upgrade der Apigee-Portalsoftware finden Sie unter Portal aktualisieren.

    Wenn das Apigee-Update-Dienstprogramm während eines Private Cloud-Upgrades (z. B. von 4.18.05 auf 4.19.01) ein Downgrade Ihrer Drupal-Version durchfü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) im Stammverzeichnis der Portalseite ausführen. Standardmäßig wird das Portal unter folgendem Pfad installiert:
    • /opt/apigee/apigee-drupal/wwwroot (Nginx)
    • /var/www/html (Apache)
    Bei der folgenden Vorgehensweise wird von einer Nginx-Serverinstallation am oben genannten Standardspeicherort ausgegangen.

Aktuelle Drupal-Version ermitteln

Bevor Sie das Drupal-Update starten, können Sie die aktuelle Drupal-Version ermitteln. Führen Sie dazu den folgenden Befehl im Drupal-Installationsordner aus. Standardmäßig wird 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. Weitere Informationen finden Sie unter Drupal mit 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 Vollsicherung aller Dateien, Verzeichnisse und Datenbanken. Speichern Sie die Sicherung an einem Ort außerhalb der Drupal-Installation. Eine vollständige 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 dem Update noch einmal anwenden. Außerdem müssen Sie alle Anpassungen, die Sie im Verzeichnis sites/all vorgenommen haben, 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 auf die neueste Drupal-Core-Version zu aktualisieren. Sie können drush pm-updatestatus ausführen, um die verfügbaren kleineren Updates für den Drupal-Kern und die Contrib-Projekte aufzulisten.

  5. Wenden Sie alle Änderungen an .htaccess, robots.txt oder defaults.settings.php (im Verzeichnis sites) noch einmal an.
  6. Wenden Sie alle Änderungen am Verzeichnis sites/all noch einmal an.
  7. Beenden Sie den Wartungsmodus Ihrer Website:
    drush vset --exact maintenance_mode 0
    drush cache-clear all

PHP- und Drupal-Contrib-Module aktualisieren

Wenn Sie Drupal gemäß der Anleitung oben in diesem Abschnitt aktualisieren, werden auch die von Drupal verwendeten Module wie Contrib und PHP aktualisiert. Sie sollten jedoch zwischen den Private Cloud-Releases die neuesten Drupal-Module im Auge behalten.

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

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

Was kann ich tun, wenn während des Updates ein Problem auftritt?

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