Diese Seite wurde von der Cloud Translation API übersetzt.

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

Entwicklerdienstportal Version 4.17.09

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:

Wenn Sie für Ihre Installation Nginx/Postgres verwenden, lesen Sie den Abschnitt Portal mit RPMs aktualisieren weiter unten.
Wenn Ihre Installation Apache/MySQL oder Apache/MariaDB verwendet, lesen Sie die Informationen unter Tar-basiertes Portal in RPM-basiertes Portal konvertieren.

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, sehen Sie die folgenden Verzeichnisse: /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, 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 das Webstammverzeichnis des Portals in folgendem Format zurückgeben:
```
*: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:

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

Unterstützte Upgradeversionen

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

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

Um Ihre Portalversion zu ermitteln, öffnen Sie die folgende URL in einem Browser:

http://your_portal.com/buildInfo

Hinweis:Falls Sie die Datei buildInfo aus irgendeinem Grund entfernt haben, können Sie die Version in der Datei profiles/apigee/apigee.info ermitteln. Der Standardspeicherort für die Installation ist /var/www/html/profiles/apigee/apigee.info. Möglicherweise haben Sie ihn aber bei der Installation geändert, wenn Sie das Portal in einem anderen Verzeichnis als /var/www/html installiert haben. Die Datei apigee.info enthält eine Zeile im folgenden Format mit der Version:

version = "OPDK-4.17.05"

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 ist robots.txt. Wenn diese Datei im Webstamm vorhanden ist, wird sie für Sie 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 eines Portals mithilfe von RPMs

So aktualisieren Sie den Portal-RPM auf einem Knoten:

Wechseln Sie zum Drupal-Verzeichnis. Beispiel: /opt/apigee/apigee-drupal/wwwroot.
```
cd /opt/apigee/apigee-drupal/wwwroot
```
Unter Standardinstallationsverzeichnis finden Sie das Standardverzeichnis Ihrer Produktversion.
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.dmp
```
Dabei gilt:
- dbname gibt den Datenbanknamen an, wie mit dem Attribut PG_NAME in der Konfigurationsdatei der Portalinstallation 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 im Attribut DRUPAL_PG_USER in der Konfigurationsdatei für die Portalinstallation angegeben.
- Sie werden aufgefordert, das Passwort des Postgres-Nutzers einzugeben, wie es in der Konfigurationsdatei der Portalinstallation im Attribut DRUPAL_PG_PASS 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
```
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 Konfiguration > Medien > Datei im Drupal-Menü, um den Speicherort des öffentlichen Dateisystems und des privaten Dateisystems (für den nächsten Schritt) zu ermitteln.
Erstelle eine Sicherung der Dateien in /opt/apigee/data/apigee-drupal-devportal/private.
Legen Sie für Drupal den Wartungsmodus fest:
1. Wählen Sie im Drupal-Menü Konfiguration aus.
2. Wählen Sie auf der Seite Konfiguration unter Entwicklung die Option Wartungsmodus aus.
3. Klicken Sie auf das Kästchen Versetzen Sie die Website in den Wartungsmodus.
4. Geben Sie eine Nachricht ein, die Nutzer während der Wartung sehen.
5. Wählen Sie Konfiguration speichern aus.
Deaktivieren Sie SELinux wie unter Das Edge-Dienstprogramm für die Apigee-Einrichtung installieren beschrieben.
Wechseln Sie zum Verzeichnis /opt:
```
cd /opt
```
Für ein Upgrade auf einem Server mit einer Internetverbindung:
1. Laden Sie die Datei bootstrap_4.17.09.sh von Edge 4.17.09 in /tmp/bootstrap_4.17.09.sh herunter:
```
curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
```
2. Installieren Sie das apigee-service-Dienstprogramm von 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 erhalten haben. Wenn Sie pWord weglassen, 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.
Für ein Upgrade auf einem Server ohne Internetverbindung:
1. Erstellen Sie ein lokales 4.17.09-Repository, wie in „Lokales Apigee-Repository erstellen“ unter Dienstprogramm für Edge Apigee-Setup installieren beschrieben.
  Hinweis: Wenn Sie bereits ein 4.17.05-Repository haben, können Sie das 4.17.09-Repository 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.09.tar.gz zu verpacken:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
```
  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 Verzeichnis „/tmp“:
```
tar -xzf apigee-4.17.09.tar.gz
```
    Mit diesem Befehl wird in dem Verzeichnis, das die TAR-Datei enthält, ein neues Verzeichnis namens repos erstellt. 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 den Pfad zum Repository-Verzeichnis in diesen Befehl aufnehmen.
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-bootstrap_4.17.09.sh-Datei in /tmp/bootstrap_4.17.09.sh herunter:
```
/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 für das Repository festgelegt haben, und remoteRepo die IP-Adresse oder der DNS-Name des Repository-Knotens.
  3. Installieren Sie auf dem Remote-Knoten das Edge-Dienstprogramm apigee-service und Abhängigkeiten: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 Dienstprogramm apigee-setup zu aktualisieren:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
```
Führen Sie das Dienstprogramm zur Aktualisierung 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, 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.

Postgres starten:

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

Führen Sie das Dienstprogramm zur Aktualisierung 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, 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.
Führen Sie das Drupal-Skript update.php aus. Öffnen Sie dazu die folgende URL in einem Browserfenster:
```
http://portalIP_DNS:8079/update.php
```
Deaktivieren Sie Drupal im Wartungsmodus:
1. Wählen Sie im Drupal-Menü Konfiguration aus.
2. Wählen Sie auf der Seite Konfiguration unter Entwicklung die Option Wartungsmodus aus.
3. Entfernen Sie das Häkchen neben Website in Wartungsmodus versetzen.
4. Wählen Sie Konfiguration speichern aus.

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

/opt/apigee/apigee-drupal/wwwroot

Die Umstellung ist jetzt abgeschlossen.