Portal aktualisieren

Dieses Verfahren beschreibt, wie Sie ein vorhandenes Apigee Developer Services-Portal (oder einfach das Portal) lokal aktualisieren. Installation.

Das richtige Aktualisierungsverfahren bestimmen

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

Bestimmen 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, sehen Sie die folgenden Verzeichnisse: /opt/apigee und /opt/nginx.

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

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

    Wenn Sie NGINX/Postgres verwenden, sehen Sie die folgende Ausgabe:

    + 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 Portal 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 im Verfahren unten, um Ihr Installationsverzeichnis zu verwenden.

Unterstützte Upgrade-Versionen

Dieses Upgrade wird ab der Portalversion OPDK-17-01.x unterstützt.

Öffnen Sie zum Ermitteln Ihrer Portalversion die folgende URL in einem Browser:

http://yourportal.com/buildInfo

Vor der Aktualisierung

Wenn Sie bei vorhandenen Installationen Code in Drupal Core oder einem nicht benutzerdefinierten Code geändert haben werden Ihre Änderungen überschrieben. Dazu gehören u. a. alle Änderungen, die Sie möglicherweise an .htaccess gesendet 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.

Erstellen Sie vor der Installation eine Sicherung Ihres gesamten Drupal-Webstamms. -Verzeichnis. Nachdem Sie die unten beschriebenen Installationsschritte ausgeführt haben, können Sie Ihr aus dem Back-up.

Portal mit 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=host_IP_address --username=drupaladmin
      --password --format=c > /tmp/portal.dmp

    Wobei:

    • devportal ist der Datenbankname, wie in den PG_NAME in der Konfigurationsdatei für die Portalinstallation.
    • host_IP_address ist die IP-Adresse des Portalknotens.
    • drupaladmin ist der Postgres-Nutzername, der vom Portal für den Zugriff auf die Datenbank entsprechend dem Attribut DRUPAL_PG_USER in der Portalinstallation Konfigurationsdatei.

    Sie werden aufgefordert, das Postgres-Benutzerpasswort DRUPAL_PG_PASS in der Konfigurationsdatei für die Portalinstallation.

    Wenn Sie später aus der Sicherung wiederherstellen möchten, 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. Möglicherweise haben Sie den Wert 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: <ph type="x-smartling-placeholder">
      </ph>
    1. Wählen Sie Configuration (Konfiguration) im Drupal-Menü aus.
    2. Wählen Sie auf der Seite Konfiguration die Option Wartungsmodus aus. unter Entwicklung.
    3. Klicken Sie das Kästchen Website in Wartungsmodus versetzen an.
    4. Geben Sie eine Nachricht ein, die Nutzer während der Wartung sehen.
    5. Wählen Sie Konfiguration speichern aus.
  6. Deaktivieren Sie SELinux wie in Installieren Sie das Dienstprogramm Edge für die Einrichtung von Apigee.
  7. Wechseln Sie in das Verzeichnis /opt:
    cd /opt
  8. Upgrade auf einem Server mit Internetverbindung: <ph type="x-smartling-placeholder">
      </ph>
    1. Edge 4.51.00-Datei bootstrap_4.51.00.sh herunterladen nach /tmp/bootstrap_4.51.00.sh:
      curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
    2. Installieren Sie das Dienstprogramm apigee-service für Edge 4.51.00 und die Abhängigkeiten:
      sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

      Dabei sind uName und pWord der Nutzername und das Passwort, die Sie erhalten haben. von Apigee. 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 „C“ um ohne Installation von Java fortzufahren.

  9. Upgrade auf einem Server ohne Internetverbindung: <ph type="x-smartling-placeholder">
      </ph>
    1. Erstellen Sie ein lokales 4.51.00-Repository, wie in Lokales Apigee-Repository erstellen
    2. So installieren Sie den Apigee-Dienst aus einer TAR-Datei: <ph type="x-smartling-placeholder">
        </ph>
      1. Verwenden Sie auf dem Knoten mit dem lokalen Repository den folgenden Befehl, um das lokale Repository Repository in eine einzelne TAR-Datei namens /opt/apigee/data/apigee-mirror/apigee-4.51.00.tar.gz:
        /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
      2. Kopieren Sie die TAR-Datei in den Knoten, auf dem Sie Edge aktualisieren möchten. Zum Beispiel kopieren Sie 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.51.00.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.51.00.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: <ph type="x-smartling-placeholder">
        </ph>
      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.51.00.sh herunter, um /tmp/bootstrap_4.51.00.sh:
        /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.51.00.sh
          -o /tmp/bootstrap_4.51.00.sh

        Wobei uName und pWord der von Ihnen festgelegte Nutzername und das Passwort sind oben für das Repository, und remoteRepo ist die IP-Adresse oder der DNS-Name des Repository-Knoten.

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

        Dabei sind uName und pWord der Nutzername und das Passwort des Repositorys.

  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 Dienstprogramm update auf Ihrem Postgres-Knoten aus:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

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