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

Developer Services Portal Version 4.17.05

In diesem Verfahren wird beschrieben, wie Sie ein Upgrade eines vorhandenen Apigee Developer Channel Services durchführen. eine On-Premise-Installation vor.

<ph type="x-smartling-placeholder">

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 ist.
  • /opt/apigee/apigee-service/bin/apigee-all Status
    Wenn Sie Nginx/Postgres verwenden, wird die folgende Ausgabe angezeigt:

    + Apigee-Dienst Apigee-drupal-Devportal-Status
    OK: Apigee-drupal-devportal ist einsatzbereit
    + 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:

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

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

Neu Standardinstallationsverzeichnis nach der Aktualisierung von Nginx/Postgres auf die neue Version 4.17.01 Installation

Nach der Aktualisierung einer Neuinstallation von 4.17.01, die Nginx/Postgres verwendet, geändert von:

/opt/apigee/apigee-drupal

in

/opt/apigee/apigee-drupal/wwwroot

Unterstützte Upgrade-Versionen

Dieses Upgrade-Verfahren wird für die folgenden Portalversionen 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 zum Ermitteln Ihrer Portalversion die folgende URL in einem Browser:

http://yourportal.com/buildInfo

<ph type="x-smartling-placeholder">

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, möglicherweise an .htaccess vorgenommen. Sie sollten davon ausgehen, dass alles außerhalb des Verzeichnisses /sites Drupal gehört. Eine eine Ausnahme von dieser Regel ist die robots.txt-Datei. ob diese Datei im Web vorhanden ist wird es für Sie aufbewahrt.

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 mithilfe einer TAR-Datei upgraden

  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/. <ph type="x-smartling-placeholder">
      </ph>
    1. Option 1: Drush verwenden

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

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

      Zwischen der Option -p und dem Passwort darf kein Leerzeichen stehen. Einzeln Anführungszeichen um das Passwort sind erforderlich, wenn das Passwort Sonderzeichen enthält.

      Sie legen USERNAME und DATABASENAME fest. bei der Installation des Portals. Standardmäßig sind beide „devportal“.
  2. Erstellen Sie eine Sicherung Ihres gesamten Drupal-Webstammverzeichnisses. Der Standardspeicherort ist /var/www/html, Sie könnten jedoch die es bei der Installation geändert hat.
  3. Developer Channel Services DeveloperServices_x.y.z.tar herunterladen Datei von ftp.apigee.com, wobei x.y.z entspricht der Versionsnummer des Portals. Geben Sie bei Aufforderung die Anmeldedaten ein, die Sie erhalten haben. von Apigee.

    Sie können eine Datei über den Link herunterladen, den Sie von Apigee erhalten haben, in einem Browser oder indem Sie sie kopieren und Dann fügen Sie es dem folgenden cURL-Befehl hinzu:
    &gt; curl -kOL <Link einfügen here&gt;

    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 den Entwicklerkanal anzufordern. Dienste aktualisieren die TAR-Datei. Wenn Sie noch kein Konto im Supportportal haben, wählen Sie Melden Sie sich in Ihrem Supportportal an und wählen Sie dann auf der Anmeldeseite In einem Du hast es eilig? Erstellen Sie hier ein Support-Ticket.
  4. Upgrade auf einem Server mit Internetverbindung: <ph type="x-smartling-placeholder">
      </ph>
    1. Extrahieren Sie die Datei mit dem Portal-Upgrade:
      &gt; tar -xvf <tar file&gt;

      Mit diesem Extrahierungsbefehl wird ein neues Verzeichnis namens DeveloperServices-4.x.y.z erstellt.
    2. Wechseln Sie zu DeveloperServices-4.x.y.z. -Verzeichnis.
    3. Laden Sie die neueste Drupal-Version mit dem folgenden Befehl herunter:
      &gt; Drush dl drupal

      Dieser Befehl erstellt ein Verzeichnis namens drupal-x.y, wobei x.y dem aktuellen Version von Drupal.
    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 ausführen oder als Administrator.
    5. Um Benachrichtigungen über Drupal-Updates zu erhalten, muss der Drupal Update Manager -Modul ist aktiviert. Wählen Sie im Drupal-Menü Modules (Module) aus und scrollen Sie nach unten zu das Modul Update-Manager. Ist dies nicht der Fall, aktivieren Sie sie.

      Nach der Aktivierung können Sie die verfügbaren Updates über die Schaltfläche Berichte > Verfügbar Updates.

      Verwenden Sie die Funktion Berichte > Verfügbare Updates > Einstellungen, um konfigurieren Sie das Modul so, dass Sie per E-Mail benachrichtigt werden, wenn Updates verfügbar sind, und legen Sie fest, nach Updates suchen.
  5. Upgrade auf einem Server ohne Internetverbindung: <ph type="x-smartling-placeholder">
      </ph>
    1. Führen Sie auf dem Server, auf dem Sie die Developer Channel Services-Datei DeveloperServices_x.y.z.tar heruntergeladen haben, folgende Schritte aus: Extrahieren Sie die Datei für das Portal-Upgrade:
      > tar -xvf <tar file&gt;

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

      Mit diesem Befehl werden alle erforderlichen Updatedateien heruntergeladen und in einer einzigen Datei verpackt. namens devportal-update.tgz und schreibt die Datei an einen Speicherort Ihrer Wahl.
    4. devportal-update.tgz in das Ziel kopieren dem Server, auf dem das Portal läuft.
      Hinweis: Kopieren Sie die Datei devportal-update.tgz nicht in das Webstammverzeichnis von auf den Zielserver.
    5. Entpacken Sie die Datei devportal-update.tgz in der Aktuelles 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:
      &gt; ./install-update.sh
    8. Folgen Sie der Anleitung.

Die Umstellung ist jetzt abgeschlossen.

Portal mit RPMs upgraden

Gehen Sie wie folgt vor, um den Portal-RPM auf einem Knoten zu aktualisieren:

  1. Wechseln Sie zum Drupal-Verzeichnis /opt/apigee/apigee-drupal durch Standardeinstellung:
    &gt; 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 an, Den Datenbanknamen, wie im Attribut PG_NAME im Portal angegeben Konfigurationsdatei der Installation.
    • host gibt die IP-Adresse an. Adresse des Portalknotens.
    • username gibt den Postgres-Benutzernamen, der vom Portal für den Zugriff auf die Datenbank gemäß den Eigenschaft DRUPAL_PG_USER in der Konfigurationsdatei für die Portalinstallation.
    • Sie werden zur Eingabe des Postgres-Nutzerpassworts aufgefordert, wie in der Eigenschaft DRUPAL_PG_PASS im Konfigurationsdatei für die Portalinstallation.

    Wenn Sie später Daten aus der Sicherung wiederherstellen müssen, verwenden Sie den 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 es vielleicht geändert.

    Wenn Sie den Speicherort dieses Verzeichnisses nicht kennen, verwenden Sie den Befehl drush status oder die Konfiguration > Medien > Datei im Drupal-Menü, um die den Speicherort des öffentlichen Dateisystems und den Pfad des privaten Dateisystems (für den nächsten Schritt).
  4. Erstellen Sie eine Sicherung der Dateien in /opt/apigee/data/apigee-drupal-devportal/private.
  5. Deaktivieren Sie SELinux wie unter Installation von das Dienstprogramm „Edge Apigee-Setup“.
  6. Upgrade auf einem Server mit Internetverbindung: <ph type="x-smartling-placeholder">
      </ph>
    1. Laden Sie die Datei bootstrap_4.17.05.sh für Edge 4.17.05 nach /tmp/bootstrap_4.17.05.sh:
      > curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
    2. Installieren Sie das Dienstprogramm apigee-service von Edge 4.17.05 und Abhängigkeiten:
      > sudo Bash /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord

      Dabei steht uName:pWord für den Nutzernamen und das Passwort, die Sie 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.
  7. Upgrade auf einem Server ohne Internetverbindung: <ph type="x-smartling-placeholder">
      </ph>
    1. Erstellen Sie ein lokales 4.17.05-Repository, wie unter „Lokales Apigee-Repository erstellen“ beschrieben bei Installieren Sie das Edge-Apigee-Setup .
      Hinweis: Wenn Sie bereits ein 4.17.01-Repository haben, können Sie das 4.17.05 mit dem Repository verknüpft, wie unter „Lokales Apigee-Repository aktualisieren“ beschrieben finden Sie unter Edge-Apigee-Setup-Dienstprogramm installieren.
    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.17.05.tar.gz:
        > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror-Paket
      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“:
        &gt; TAR -XZF apigee-4.17.05.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 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: <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.17.05.sh herunter, /tmp/bootstrap_4.17.05.sh:
        > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh

        Dabei steht uName:pWord für den Nutzernamen und das Passwort, die Sie oben festgelegt haben. für das Repository. remoteRepo ist die IP-Adresse oder der DNS-Name der des Repository-Knotens.
      3. Installieren Sie auf dem Remote-Knoten das Edge-Dienstprogramm apigee-service und 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 für Aktualisieren Sie das apigee-setup Dienstprogramm:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  9. Führen Sie das Update-Dienstprogramm auf dem Knoten aus, um die Postgres-Datenbank zu aktualisieren:
    &gt; /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.
  10. Postgres starten:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  11. Führen Sie das Dienstprogramm für Updates auf dem Knoten aus, um das Portal zu aktualisieren:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile

    Dabei ist configFile die Konfigurationsdatei, die Sie für die Installation verwendet haben. zum Portal. Die einzige Anforderung an die Konfigurationsdatei ist, muss für den „Apigee“ zugänglich oder lesbar sein Nutzer.

Beachten Sie, dass das Stammverzeichnis nach der Aktualisierung jetzt wie folgt lautet:

/opt/apigee/apigee-drupal/wwwroot

Die Umstellung ist jetzt abgeschlossen.