Upgrade für das Portal für Entwicklerdienste ausführen

Edge for Private Cloud v4.18.01

In diesem Verfahren wird beschrieben, wie Sie eine vorhandene On-Premise-Installation von Apigee Developer Channel Services aktualisieren.

Die richtige Prozedur für die Aktualisierung bestimmen

Das Verfahren, mit dem Sie das Portal aktualisieren, basiert auf Ihrer aktuellen Installation:

Bestimmen der deinem aktuellen Installationstyp

Wenn Sie sich bezüglich Ihres aktuellen Installationstyps nicht sicher sind, verwenden Sie den folgenden Befehl, um festzustellen, es:

  • 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 die des Stammverzeichnisses des Portals im folgenden Format:

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

Standardinstallationsverzeichnis

Beim Upgradeprozess wird davon ausgegangen, dass das Entwicklerportal hier 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

Öffnen Sie die folgende URL in einem Browser, um die Portalversion zu ermitteln:

http://yourportal.com/buildInfo

Vor dem Aktualisieren

Wenn Sie bei vorhandenen Installationen Code in Drupal Core oder einem nicht benutzerdefinierten Code 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 Eigentum von Drupal ist. Eine Ausnahme von dieser Regel ist robots.txt. Wenn diese Datei im Webstamm vorhanden ist, für Sie aufbewahrt werden.

Bevor Sie mit der Installation fortfahren, sollten Sie ein Back-up des gesamten Drupal-Web-Stammverzeichnisses erstellen. Nachdem Sie die unten beschriebenen Installationsschritte ausgeführt haben, können Sie Ihre Anpassungen aus der Sicherung wiederherstellen.

Portal mithilfe von RPMs upgraden

So aktualisieren Sie den Portal-RPM 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 des Datenbank: 
    pg_dump --dbname=devportal --host=192.168.56.101 --username=drupaladmin
  --password --format=c > /tmp/portal.dmp

    Dabei gilt:

    • dbname gibt den Datenbanknamen an, der in der Konfigurationsdatei für die Portalinstallation mit dem Attribut PG_NAME angegeben ist.
    • host gibt die IP-Adresse des Portalknotens an.
    • username gibt den Postgres-Nutzernamen an, der vom Portal zum Zugriff auf die Datenbank verwendet wird, wie in der Eigenschaft DRUPAL_PG_USER in der Konfigurationsdatei der Portalinstallation angegeben.
    • Sie werden aufgefordert, das Postgres-Benutzerpasswort DRUPAL_PG_PASS in der Konfigurationsdatei für die Portalinstallation.

    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-Webstammverzeichnisses. Der Standardinstallationsort ist /opt/apigee/apigee-drupal, Sie haben ihn aber möglicherweise geändert.

    Wenn Sie den Speicherort dieses Verzeichnisses nicht kennen, verwenden Sie den Befehl drush status oder die Konfiguration > Medien > Datei aus dem Drupal-Menü, um den Speicherort des öffentlichen Dateisystems und den Pfad des privaten Dateisystems (für den nächsten Schritt).

  4. Sichern Sie die Dateien in /opt/apigee/data/apigee-drupal-devportal/private.
  5. Setzen Sie Drupal in den Wartungsmodus:
    1. Wählen Sie im Drupal-Menü Konfiguration aus.
    2. Wählen Sie auf der Seite Konfiguration die Option Wartung Modus unter Entwicklung.
    3. Klicken Sie das Kästchen Website in 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 zum Verzeichnis /opt: 
    > cd /opt
  8. Upgrade auf einem Server mit Internetverbindung:
    1. Laden Sie die bootstrap_4.18.01.sh-Datei von Edge 4.18.01 auf /tmp/bootstrap_4.18.01.sh herunter: 
      curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
    2. Installieren Sie das Edge 4.18.01-Dienstprogramm apigee-service und die Abhängigkeiten: 
      sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

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

      Das Installationsprogramm überprüft standardmäßig, ob Java 1.8 installiert ist. Sie können die Option „C“ verwenden, um fortzufahren, ohne Java zu installieren.

  9. Upgrade auf einem Server ohne Internetverbindung:
    1. Erstellen Sie ein lokales 4.18.01-Repository, wie unter „Lokales Apigee-Repository erstellen“ beschrieben bei Edge installieren apigee-setup-Dienstprogramm.
    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.01.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 auf dem neuen Knoten die Datei in das Verzeichnis /tmp: 
        tar -xzf apigee-4.18.01.tar.gz

        Mit diesem Befehl wird ein neues Verzeichnis namens „repos“ in dem Verzeichnis erstellt, das die TAR-Datei enthält. -Datei. 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.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

    3. So installieren Sie den Apigee-Dienst mit dem Nginx-Webserver:
      1. Konfigurieren Sie den Nginx-Webserver wie unter „Installation aus dem Repository mithilfe der nginx-Webserver“ unter Install the Edge apigee-setup-Dienstprogramm.
      2. Laden Sie auf dem Remote-Knoten die Edge-Datei bootstrap_4.18.01.sh herunter, um /tmp/bootstrap_4.18.01.sh: 
        /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh
  -o /tmp/bootstrap_4.18.01.sh

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

      3. Installieren Sie auf dem Remote-Knoten das Edge-Dienstprogramm apigee-service und dependencies: 
        sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939
    apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

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

  10. Verwenden Sie apigee-service, um das apigee-setup-Dienstprogramm zu aktualisieren: 
    /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, die Sie zum Installieren Postgres-Datenbank. Die einzige Anforderung an die Konfigurationsdatei ist, dass die Konfigurationsdatei Datei muss vom „Apigee“ zugänglich oder lesbar sein Nutzer.

  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 dem 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://portalIP_DNS:8079/update.php
  15. Deaktivieren 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. Heben Sie die Auswahl des Kästchens Website in den Wartungsmodus versetzen auf.
    4. Wählen Sie Konfiguration speichern aus.

Das Stammverzeichnis nach der Aktualisierung lautet:

/opt/apigee/apigee-drupal/wwwroot

Die Umstellung ist jetzt abgeschlossen.