Upgrade der Drupal-Version einer privaten Cloud-Installation

Edge for Private Cloud Version 4.17.09

In einer Edge for Private Cloud-Installation des Developer Services-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. Bei einem Sicherheitsupdate sollten Sie Ihre Drupal-Installation so schnell wie möglich aktualisieren, damit Ihre Website weiterhin sicher bleibt.

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

Hinweis:

  • Dabei wird nur Ihre Drupal-Installation aktualisiert. Die Apigee-Software, die im Lieferumfang des Portals enthalten ist, wird nicht aktualisiert. Informationen zum Upgraden der Apigee-Portalsoftware finden Sie unter Upgrade des Developer Services-Portals.

  • Sie müssen Drush-Befehle aus dem Stammverzeichnis der Portal-Website ausführen. Standardmäßig wird das Entwicklerportal unter folgendem Pfad installiert:
    • /opt/apigee/apigee-drupal/wwwroot (Nginx)
    • /var/www/html (Apache)
    Bei der folgenden Anleitung wird davon ausgegangen, dass der Nginx-Server am oben genannten Standardspeicherort installiert ist.

Bestimmen Ihrer aktuellen Drupal-Version

Bevor Sie mit dem Drupal-Update beginnen, können Sie Ihre aktuelle Drupal-Version ermitteln, indem Sie den folgenden Befehl im Drupal-Installationsordner ausführen. Standardmäßig wird Drupal unter /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, wechseln Sie zu diesem Verzeichnis, bevor Sie den Befehl drush ausführen.

Drupal-Version aktualisieren

In diesem Abschnitt wird beschrieben, wie Sie Drush (Drupal Shell) über eine Befehlszeile verwenden, um Ihre Drupal-Version zu aktualisieren. Weitere Informationen hierzu finden Sie unter Drushing mit Drush aktualisieren in der Drupal-Dokumentation.

So aktualisieren Sie Ihre Drupal-Installation:

  1. Wechseln Sie zum Verzeichnis /opt/apigee/apigee-drupal/wwwroot oder zum 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 Ort außerhalb der Drupal-Installation. Eine vollständige Anleitung finden Sie unter Portal sichern.

    Wenn Sie Dateien wie .htaccess, robots.txt oder defaults.settings.php (im Verzeichnis sites) geändert haben, müssen Sie die Änderungen nach dem Update noch einmal anwenden. Außerdem müssen Sie alle Anpassungen im Verzeichnis sites/all neu 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-7.56

    Hinweis:Ersetzen Sie 7.56 durch die gewünschte Version.
    Alternativ können Sie drush pm-update drupal ausführen, um ein Update auf die neueste Drupal Core-Version durchzuführen. Mit drush pm-updatestatus können Sie eine Liste der verfügbaren Minor-Updates für Drupal Core und Contrib-Projekte aufrufen.
  5. Nehmen Sie alle Änderungen an .htaccess, robots.txt oder defaults.settings.php (im Verzeichnis sites) noch einmal vor.
  6. Übernehmen Sie alle Änderungen, die Sie am Verzeichnis sites/all vorgenommen haben.
  7. Beenden Sie den Wartungsmodus Ihrer Website:
    > drush vset --exact maintenance_mode 0 
    > drush cache-clear all
    

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

Stellen Sie Ihre Website mithilfe der von Ihnen erstellten Sicherungsdateien wieder in den vorherigen Zustand her. Wenden Sie sich an Ihren Apigee-Supportmitarbeiter und geben Sie alle Fehlermeldungen an, die während der Aktualisierung gemeldet wurden.