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

Entwicklerdienstportal Version 4.17.05

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

Richtiges Update-Verfahren bestimmen

Das Verfahren, mit dem Sie das Portal aktualisieren, hängt von Ihrer aktuellen Installation ab:

Aktuellen Installationstyp ermitteln

Wenn Sie Ihren aktuellen Installationstyp nicht kennen, 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 ist aktiv



  • apachectl -S
    Wenn Sie Apache/MySQL oder Apache/MariaDB verwenden, sollte mit diesem Befehl das Webstammverzeichnis des Portals in folgendem Format zurückgegeben werden:

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

Standardinstallationsverzeichnis

Beim Upgradeprozess 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 so, dass Ihr Installationsverzeichnis verwendet wird.

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

Neues Standardinstallationsverzeichnis nach einem Update von Nginx/Postgres von einer neuen Installation mit Version 4.17.01

Nach der Aktualisierung einer Neuinstallation von Version 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 Upgradeversionen

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

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 im Drupal-Kern oder in einem nicht benutzerdefinierten Modul 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 alle Inhalte außerhalb des Verzeichnisses /sites zu Drupal gehören. Eine Ausnahme von dieser Regel stellt robots.txt dar. Wenn diese Datei im Webstamm vorhanden ist, wird sie für dich beibehalten.

Erstelle eine Sicherung deines gesamten Drupal-Webstammverzeichnisses, bevor du mit der Installation fortfährst. Nachdem Sie die unten beschriebenen Installationsschritte ausgeführt haben, können Sie Ihre Anpassungen aus der Sicherung wiederherstellen.

Upgrade des Portals mithilfe einer TAR-Datei durchführen

  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 standardmäßig in Ihrem Drupal-Verzeichnis, /var/www/html, folgenden Befehl aus:
      > drush sql-dump > /path/to/backup_dir/database-backup.sql

      Verwenden Sie drush help sql-dump, um weitere Informationen zu erhalten.
    2. Option 2: MySQLdump verwenden
      Erstellen Sie mit dem Befehl mysqldump eine Kopie der Datenbank:
      mysqldump -u NUTZERNAME -p'PASSWORT' DATABASENAME > /path/to/backup_dir/database-backup.sql

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

      Sie haben den NUTZERNAME und den DATENBASENAME bei der Installation des Portals festgelegt. Standardmäßig sind beide devportal.
  2. Erstellen Sie eine Sicherung Ihres gesamten Drupal-Webstammverzeichnisses. Der Standardinstallationspfad ist /var/www/html, aber Sie haben ihn möglicherweise bei der Installation geändert.
  3. Laden Sie die Developer Channel Services-Datei DeveloperServices_x.y.z.tar von ftp.apigee.com herunter, wobei x.y.z der Versionsnummer des Portals entspricht. Wenn Sie dazu aufgefordert werden, geben Sie 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. Alternativ können Sie sie kopieren und dann dem folgenden cURL-Befehl hinzufügen:
    > curl -kOL <Link hier einfügen>

    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 Apigee Edge-Support auf und wählen Sie Im Supportportal anmelden aus, um die TAR-Datei für das Upgrade der Entwicklerkanaldienste anzufordern. Wenn Sie kein Konto im Supportportal haben, wählen Sie Im Supportportal anmelden und dann auf der Anmeldeseite Du hast es eilig? Erstellen Sie hier ein Support-Ticket.
  4. Für ein Upgrade auf einem Server mit einer Internetverbindung:
    1. Extrahieren Sie die Datei für das Portalupgrade:
      > tar -xvf <tar file>

      Mit diesem Befehl wird ein neues Verzeichnis namens DeveloperServices-4.x.y.z erstellt.
    2. Wechseln Sie zum Verzeichnis DeveloperServices-4.x.y.z.
    3. Laden Sie mit folgendem Befehl die neueste Drupal-Version herunter:
      > drush dl drupal

      Dieser Befehl erstellt ein Verzeichnis namens drupal-x.y, 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 entweder mit „sudo“ oder als Administrator ausführen.
    5. Um Benachrichtigungen über Drupal-Updates zu erhalten, muss das Drupal-Update-Manager-Modul aktiviert sein. Wählen Sie im Drupal-Menü Module (Module) aus und scrollen Sie nach unten zum Modul Update Manager (Aktualisierungsmanager). Ist dies nicht der Fall, aktivieren Sie es.

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

      Verwenden Sie das Menü Berichte > Verfügbare Updates > Einstellungen, um das Modul so zu konfigurieren, dass Sie per E-Mail benachrichtigt werden, wenn Updates verfügbar sind, und legen Sie die Häufigkeit der Suche nach Updates fest.
  5. Für ein Upgrade auf einem Server ohne Internetverbindung:
    1. Extrahieren Sie auf dem Server, auf dem Sie die Developer Channel Services-Datei DeveloperServices_x.y.z.tar heruntergeladen haben, die Portalupgrade-Datei:
      > tar -xvf <tar file>

      Mit diesem Extrahierungsbefehl wird ein neues Verzeichnis namens DeveloperServices-4.x.y.z erstellt.
    2. Wechseln Sie zum 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 entweder mit „sudo“ oder als Administrator ausführen.

      Mit diesem Befehl werden alle erforderlichen Updatedateien heruntergeladen, in eine einzige Datei namens devportal-update.tgz verpackt und an einen Speicherort Ihrer Wahl geschrieben.
    4. Kopieren Sie devportal-update.tgz auf den Zielserver, auf dem das Portal ausgeführt wird.
      Hinweis: Kopieren Sie nicht die Datei devportal-update.tgz in das Webstammverzeichnis des Zielservers.
    5. Entpacken Sie die Datei devportal-update.tgz im aktuellen Verzeichnis:
      > tar -xzf /path/to/devportal-update.tgz
    6. Wechseln Sie zum Verzeichnis developer-update.
    7. Führen Sie den folgenden Befehl aus, um das Update zu installieren:
      > ./install-update.sh
    8. Beantworte die Aufforderungen.

Die Umstellung ist jetzt abgeschlossen.

Upgrade eines Portals mithilfe von RPMs

So aktualisieren Sie den Portal-RPM auf einem Knoten:

  1. Wechseln Sie standardmäßig in das Drupal-Verzeichnis, /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=192.168.56.101 --username=drupaladmin --password --format=c > /tmp/portal.

    • dbname gibt den Datenbanknamen an, wie in der Konfigurationsdatei der Portalinstallation mit dem Attribut PG_NAME angegeben.
    • 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 in der Eigenschaft DRUPAL_PG_USER in der Konfigurationsdatei der Portalinstallation angegeben.
    • Sie werden aufgefordert, das Passwort des Postgres-Nutzers einzugeben, das in der Konfigurationsdatei der Portalinstallation in der Eigenschaft DRUPAL_PG_PASS definiert ist.

    Wenn Sie eine Wiederherstellung aus der Sicherung später 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 Ihres gesamten Drupal-Webstammverzeichnisses. Der Standardinstallationsort ist /opt/apigee/apigee-drupal, aber Sie haben ihn möglicherweise geändert.

    Wenn Sie sich nicht sicher sind, wo dieses Verzeichnis gespeichert ist, verwenden Sie den Befehl drush status oder den Eintrag Configuration > Media > File (Konfiguration > Medien > Datei) im Drupal-Menü, um den Speicherort des öffentlichen Dateisystems und 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 Das Edge-Dienstprogramm für die Apigee-Einrichtung installieren beschrieben.
  6. Für ein Upgrade auf einem Server mit einer Internetverbindung:
    1. Laden Sie die Datei Edge 4.17.05 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.
    2. Installieren Sie das Edge 4.17.05-Dienstprogramm apigee-service und Abhängigkeiten:
      > sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord

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

      Das Installationsprogramm prüft standardmäßig, ob Java 1.8 installiert ist. Mit der Option „C“ können Sie fortfahren, ohne Java zu installieren.
  7. Für ein Upgrade auf einem Server ohne Internetverbindung:
    1. Erstellen Sie ein lokales 4.17.05-Repository, wie in „Lokales Apigee-Repository erstellen“ unter Dienstprogramm für Edge-Apigee-Setup installieren beschrieben.
      Hinweis: Wenn Sie bereits ein Repository mit der Version 4.17.01 haben, können Sie das Repository 4.17.05 hinzufügen, wie unter „Lokales Apigee-Repository aktualisieren“ unter Dienstprogramm für Edge Apigee-Setup installieren beschrieben.
    2. So installieren Sie den Apigee-Dienst aus einer TAR-Datei:
      1. Verwenden Sie auf dem Knoten mit dem lokalen Repository den folgenden Befehl, um das lokale Repository in eine einzelne TAR-Datei namens /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz zu verpacken:
        > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror-Paket
      2. Kopieren Sie die TAR-Datei auf den Knoten, in dem Sie Edge aktualisieren möchten. Kopieren Sie ihn beispielsweise in das Verzeichnis /tmp auf dem neuen Knoten.
      3. Entpacken Sie die Datei auf dem neuen Knoten in das /tmp-Verzeichnis:
        > tar -xzf apigee-4.17.05.tar.gz

        Dieser Befehl erstellt ein neues Verzeichnis namens repos in dem Verzeichnis, das die .tar-Datei enthält. Beispiel: /tmp/repos.
      4. Installieren Sie das Edge-Dienstprogramm apigee-service und Abhängigkeiten aus /tmp/repos:
        > sudo bash /tmp/repos/bootstrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

        Beachten Sie, dass Sie in diesem Befehl den Pfad zum Repository-Verzeichnis angeben.
    3. So installieren Sie den Apigee-Dienst mit dem Nginx-Webserver:
      1. Konfigurieren Sie den Nginx-Webserver wie unter „Vom Repository mithilfe des Nginx-Webservers installieren“ unter Das Edge-Dienstprogramm Apigee-Setup 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.05.sh ist remoteRepo:3939/sh_bootstrap_4.17.

      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 apigeeName=http://
        sind
  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 Aktualisierungsdienstprogramm auf dem Knoten aus, um die Postgres-Datenbank zu aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

    , wobei configFile die Konfigurationsdatei ist, mit der Sie die Postgres-Datenbank installiert haben. Die einzige Anforderung an die Konfigurationsdatei besteht darin, dass die Konfigurationsdatei für den „apigee“-Benutzer 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 Aktualisierungsdienstprogramm auf dem Knoten aus, um das Portal zu aktualisieren:
    > /opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile

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

Beachten Sie, dass das Stammverzeichnis von nach dem Update jetzt wie folgt lautet:

/opt/apigee/apigee-drupal/wwwroot

Die Umstellung ist jetzt abgeschlossen.