Diese Seite wurde von der Cloud Translation API übersetzt.

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

Developer Services Portal Version 4.17.09

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

</ph> Hinweis: Bei allen neuen Installationen des Portals ab Version 4.17.01 wurde Postgres als der Datenbank und Nginx als Webserver. Frühere Versionen des Portals nutzen MySQL/MariaDB als Datenbank und Apache-Webserver Das bedeutet, dass Ihr aktuelles Portal Verwenden Sie eine der folgenden Konfigurationen: <ph type="x-smartling-placeholder">

Nginx/Postgres für alle neuen Installationen der Versionen 4.17.01 und 4.17.05
Apache/MySQL 5.0.15 oder höher für alle 6.x-Betriebssysteme, die auf 4.17.05 aktualisiert wurden
Aktualisierung von Apache/MariaDB 5.1.38 oder höher für alle 7.x-Betriebssysteme auf 4.17.05

Bevor Sie mit dem Aktualisierungsprozess beginnen, müssen Sie Ihre aktuelle Konfiguration ermitteln und dann und führen Sie den korrekten Aktualisierungsvorgang aus.

Die richtige Prozedur für die Aktualisierung bestimmen

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

Wenn Ihre Installation Nginx/Postgres verwendet, lesen Sie den Abschnitt Upgrade eines Portals mit RPMs unten.
Wenn Ihre Installation Apache/MySQL oder Apache/MariaDB verwendet, lesen Sie den Abschnitt Wandeln Sie TAR-basiertes Portal zu einem RPM-basierten Portal

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-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 Entwicklerportal 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-Verfahren wird für die folgenden Portalversionen unterstützt:

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

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

http://your_portal.com/buildInfo

</ph> Hinweis: Wenn Sie die Datei buildInfo aus irgendeinem Grund entfernt haben, gilt Folgendes: die Version anhand der profiles/apigee/apigee.info-Datei ermitteln kann. Die Der standardmäßige Installationsort ist /var/www/html/profiles/apigee/apigee.info, aber möglicherweise haben Sie es bei der Installation geändert, wenn Sie das Portal in einem anderen Verzeichnis installiert haben, als /var/www/html. Die Datei apigee.info enthält eine Zeile im Format unten mit der Version:

version = "OPDK-4.17.05"

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. 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 mit RPMs upgraden

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

Wechseln Sie in das Drupal-Verzeichnis. Beispiel: /opt/apigee/apigee-drupal/wwwroot.
```
cd /opt/apigee/apigee-drupal/wwwroot
```
Unter Standardinstallationsverzeichnis finden Sie das Standardverzeichnis von Ihre Produktversion.
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 den Datenbanknamen an, wie er im PG_NAME in der Konfigurationsdatei für die Portalinstallation.
- host gibt die IP-Adresse des Portalknotens an.
- username gibt den Postgres-Nutzernamen an, der vom Portal für den Zugriff auf die wie in der Eigenschaft DRUPAL_PG_USER im Konfigurationsdatei für die Portalinstallation.
- Sie werden aufgefordert, das Postgres-Benutzerpasswort DRUPAL_PG_PASS in der Konfigurationsdatei für die Portalinstallation.
Wenn Sie später Daten aus der Sicherung wiederherstellen müssen, verwenden Sie den folgenden Befehl:
```
pg_restore --clean --dbname=devportal --host=localhost  --username=apigee < /tmp/portal.dmp
```
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).
Sichern Sie die Dateien in /opt/apigee/data/apigee-drupal-devportal/private.
Setzen Sie Drupal in den Wartungsmodus: <ph type="x-smartling-placeholder">
1. Wählen Sie Configuration (Konfiguration) im Drupal-Menü aus.
2. Wählen Sie auf der Seite Konfiguration die Option Wartung Modus 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.
Deaktivieren Sie SELinux wie in Installieren Sie das Dienstprogramm Edge für die Einrichtung von Apigee.
Wechseln Sie in das Verzeichnis /opt:
```
cd /opt
```
Upgrade auf einem Server mit Internetverbindung: <ph type="x-smartling-placeholder">
1. Laden Sie die Edge 4.17.09-Datei bootstrap_4.17.09.sh herunter nach /tmp/bootstrap_4.17.09.sh:
```
curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
```
2. Installieren Sie das Dienstprogramm apigee-service für Edge 4.17.09 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 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.
Upgrade auf einem Server ohne Internetverbindung: <ph type="x-smartling-placeholder">
1. Erstellen Sie ein lokales 4.17.09-Repository, wie unter „Lokales Apigee-Repository erstellen“ beschrieben bei Edge installieren apigee-setup-Dienstprogramm.
  Hinweis: Wenn Sie bereits ein 4.17.05-Repository haben, können Sie das 4.17.09 mit dem Repository verknüpft, wie unter „Lokales Apigee-Repository aktualisieren“ beschrieben bei Install the Edge Dienstprogramms „Apigee-setup“.
2. So installieren Sie den Apigee-Dienst aus einer TAR-Datei: <ph type="x-smartling-placeholder">
  1. Verwenden Sie auf dem Knoten mit dem lokalen Repository den folgenden Befehl, um das lokale Repository Repository in eine einzelne TAR-Datei mit dem Namen /opt/apigee/data/apigee-mirror/apigee-4.17.09.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.17.09.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 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 Repository-Verzeichnis angeben.
3. So installieren Sie den Apigee-Dienst mit dem Nginx-Webserver: <ph type="x-smartling-placeholder">
  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.09.sh herunter, um /tmp/bootstrap_4.17.09.sh:
```
/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 festgelegt haben. für das Repository und 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 dependencies: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 des Repositorys.
Verwenden Sie apigee-service, um das apigee-setup-Dienstprogramm zu aktualisieren:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
```
Führen Sie das Update-Dienstprogramm auf dem 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 zum Installieren Postgres-Datenbank. Die einzige Anforderung an die Konfigurationsdatei ist, dass die Konfigurationsdatei Datei muss vom „Apigee“ zugänglich oder lesbar sein Nutzer.

Postgres starten:

/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start

Führen Sie das Update-Dienstprogramm auf dem 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 zum Installieren zum Portal. Die einzige Anforderung an die Konfigurationsdatei ist, muss für den „Apigee“ zugänglich oder lesbar sein Nutzer.
Führen Sie das update.php-Skript von Drupal aus, indem Sie die folgende URL in einem Browserfenster öffnen:
```
http://portalIP_DNS:8079/update.php
```
Deaktivieren Sie Drupal in den Wartungsmodus: <ph type="x-smartling-placeholder">
1. Wählen Sie Configuration (Konfiguration) im Drupal-Menü aus.
2. Wählen Sie auf der Seite Konfiguration die Option Wartung Modus unter Entwicklung.
3. Heben Sie die Auswahl des Kästchens Website in Wartungsmodus versetzen auf.
4. Wählen Sie Konfiguration speichern aus.

Nach der Aktualisierung sieht das Stammverzeichnis folgendermaßen aus:

/opt/apigee/apigee-drupal/wwwroot

Die Umstellung ist jetzt abgeschlossen.