Diese Seite wurde von der Cloud Translation API übersetzt.

Portal aktualisieren

Edge for Private Cloud v4.18.05

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

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, verwenden Sie Unten wird ein Upgrade eines Portals mit RPMs beschrieben.
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 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-Verfahren wird für die folgenden Portalversionen unterstützt:

OPDK-17-01.x
OPDK-17-05.x
OPDK-17-09.x
OPDK-18-01.x

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

http://yourportal.com/buildInfo

Hinweis:Falls Sie die buildInfo ist, können Sie festlegen, Version aus der Datei profiles/apigee/apigee.info. 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 ein im unten stehenden Formular, das die Version enthält:

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. 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:

Wechseln Sie zum Drupal-Verzeichnis, /opt/apigee/apigee-drupal durch Standardeinstellung:
```
cd /opt/apigee/apigee-drupal
```
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
```
Dabei gilt:
- 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 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. 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).
TIPP: Prüfen Sie vor dem Sichern, ob das Ziel der Sicherung ist ein Softlink (oder symbolischer Link) zu den eigentlichen Dateien. Suchen Sie dazu nach dem Dateityp l, wenn Sie den Inhalt eines Verzeichnisses auflisten. Im folgenden Beispiel enthält der erste und dritte Verzeichnisse sind symbolische Links (der Dateityp wird am Anfang des Berechtigungsliste)
```
ls -l /opt/apigee
drwxr-xr-x. 16 apigee   apigee  195 Jan 29 15:49 edge-qpid-server-4.19.01-0.0.20013
lrwxrwxrwx.  1 apigee   apigee   41 Jan 12 08:18 edge-router -> /opt/apigee/edge-router-4.19.01-0.0.20013
drwxr-xr-x. 15 apigee   apigee  195 Jan 29 15:50 edge-router-4.19.01-0.0.20013
lrwxrwxrwx.  1 apigee   apigee   37 Jan  9 17:13 edge-ui -> /opt/apigee/edge-ui-4.19.01-0.0.20115
```
Wenn das Ziel, das Sie sichern möchten, ein Softlink ist, sollten Sie die Links entfernen um den eigentlichen Inhalt zu sichern. Die Vorgehensweise hängt davon ab, mit welchem Tool Sie den Back-up. Wenn Sie beispielsweise tar verwenden, nutzen Sie die Option -h wie Das folgende Beispiel zeigt:
```
tar -hcfz /etc/my-drupal-backup.tar.gz /opt/apigee/apigee-drupal
```
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 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.
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. Edge 4.18.05-Datei bootstrap_4.18.05.sh herunterladen nach /tmp/bootstrap_4.18.05.sh:
```
curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
```
2. Installieren Sie das Dienstprogramm apigee-service für Edge 4.18.05 und die Abhängigkeiten:
```
sudo bash /tmp/bootstrap_4.18.05.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.
Upgrade auf einem Server ohne Internetverbindung: <ph type="x-smartling-placeholder">
1. Erstellen Sie ein lokales 4.18.05-Repository, wie in Lokales Apigee-Repository erstellen
  Hinweis: Wenn Sie bereits ein 4.18.01-Repository haben, können Sie das Repository 4.18.05 hinzufügen, wie unter „Lokales Apigee-Repository aktualisieren“ beschrieben. bei Installieren Sie das Dienstprogramm für das Edge-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 namens /opt/apigee/data/apigee-mirror/apigee-4.18.05.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.18.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 die Abhängigkeiten aus /tmp/repos:
```
sudo bash /tmp/repos/bootstrap_4.18.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">
  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.18.05.sh herunter, um /tmp/bootstrap_4.18.05.sh:
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.05.sh
  -o /tmp/bootstrap_4.18.05.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.18.05.sh apigeerepohost=remoteRepo:3939
  apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
```
    Dabei sind uName und 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 Ihrem Postgre-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.

Aktualisieren Sie die Postgres-Datenbank:

/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade

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 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.
Führen Sie das update.php-Skript von Drupal aus, indem Sie die folgende URL in einem Browserfenster öffnen:
```
http://portal_IP_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 Wartungsmodus aus. 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.