Portal aktualisieren

Edge for Private Cloud v4.18.05

In diesem Verfahren wird beschrieben, wie Sie ein vorhandenes On-Premise-Apigee Developer Services-Portal (oder einfach das Portal) aktualisieren.

Die richtige Prozedur für die Aktualisierung bestimmen

Die Aktualisierung des Portals hängt von Ihrer aktuellen Installation ab:

• Wenn Ihre Installation Nginx/Postgres verwendet, führen Sie die Schritte unter Upgrade eines Portals mit RPMs unten aus.
• Wenn Sie in Ihrer Installation Apache/MySQL oder Apache/MariaDB verwenden, lesen Sie den Hilfeartikel Ein tar-basiertes Portal in ein RPM-basiertes Portal konvertieren.

Aktuellen Installationstyp ermitteln

Wenn Sie sich nicht sicher sind, welchen Installationstyp Sie haben, können Sie ihn mit dem folgenden Befehl ermitteln:

• ls /opt

  Wenn Sie Nginx/Postgres verwenden, werden die folgenden Verzeichnisse angezeigt: /opt/apigee und /opt/nginx.

  Wenn Sie Apache/MySQL oder Apache/MariaDB verwenden, sollten diese Verzeichnisse nicht vorhanden sein.

• /opt/apigee/apigee-service/bin/apigee-all status

  Wenn Sie Nginx/Postgres verwenden, wird die folgende Ausgabe angezeigt:

  + apigee-service
  apigee-drupal-devportal status
  OK: apigee-drupal-devportal is up and running
  + apigee-service apigee-lb status
  apigee-service: apigee-lb: OK
  + apigee-service apigee-postgresql status
  apigee-service: apigee-postgresql: OK

• apachectl -S

  Wenn Sie Apache/MySQL oder Apache/MariaDB verwenden, sollte dieser Befehl das Web-Stammverzeichnis des Portals in der folgenden Form zurückgeben:

  *:80
  192.168.56.102 (/etc/httpd/conf/vhosts/devportal.conf:1)

Standardinstallationsverzeichnis

Für das Upgrade wird davon ausgegangen, dass das Portal an folgender Stelle installiert wurde:

• 4.17.05 und höher: /opt/apigee/apigee-drupal/wwwroot
• Vor 4.17.05: /opt/apigee/apigee-drupal (Nginx) oder /var/www/html (Apache)

Wenn Sie das Portal nicht im Standardverzeichnis installiert haben, ändern Sie die Pfade in der Anleitung unten so, dass Ihr Installationsverzeichnis verwendet wird.

Unterstützte Upgrade-Versionen

Dieses Upgradeverfahren wird für die folgenden Versionen des Portals unterstützt:

• OPDK-17-01.x
• OPDK-17-05.x
• OPDK-17-09.x
• OPDK-18-01.x

Um Ihre Portalversion zu ermitteln, öffnen Sie die folgende URL in einem Browser:

http://yourportal.com/buildInfo

Vor der Aktualisierung

Wenn Sie bei vorhandenen Installationen Code in Drupal Core oder in nicht benutzerdefinierten Modulen geändert haben, werden Ihre Änderungen überschrieben. Dazu gehören unter anderem alle Änderungen, die Sie an .htaccess vorgenommen haben. Sie sollten davon ausgehen, dass alles außerhalb des Verzeichnisses /sites zu Drupal gehört. Eine Ausnahme von dieser Regel ist robots.txt. Wenn diese Datei im Web-Stammverzeichnis vorhanden ist, wird sie beibehalten.

Erstellen Sie vor der Installation eine Sicherung Ihres gesamten Drupal-Webstammverzeichnisses. Nachdem Sie die unten beschriebenen Installationsschritte ausgeführt haben, können Sie Ihre Anpassungen aus der Sicherung wiederherstellen.

Portal mithilfe von RPMs aktualisieren

So aktualisieren Sie das RPM des Portals auf einem Knoten:

1. Wechseln Sie zum Drupal-Verzeichnis, standardmäßig /opt/apigee/apigee-drupal:

   cd /opt/apigee/apigee-drupal

2. Sichern Sie Ihre Drupal-Datenbankinstanz. Mit dem Befehl pg_dump wird eine Kopie der Datenbank erstellt:

   pg_dump --dbname=devportal --host=host_IP_address --username=drupaladmin
     --password --format=c > /tmp/portal.dmp

   Dabei gilt:

   • devportal ist der Datenbankname, der in der Konfigurationsdatei für die Portalinstallation mit dem Attribut PG_NAME angegeben ist.
   • host_IP_address ist die IP-Adresse des Portalknotens.
   • drupaladmin ist der Postgres-Nutzername, der vom Portal für den Zugriff auf die Datenbank verwendet wird, wie im Attribut DRUPAL_PG_USER in der Konfigurationsdatei für die Portalinstallation angegeben.
   • Sie werden zur Eingabe des Postgres-Nutzerpassworts aufgefordert, wie im Attribut DRUPAL_PG_PASS in der Konfigurationsdatei für die Portalinstallation festgelegt.

   Wenn Sie später Daten aus der Sicherung wiederherstellen müssen, verwenden Sie den folgenden Befehl:

   pg_restore --clean --dbname=devportal --host=localhost  --username=apigee < /tmp/portal.dmp

3. Erstellen Sie eine Sicherung des gesamten Drupal-Stammverzeichnisses. Der Standardinstallationsort ist /opt/apigee/apigee-drupal, Sie haben ihn aber möglicherweise geändert.

   Wenn Sie sich nicht sicher sind, wo sich dieses Verzeichnis befindet, verwenden Sie den Befehl drush status oder den Eintrag Konfiguration > Medien > Datei im Drupal-Menü, um den Speicherort des öffentlichen Dateisystems und den Pfad des privaten Dateisystems für den nächsten Schritt zu ermitteln.

4. Erstellen Sie eine Sicherungskopie der Dateien in /opt/apigee/data/apigee-drupal-devportal/private.
5. Stellen Sie Drupal in den Wartungsmodus:
   1. Wählen Sie im Drupal-Menü Konfiguration aus.
   2. Wählen Sie auf der Seite Konfiguration unter Entwicklung die Option Wartungsmodus aus.
   3. Klicken Sie das Kästchen Website in den Wartungsmodus versetzen an.
   4. Geben Sie eine Nachricht ein, die Nutzern während der Wartung angezeigt wird.
   5. Wählen Sie Konfiguration speichern aus.
6. Deaktivieren Sie SELinux wie unter Installieren Sie das Hilfsprogramm für das Edge-Apigee-Setup beschrieben.
7. Wechseln Sie in das Verzeichnis /opt:

   cd /opt

8. Upgrade auf einem Server mit Internetverbindung:
   1. Laden Sie die Datei bootstrap_4.18.05.sh von Edge 4.18.05 auf /tmp/bootstrap_4.18.05.sh herunter:

      curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh

   2. Installieren Sie das Dienstprogramm apigee-service und die Abhängigkeiten für Edge 4.18.05:

      sudo bash /tmp/bootstrap_4.18.05.sh apigeeuser=uName apigeepassword=pWord

      Dabei sind uName und pWord der Nutzername und das Passwort, die Sie von Apigee erhalten haben. Wenn Sie pWord weglassen, werden Sie aufgefordert, sie einzugeben.

      Standardmäßig wird beim Installationsvorgang geprüft, ob Java 1.8 installiert ist. Sie können die Option „C“ verwenden, um ohne Installation von Java fortzufahren.

9. Upgrade auf einem Server ohne Internetverbindung:
   1. Erstellen Sie ein lokales 4.18.05-Repository, wie unter Lokales Apigee-Repository erstellen beschrieben.
   2. So installieren Sie apigee-service aus einer .tar-Datei:
      1. Verwenden Sie auf dem Knoten mit dem lokalen Repository den folgenden Befehl, um das lokale Repository in einer einzelnen TAR-Datei namens /opt/apigee/data/apigee-mirror/apigee-4.18.05.tar.gz zu verpacken:

         /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

      2. Kopieren Sie die .tar-Datei auf den Knoten, auf dem Sie Edge aktualisieren möchten. Kopieren Sie es beispielsweise in das Verzeichnis /tmp auf dem neuen Knoten.
      3. Entpacken Sie die Datei auf dem neuen Knoten im Verzeichnis „/tmp“:

         tar -xzf apigee-4.18.05.tar.gz

         Mit diesem Befehl wird im Verzeichnis mit der .tar-Datei ein neues Verzeichnis mit dem Namen „repos“ erstellt. Beispiel: /tmp/repos.

      4. Installieren Sie das Edge-Dienstprogramm apigee-service und die Abhängigkeiten aus /tmp/repos:

         sudo bash /tmp/repos/bootstrap_4.18.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

         Beachten Sie, dass Sie in diesem Befehl den Pfad zum Verzeichnis „repos“ angeben.

   3. So installieren Sie apigee-service mit dem Nginx-Webserver:
      1. Konfigurieren Sie den Nginx-Webserver wie unter Installieren Sie das Hilfsprogramm für das Edge-Apigee-Setup unter „Über den Nginx-Webserver aus dem Repository installieren“ beschrieben.
      2. Laden Sie die Edge-bootstrap_4.18.05.sh-Datei auf dem Remote-Knoten auf /tmp/bootstrap_4.18.05.sh herunter:

         /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.05.sh
           -o /tmp/bootstrap_4.18.05.sh

         Dabei sind uName und pWord der Nutzername und das Passwort, die Sie oben für das Repository festgelegt haben, und remoteRepo ist die IP-Adresse oder der DNS-Name des Repository-Knotens.

      3. Installieren Sie auf dem Remote-Knoten das Edge-Hilfsprogramm apigee-service und die Abhängigkeiten:

         sudo bash /tmp/bootstrap_4.18.05.sh apigeerepohost=remoteRepo:3939
           apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

         Dabei sind uName und pWord der Nutzername und das Passwort für das Repository.

10. Aktualisieren Sie das apigee-setup-Dienstprogramm mit apigee-service:

    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

11. Führen Sie das Update-Dienstprogramm auf Ihrem Postgre-Knoten aus:

    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

    Dabei ist configFile die Konfigurationsdatei, mit der Sie die Postgres-Datenbank installiert haben. Die einzige Anforderung an die Konfigurationsdatei besteht darin, dass sie für den Nutzer „apigee“ zugänglich oder lesbar sein muss.

12. Aktualisieren Sie die Postgres-Datenbank:

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade

13. Führen Sie das Update-Dienstprogramm auf Ihrem Knoten aus, um das Portal zu aktualisieren:

    /opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile

    Dabei ist configFile die Konfigurationsdatei, mit der Sie das Portal installiert haben. Die einzige Anforderung an die Konfigurationsdatei besteht darin, dass sie für den Nutzer „apigee“ zugänglich oder lesbar sein muss.

14. Führen Sie das update.php-Script von Drupal aus, indem Sie die folgende URL in einem Browserfenster öffnen:

    http://portal_IP_DNS:8079/update.php

15. Deaktivieren Sie den Wartungsmodus für Drupal:
    1. Wählen Sie im Drupal-Menü Konfiguration aus.
    2. Wählen Sie auf der Seite Konfiguration unter Entwicklung die Option Wartungsmodus aus.
    3. Heben Sie die Auswahl des Kästchens Website in Wartungsmodus versetzen auf.
    4. Wählen Sie Konfiguration speichern aus.

Nach der Aktualisierung sieht das Stammverzeichnis folgendermaßen aus:

/opt/apigee/apigee-drupal/wwwroot

Das Upgrade ist jetzt abgeschlossen.