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:
- 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 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 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:
- Wechseln Sie zum Drupal-Verzeichnis, standardmäßig
/opt/apigee/apigee-drupal
: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
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
- devportal ist der Datenbankname, wie in den
- 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). - Sichern Sie die Dateien in
/opt/apigee/data/apigee-drupal-devportal/private
. - Setzen Sie Drupal in den Wartungsmodus:
<ph type="x-smartling-placeholder">
- </ph>
- Wählen Sie Configuration (Konfiguration) im Drupal-Menü aus.
- Wählen Sie auf der Seite Konfiguration die Option Wartungsmodus aus. unter Entwicklung.
- Klicken Sie das Kästchen Website in Wartungsmodus versetzen an.
- Geben Sie eine Nachricht ein, die Nutzer während der Wartung sehen.
- 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">
- </ph>
- Laden Sie die Edge 4.19.06-Datei
bootstrap_4.19.06.sh
herunter nach/tmp/bootstrap_4.19.06.sh
:curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
- Installieren Sie das Dienstprogramm
apigee-service
für Edge 4.19.06 und die Abhängigkeiten:sudo bash /tmp/bootstrap_4.19.06.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.
- Laden Sie die Edge 4.19.06-Datei
- Upgrade auf einem Server ohne Internetverbindung:
<ph type="x-smartling-placeholder">
- </ph>
- Erstellen Sie ein lokales 4.19.06-Repository, wie in Lokales Apigee-Repository erstellen
- So installieren Sie den Apigee-Dienst aus einer TAR-Datei:
<ph type="x-smartling-placeholder">
- </ph>
- 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.19.06.tar.gz
:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- 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. - Entpacken Sie auf dem neuen Knoten die Datei in das Verzeichnis /tmp:
tar -xzf apigee-4.19.06.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.
- Installieren Sie das Edge-Dienstprogramm
apigee-service
und die Abhängigkeiten aus/tmp/repos
:sudo bash /tmp/repos/bootstrap_4.19.06.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Beachten Sie, dass Sie in diesem Befehl den Pfad zum Repository-Verzeichnis angeben.
- Verwenden Sie auf dem Knoten mit dem lokalen Repository den folgenden Befehl, um das lokale Repository
Repository in eine einzelne TAR-Datei namens
- So installieren Sie den Apigee-Dienst mit dem Nginx-Webserver:
<ph type="x-smartling-placeholder">
- </ph>
- Konfigurieren Sie den Nginx-Webserver wie unter „Installation aus dem Repository mithilfe der Nginx-Webserver“ unter Install the Edge apigee-setup-Dienstprogramm.
- Laden Sie auf dem Remote-Knoten die Edge-Datei
bootstrap_4.19.06.sh
herunter, um/tmp/bootstrap_4.19.06.sh
:/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.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.
- Installieren Sie auf dem Remote-Knoten das Edge-Dienstprogramm
apigee-service
und Abhängigkeiten:sudo bash /tmp/bootstrap_4.19.06.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 dasapigee-setup
-Dienstprogramm zu aktualisieren:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- 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.