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

Developer Services Portal v. 4.17.05

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 Web-Stammverzeichnis 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:

  • /opt/apigee/apigee-drupal (Nginx)
  • /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.

Wenn Sie das Installationsverzeichnis nicht kennen, können Sie es wie unter Häufig verwendete Drush-Befehle beschrieben ermitteln.

Neues Standardinstallationsverzeichnis nach der Aktualisierung von Nginx/Postgres aus einer neuen 4.17.01-Installation

Nach dem Aktualisieren einer neuen Installation von 4.17.01, die Nginx/Postgres verwendet, hat sich das Stammverzeichnis geändert von:

/opt/apigee/apigee-drupal

in

/opt/apigee/apigee-drupal/wwwroot

Unterstützte Upgrade-Versionen

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

  • pantheon-14.02.x
  • pantheon-14.03.x
  • pantheon-14.04.x
  • pantheon-14.07.x
  • pantheon-15-01.x
  • OPDK-15-04.x
  • OPDK-15-07.x
  • OPDK-16-01.x
  • OPDK-16-05.x
  • OPDK-16-09.x
  • OPDK-17-01.x

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

http://yourportal.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 du möglicherweise an .htaccess vorgenommen hast. Sie sollten davon ausgehen, dass alles außerhalb des Verzeichnisses /sites Drupal gehört. Eine Ausnahme von dieser Regel ist robots.txt. Wenn diese Datei im Webstammverzeichnis vorhanden ist, wird 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 des Portals mit einer TAR-Datei

  1. Sichern Sie Ihre Drupal-MySQL/MariaDB-Instanz.
    Weitere Informationen finden Sie unter http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/.
    1. Option 1: Drush verwenden

      Der Drush-Befehl sql-dump erstellt eine Kopie der Datenbank. Führen Sie im Drupal-Verzeichnis (standardmäßig /var/www/html) den folgenden Befehl aus:
      > drush sql-dump > /path/to/backup_dir/database-backup.sql

      Weitere Informationen erhalten Sie mit drush help sql-dump.
    2. Option 2: MySQLdump verwenden
      Verwenden Sie den Befehl mysqldump, um eine Kopie der Datenbank zu erstellen:
      mysqldump -u USERNAME -p'PASSWORD' DATABASENAME > /path/to/backup_dir/database-backup.sql

      Zwischen der Option -p und dem Passwort darf kein Leerzeichen stehen. Wenn das Passwort Sonderzeichen enthält, muss es in einfache Anführungszeichen gesetzt werden.

      Sie haben den USERNAME und den DATABASENAME bei der Installation des Portals festgelegt. Standardmäßig sind beide devportal.
  2. Erstellen Sie eine Sicherung des gesamten Drupal-Webstammverzeichnisses. Der Standardinstallationsort ist /var/www/html, aber Sie haben ihn möglicherweise bei der Installation geändert.
  3. Laden Sie die Datei DeveloperServices_x.y.z.tar für die Entwicklerportaldienste von ftp.apigee.com herunter, wobei x.y.z der Versionsnummer des Portals entspricht. Geben Sie bei entsprechender Aufforderung die Anmeldedaten ein, die Sie von Apigee erhalten haben.

    Sie können eine Datei über den Link herunterladen, den Sie von Apigee in einem Browser erhalten haben, oder indem Sie sie kopieren und dann dem folgenden cURL-Befehl hinzufügen:
    > curl -kOL <paste link here>

    Hinweis: Wenn sich Ihr Portal auf einem Server ohne externe Internetverbindung befindet, führen Sie diesen Schritt auf einem Server mit Zugriff aus.

    Rufen Sie den Apigee Edge-Support auf und wählen Sie Im Supportportal anmelden aus, um die TAR-Datei für das Upgrade der Developer Channel-Dienste anzufordern. Wenn Sie kein Konto im Supportportal haben, wählen Sie Im Supportportal anmelden und dann auf der Anmeldeseite In Eile? Hier können Sie ein Support-Ticket erstellen.
  4. Für ein Upgrade auf einem Server mit Internetverbindung:
    1. Extrahieren Sie die Upgrade-Datei für das Portal:
      > tar -xvf <tar-Datei>

      Mit diesem Befehl wird ein neues Verzeichnis mit dem Namen DeveloperServices-4.x.y.z erstellt.
    2. Wechseln Sie in das Verzeichnis DeveloperServices-4.x.y.z.
    3. Laden Sie die neueste Drupal-Version mit dem folgenden Befehl herunter:
      > drush dl drupal

      Mit diesem Befehl wird ein Verzeichnis mit dem Namen „drupal-x.y“ erstellt, wobei „x.y“ der aktuellen Version von Drupal entspricht.
    4. Führen Sie das Skript networked-update.sh aus:
      > ./networked-update.sh

      Je nach Dateiberechtigungen müssen Sie diesen Befehl möglicherweise mit sudo oder als Administrator ausführen.
    5. Wenn Sie Benachrichtigungen zu Drupal-Updates erhalten möchten, muss das Drupal-Update-Manager-Modul aktiviert sein. Wählen Sie im Drupal-Menü Module aus und scrollen Sie nach unten zum Modul Update Manager. Wenn sie nicht aktiviert ist, aktivieren Sie sie.

      Nach der Aktivierung können Sie die verfügbaren Updates über den Menüpunkt Berichte > Verfügbare Updates aufrufen.

      Über den Menüpunkt Berichte > Verfügbare Aktualisierungen > Einstellungen können Sie das Modul so konfigurieren, dass Sie per E-Mail benachrichtigt werden, wenn Updates verfügbar sind. Außerdem können Sie festlegen, wie oft nach Updates gesucht werden soll.
  5. Für ein Upgrade auf einem Server ohne Internetverbindung:
    1. Extrahieren Sie auf dem Server, auf dem Sie die Datei DeveloperServices_x.y.z.tar für die Developer Channel Services heruntergeladen haben, die Portal-Upgrade-Datei:
      > tar -xvf <tar file>

      Durch diesen Befehl wird ein neues Verzeichnis mit dem Namen DeveloperServices-4.x.y.z erstellt.
    2. Wechseln Sie in das Verzeichnis DeveloperServices-4.x.y.z.
    3. Führen Sie das Skript non-networked-update.sh aus:
      > ./non-networked-update.sh

      Je nach Dateiberechtigungen müssen Sie diesen Befehl möglicherweise mit sudo oder als Administrator ausführen.

      Mit diesem Befehl werden alle erforderlichen Updatedateien heruntergeladen und in einer einzigen Datei mit dem Namen devportal-update.tgz zusammengefasst. Die Datei wird an einem Speicherort Ihrer Wahl gespeichert.
    4. Kopieren Sie devportal-update.tgz auf den Zielserver, auf dem das Portal ausgeführt wird.
      Hinweis: Kopieren Sie die Datei devportal-update.tgz nicht in das Webstammverzeichnis des Zielservers.
    5. Entpacken Sie die Datei devportal-update.tgz in das aktuelle Verzeichnis:
      > tar -xzf /path/to/devportal-update.tgz
    6. Wechseln Sie in das Verzeichnis developer-update.
    7. Führen Sie den folgenden Befehl aus, um das Update zu installieren:
      > ./install-update.sh
    8. Beantworte die Fragen.

Das Upgrade ist jetzt abgeschlossen.

Upgrade eines Portals mit RPMs

So aktualisieren Sie das 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. Der Befehl pg_dump erstellt eine Kopie der Datenbank:

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

    Wobei:
    • dbname gibt den Datenbanknamen an, wie er durch das Attribut PG_NAME in der Konfigurationsdatei für die Portalinstallation angegeben ist.
    • host gibt die IP-Adresse des Portalknotens an.
    • username gibt den Postgres-Nutzernamen an, der vom Portal für den Zugriff auf die Datenbank verwendet wird, wie durch das 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. Deaktivieren Sie SELinux, wie unter Edge-Dienstprogramm „apigee-setup“ installieren beschrieben.
  6. Für ein Upgrade auf einem Server mit Internetverbindung:
    1. Laden Sie die Edge 4.17.05-Datei bootstrap_4.17.05.sh in /tmp/bootstrap_4.17.05.sh herunter:
      > curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
    2. Installieren Sie das Edge 4.17.05-Dienstprogramm apigee-service und die Abhängigkeiten:
      > sudo bash /tmp/bootstrap_4.17.05.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.

      Standardmäßig prüft das Installationsprogramm, ob Java 1.8 installiert ist. Sie können die Option „C“ verwenden, um ohne Installation von Java fortzufahren.
  7. Für ein Upgrade auf einem Server ohne Internetverbindung:
    1. Erstellen Sie ein lokales 4.17.05-Repository, wie unter Edge-Dienstprogramm „apigee-setup“ installieren im Abschnitt „Lokales Apigee-Repository erstellen“ beschrieben.
      Hinweis: Wenn Sie bereits ein 4.17.01-Repository haben, können Sie das 4.17.05-Repository hinzufügen, wie unter „Lokales Apigee-Repository aktualisieren“ im Abschnitt 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.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 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.05.tar.gz

        Mit diesem Befehl wird ein neues Verzeichnis mit dem Namen „repos“ in dem Verzeichnis erstellt, das die TAR-Datei enthält. Beispiel: /tmp/repos.
      4. Installieren Sie das Edge-Dienstprogramm apigee-service und die Abhängigkeiten aus /tmp/repos:
        > sudo bash /tmp/repos/bootstrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

        Beachten Sie, dass Sie den Pfad zum Repos-Verzeichnis in diesen Befehl einfügen.
    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.05.sh in /tmp/bootstrap_4.17.05.sh herunter:
        > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.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:
        > sudo bash /tmp/bootstrap_4.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

        Dabei sind uName:pWord der Nutzername und das Passwort des Repositorys.
  8. Verwenden Sie apigee-service, um das Dienstprogramm apigee-setup zu aktualisieren:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  9. 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 zur 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.
  10. Starten Sie Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  11. Führen Sie das Aktualisierungsprogramm 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 zur 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.

Das Stammverzeichnis nach dem Update lautet jetzt:

/opt/apigee/apigee-drupal/wwwroot

Das Upgrade ist jetzt abgeschlossen.