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

Developer Services Portal v. 4.17.09

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

Das richtige Updateverfahren bestimmen

Das Verfahren zum Aktualisieren des Portals hängt von Ihrer aktuellen Installation ab:

Aktuellen Installationstyp ermitteln

Wenn Sie sich nicht sicher sind, welchen Installationstyp Sie derzeit verwenden, 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 Webstammverzeichnis des Portals im folgenden Format zurückgeben:

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

Standardinstallationsverzeichnis

Beim Upgrade wird davon ausgegangen, dass das Entwicklerportal unter folgendem Pfad 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 im folgenden Verfahren, um Ihr Installationsverzeichnis zu verwenden.

Unterstützte Upgrade-Versionen

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

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

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

http://your_portal.com/buildInfo

Vor dem Update

Wenn Sie bei vorhandenen Installationen Code im Drupal-Kern oder in nicht benutzerdefinierten Modulen geändert haben, werden Ihre Änderungen überschrieben. Dazu gehören unter anderem alle Änderungen, die Sie möglicherweise 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 Webstammverzeichnis vorhanden ist, wird sie für Sie beibehalten.

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

Upgrade eines Portals mit RPMs

So aktualisieren Sie das Portal-RPM auf einem Knoten:

  1. Wechseln Sie in das Drupal-Verzeichnis. Beispiel: /opt/apigee/apigee-drupal/wwwroot. 

    cd /opt/apigee/apigee-drupal/wwwroot

    Das Standardverzeichnis für Ihre Produktversion finden Sie unter Standardinstallationsverzeichnis.

  2. Sichern Sie Ihre Drupal-Datenbankinstanz. Mit dem Befehl pg_dump wird eine Kopie der Datenbank erstellt:
    pg_dump --dbname=devportal --host=192.168.56.101
  --username=drupaladmin --password --format=c > /tmp/portal.dmp

    Dabei gilt:

    • dbname gibt den Datenbanknamen an, wie durch das Attribut PG_NAME in der Konfigurationsdatei für die Portalinstallation angegeben.
    • host gibt die IP-Adresse des Portal-Knotens an.
    • username gibt den Postgres-Nutzernamen an, den das Portal für den Zugriff auf die Datenbank verwendet, wie im Attribut DRUPAL_PG_USER in der Konfigurationsdatei für die Portalinstallation angegeben.
    • Sie werden aufgefordert, das Passwort des Postgres-Nutzers einzugeben, das durch das Attribut DRUPAL_PG_PASS in der Konfigurationsdatei für die Portalinstallation definiert ist.

    Wenn Sie später eine Wiederherstellung aus der Sicherung durchführen 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 Standardinstallationsspeicherort ist /opt/apigee/apigee-drupal, aber Sie haben ihn 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 Sicherung der Dateien in /opt/apigee/data/apigee-drupal-devportal/private.
  5. Versetzen Sie Drupal in den Wartungsmodus:
    1. Wählen Sie im Drupal-Menü Configuration (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 Edge-Dienstprogramm „apigee-setup“ installieren beschrieben.
  7. Wechseln Sie in das Verzeichnis /opt: 
    cd /opt
  8. Für ein Upgrade auf einem Server mit Internetverbindung:
    1. Laden Sie die Edge 4.17.09-bootstrap_4.17.09.sh-Datei in /tmp/bootstrap_4.17.09.sh herunter: 
      curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
    2. Installieren Sie das Edge 4.17.09-Dienstprogramm apigee-service und die Abhängigkeiten: 
      sudo bash /tmp/bootstrap_4.17.09.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, es einzugeben.

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

  9. Für ein Upgrade auf einem Server ohne Internetverbindung:
    1. Erstellen Sie ein lokales 4.17.09-Repository, wie unter „Lokales Apigee-Repository erstellen“ unter Edge-Dienstprogramm „apigee-setup“ installieren 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 mit dem Namen /opt/apigee/data/apigee-mirror/apigee-4.17.09.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 sie beispielsweise in das Verzeichnis /tmp auf dem neuen Knoten.
      3. Entpacken Sie die Datei auf dem neuen Knoten in das Verzeichnis „/tmp“:
        tar -xzf apigee-4.17.09.tar.gz

        Mit diesem Befehl wird im Verzeichnis, das die TAR-Datei enthält, ein neues Verzeichnis mit dem Namen „repos“ erstellt. Beispiel: /tmp/repos.

      4. Installieren Sie das Edge-Dienstprogramm apigee-service und die Abhängigkeiten von /tmp/repos: 
        sudo bash /tmp/repos/bootstrap_4.17.09.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 Edge-Dienstprogramm „apigee-setup“ installieren im Abschnitt „Aus dem Repository mit dem Nginx-Webserver installieren“ beschrieben.
      2. Laden Sie auf dem Remote-Knoten die Edge-Datei bootstrap_4.17.09.sh in /tmp/bootstrap_4.17.09.sh herunter: 
        /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh
  -o /tmp/bootstrap_4.17.09.sh

        Dabei sind uName: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-Dienstprogramm apigee-service und die Abhängigkeiten:code 
        sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939
  apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

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

  10. Verwenden Sie apigee-service, um das Dienstprogramm apigee-setup zu aktualisieren: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  11. Führen Sie das Update-Dienstprogramm auf Ihrem Knoten aus, um die Postgres-Datenbank zu aktualisieren:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

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

  12. Postgres starten:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  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, die Sie für die Installation des Portals verwendet haben. Die einzige Anforderung an die Konfigurationsdatei ist, dass sie für den Nutzer „apigee“ zugänglich oder lesbar sein muss.

  14. Führen Sie das Drupal-Skript update.php 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ü Configuration (Konfiguration) aus.
    2. Wählen Sie auf der Seite Konfiguration unter Entwicklung die Option Wartungsmodus aus.
    3. Entfernen Sie das Häkchen bei Put site into maintenance mode (Website in den Wartungsmodus versetzen).
    4. Wählen Sie Konfiguration speichern aus.

Das Stammverzeichnis nach der Aktualisierung lautet:

/opt/apigee/apigee-drupal/wwwroot

Das Upgrade ist jetzt abgeschlossen.