Edge for Private Cloud Version 4.17.09
Um Edge auf einem Knoten zu installieren, installieren Sie zuerst das Dienstprogramm für das Edge-Apigee-Setup. Wenn Sie sich in einer Umgebung befinden, in der Ihre Knoten keine externe Internetverbindung haben, müssen Sie auch eine lokale Kopie des Apigee-Repositorys installieren.
Standardinstallationsverzeichnis: /opt/apigee
Edge installiert alle Dateien im Verzeichnis /opt/apigee
. Sie können dieses Verzeichnis nicht ändern. Bei Bedarf können Sie jedoch einen Symlink erstellen, um /opt/apigee
einem anderen Ort zuzuordnen. Weitere Informationen finden Sie unter Installationsvoraussetzungen.
Voraussetzung: SELinux deaktivieren
Sie müssen SELinux deaktivieren oder auf den mäßigen Modus einstellen, bevor Sie das Edge-Dienstprogramm apigee-setup
oder andere Edge-Komponenten installieren können. Bei Bedarf können Sie SELinux nach der Installation von Edge wieder aktivieren.
- Führen Sie den folgenden Befehl aus, um SELinux vorübergehend in den moderaten Modus zu aktivieren:
- Unter Linux 6.x-Betriebssystem:
> sudo echo 0 > /selinux/enforce
So aktivieren Sie SELinux nach der Installation von Edge wieder:
> sudo echo 1 > /selinux/enforce
- Unter Linux 7.x-Betriebssystem:
> sudo setenforce 0
So aktivieren Sie SELinux nach der Installation von Edge wieder:
> sudo setenforce 1
- Unter Linux 6.x-Betriebssystem:
- So deaktivieren Sie SELinux dauerhaft oder setzen es auf den mäßigen Modus:
- Öffnen Sie
/etc/sysconfig/selinux
in einem Editor. SELINUX=disabled
oderSELINUX=permissive
festlegen- Speichern Sie die Änderungen.
- Starten Sie den Knoten neu.
- Aktivieren Sie SELinux nach der Edge-Installation wieder, indem Sie diesen Vorgang wiederholen, um
SELINUX=enabled
festzulegen.
- Öffnen Sie
Voraussetzung: EPEL-Repository aktivieren
Sie müssen Extra Packages for Enterprise Linux (oder EPEL) aktivieren, um Edge zu installieren oder zu aktualisieren oder ein lokales Repository zu erstellen. Welchen Befehl Sie verwenden, hängt von Ihrer Version von RedHat/CentOS ab:
- Für RedHat/CentOS/Oracle 7.x:
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; sudo rpm -ivh epel-release-latest-7.noarch.rpm
- Für RedHat/CentOS/Oracle 6.x:
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; sudo rpm -ivh epel-release-latest-6.noarch.rpm
Voraussetzung: Version der libdb4-Bibliothek unter RedHat 7.4 und CentOS 7.4 prüfen
Prüfen Sie unter RedHat 7.4 und CentOS 7.4 die Version der libdb4
-RPMs vor der Installation. Edge erfordert Version 4.8. Einige Versionen von RedHat 7.4 und CentOS 7.4 sind in einer neueren Version enthalten.
Mit dem folgenden Befehl können Sie Ihre Version prüfen:
> rpm -qa | grep libdb
Wenn Sie feststellen, dass die libdb4
-RPM-Version höher als Version 4.8 ist, ersetzen Sie die RPMs mit dem folgenden Befehl:
> rpm -Uvh --oldpackage libdb4-cxx-4.8.30-13.el7.x86_64.rpm libdb4-4.8.30-13.el7.x86_64.rpm
Wenn du diese RPMs herunterladen musst, findest du sie hier:
- http://dl.fedoraproject.org/pub/epel/7/x86_64/Packages/l/libdb4-cxx-4.8.30-13.el7.x86_64.rpm
- http://dl.fedoraproject.org/pub/epel/7/x86_64/Packages/l/libdb4-4.8.30-13.el7.x86_64.rpm
Installieren Sie das Edge-Dienstprogramm Apigee-Setup auf einem Knoten mit einer externen Internetverbindung
So installieren Sie Edge auf einem Knoten mit einer externen Internetverbindung:
- Rufen Sie den Nutzernamen und das Passwort von Apigee ab, mit dem Sie auf das Apigee-Repository zugreifen. Wenn Sie für die Apigee-FTP-Website bereits ein Nutzername/Passwort haben, können Sie diese Anmeldedaten verwenden.
- Melden Sie sich als Root beim Knoten an, um die Edge-RPMs zu installieren.
- Installieren Sie
yum-utils
undyum-plugin-priorities
:> sudo yum install yum-utils > sudo yum install yum-plugin-priorities
- Deaktivieren Sie SELinux wie oben beschrieben.
- Aktivieren Sie das EPEL-Repository wie oben beschrieben.
- Wenn Sie die Installation auf AWS durchführen, führen Sie den folgenden
yum-configure-manager
-Befehl aus:> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
- Laden Sie die Edge-Datei
bootstrap_4.17.09.sh
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
- Installieren Sie das Dienstprogramm für das Edge-Apigee-Dienstprogramm 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. Andernfalls wird die App automatisch installiert. Geben Sie mit der Option
JAVA_FIX
an, wie die Java-Installation verarbeitet werden soll.JAVA_FIX
verwendet die folgenden Werte:- I = OpenJDK 1.8 installieren (Standard)
- C = Ohne Installation von Java fortfahren
- F = Beenden. Dazu müssen Sie Java selbst installieren.
Durch die Installation des Dienstprogramms Apigee-Dienst wird die Datei /etc/yum.repos.d/apigee.repo erstellt, die das Apigee-Repository definiert. Rufen Sie die Definitionsdatei mit folgendem Befehl auf:
> cat /etc/yum.repos.d/apigee.repo
Verwenden Sie folgenden Befehl, um den Repository-Inhalt anzuzeigen:
> sudo yum -v repolist 'apigee*'
- Verwenden Sie
apigee-service
, um dasapigee-setup
-Dienstprogramm zu installieren:> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Verwenden Sie
apigee-setup
, um Edge-Komponenten auf dem Knoten zu installieren und zu konfigurieren. Weitere Informationen finden Sie unter Edge-Komponenten auf einem Knoten installieren.
Installieren Sie das Edge-Dienstprogramm für Apigee-Einrichtung auf einem Knoten ohne externe Internetverbindung
Wenn sich Ihre Edge-Knoten hinter einer Firewall befinden oder auf andere Weise nicht über das Internet auf das Apigee-Repository zugreifen können, müssen Sie ein lokales Repository oder eine Spiegelung des Apigee-Repositorys erstellen. Dieser Spiegel muss dann für alle Knoten zugänglich sein. Nach dem Erstellen können Knoten dann auf diesen lokalen Spiegel zugreifen, um Edge zu installieren.
Zum Erstellen des internen Apigee-Repositorys benötigen Sie einen Knoten mit externem Internetzugriff, um die Edge-RPMs und Abhängigkeiten herunterzuladen. Nachdem Sie das interne Repository erstellt haben, können Sie es auf einen anderen Knoten verschieben oder für die Edge-Knoten zur Installation zugänglich machen.
Nachdem Sie ein lokales Edge-Repository erstellt haben, müssen Sie es möglicherweise später mit den neuesten Edge-Releasedateien aktualisieren. In den folgenden Abschnitten wird beschrieben, wie Sie ein lokales Repository erstellen und aktualisieren.
Lokales Apigee-Repository erstellen
So erstellen Sie ein lokales Apigee-Repository:
- Rufen Sie den Nutzernamen und das Passwort von Apigee ab, mit dem Sie auf das Apigee-Repository zugreifen. Wenn Sie für die Apigee-FTP-Website bereits ein Nutzername/Passwort haben, können Sie diese Anmeldedaten verwenden.
- Melden Sie sich bei Ihrem Knoten als Root an, um die Edge-RPMs zu installieren.
- Installieren Sie
yum-utils
undyum-plugin-priorities
:> sudo yum install yum-utils > sudo yum install yum-plugin-priorities
- Deaktivieren Sie SELinux wie oben beschrieben.
- Aktivieren Sie das EPEL-Repository wie oben beschrieben.
- Wenn Sie die Installation auf AWS durchführen, führen Sie den folgenden
yum-configure-manager
-Befehl aus:
> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
- Laden Sie die Edge-Datei
bootstrap_4.17.09.sh
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
- Installieren Sie das Edge-Dienstprogramm
apigee-service
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.
- Installieren Sie das Dienstprogramm
apigee-mirror
auf dem Knoten:> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
- Verwenden Sie das Dienstprogramm
apigee-mirror
, um das Apigee-Repository mit dem Verzeichnis/opt/apigee/data/apigee-mirror/repos/
zu synchronisieren.Um die Größe des Repositorys zu minimieren, fügen Sie
--only-new-rpms
ein, um nur die neuesten RPMs herunterzuladen. Sie benötigen etwa 1,6 GB Speicherplatz für den Download:> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
Wenn Sie das gesamte Repository einschließlich älterer RPMs herunterladen möchten, lassen Sie
--only-new-rpms
weg. Sie benötigen etwa 6 GB Speicherplatz für den vollständigen Download:> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync
Sie haben jetzt eine lokale Kopie des Apigee-Repositorys. Im nächsten Abschnitt wird beschrieben, wie Sie das Edge-Dienstprogramm
apigee-setup
aus dem lokalen Repository installieren. -
(Optional) Wenn Sie Edge aus dem lokalen Repository auf demselben Knoten installieren möchten, auf dem das lokale Repository gehostet wird, müssen Sie zuerst die folgenden Befehle ausführen:
- Führen Sie
bootstrap_4.17.09.sh
aus dem lokalen Repository aus, um dasapigee-service
-Dienstprogramm zu installieren:> sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
- Verwenden Sie
apigee-service
, um dasapigee-setup
-Dienstprogramm zu installieren:> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Verwenden Sie
apigee-setup
, um Edge-Komponenten auf dem Knoten zu installieren und zu konfigurieren. Weitere Informationen finden Sie unter Edge-Komponenten auf einem Knoten installieren.
- Führen Sie
Installieren Sie Apigee-Setup auf einem Remoteknoten vom lokalen Repository
Sie haben zwei Möglichkeiten, Edge vom lokalen Repository zu installieren. Sie haben dann folgende Möglichkeiten:
- Erstellen Sie eine TAR-Datei des Repositorys, kopieren Sie die TAR-Datei auf einen Knoten und installieren Sie dann Edge aus der TAR-Datei.
- Installieren Sie einen Webserver auf dem Knoten mit dem lokalen Repository, damit andere Knoten darauf zugreifen können. Apigee stellt Ihnen den Nginx-Webserver zur Verfügung, den Sie nutzen können, oder Sie können Ihren eigenen Webserver verwenden.
Installation aus der TAR-Datei:
- Verwenden Sie auf dem Knoten mit dem lokalen Repository den folgenden Befehl, um das lokale Repository in eine einzelne TAR-Datei mit dem Namen
/opt/apigee/data/apigee-mirror/apigee-4.17.09.tar.gz
zu verpacken:> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- Kopieren Sie die TAR-Datei auf den Knoten, auf dem Sie Edge installieren möchten. Kopieren Sie ihn beispielsweise in das Verzeichnis
/tmp
auf dem neuen Knoten. - Installieren Sie
yum-utils
undyum-plugin-priorities
:> sudo yum install yum-utils > sudo yum install yum-plugin-priorities
- Deaktivieren Sie SELinux auf dem neuen Knoten wie oben beschrieben.
- Aktivieren Sie das EPEL-Repository wie oben beschrieben.
- 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.
- Installieren Sie das Dienstprogramm für den Edge-Apigee-Dienst und die Abhängigkeiten aus
/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.
- Verwenden Sie
apigee-service
, um dasapigee-setup
-Dienstprogramm zu installieren:> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Verwenden Sie
apigee-setup
, um Edge-Komponenten auf dem Knoten zu installieren und zu konfigurieren. Weitere Informationen finden Sie unter Edge-Komponenten auf einem Knoten installieren.
Installieren Sie mithilfe des Nginx-Webservers aus dem Repository:
- Installieren Sie den Nginx-Webserver auf dem Repository-Knoten:
> opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
- Nginx ist standardmäßig so konfiguriert, dass localhost als Servername und Port 3939 verwendet wird. So ändern Sie diese Werte:
- Öffnen Sie
/opt/apigee/customer/application/mirror.properties
in einem Editor. Erstellen Sie die Datei, falls sie noch nicht vorhanden ist. - Legen Sie bei Bedarf die folgenden Werte fest:
conf_apigee_mirror_listen_port=3939 conf_apigee_mirror_server_name=localhost
- Starten Sie Nginx neu:
> /opt/nginx/scripts/apigee-nginx restart
- Öffnen Sie
- Standardmäßig ist für das Repository für Nutzername:Passwort
admin:admin
erforderlich. Legen Sie die folgenden Umgebungsvariablen fest, um diese Anmeldedaten zu ändern:MIRROR_USERNAME=uName MIRROR_PASSWORD=pWord
- Installieren Sie
yum-utils
undyum-plugin-priorities
:> sudo yum install yum-utils > sudo yum install yum-plugin-priorities
- Deaktivieren Sie SELinux auf dem neuen Knoten wie oben beschrieben.
- Aktivieren Sie das EPEL-Repository wie oben beschrieben.
- Laden Sie auf dem Remote-Knoten die Datei Edge bootstrap_4.17.09.sh 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 den DNS-Namen des Repository-Knotens.
- Installieren Sie auf dem Remote-Knoten das Edge-Dienstprogramm
apigee-service
und die Abhängigkeiten:> 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.
- Installieren Sie auf dem Remote-Knoten mit
apigee-service
dasapigee-setup
-Dienstprogramm:> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Verwenden Sie
apigee-setup
, um Edge-Komponenten auf dem Remote-Knoten zu installieren und zu konfigurieren. Weitere Informationen finden Sie unter Edge-Komponenten auf einem Knoten installieren.
Lokales Apigee-Repository aktualisieren
Laden Sie die neueste Datei bootstrap_4.17.09.sh herunter und führen Sie dann eine neue Synchronisierung durch, um das Repository zu aktualisieren:
- Laden Sie die Datei Edge bootstrap_4.17.09.sh 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
- Führen Sie die Edge-Datei
bootstrap_4.17.09.sh
aus:> 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.
apigee-mirror
aktualisieren:> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
- Führen Sie die Synchronisierung durch:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
- Wenn Sie das gesamte Repository herunterladen möchten:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync
Lokales Apigee-Repository bereinigen
Durch die Bereinigung des lokalen Repositorys werden /opt/apigee/data/apigee-mirror
und /var/tmp/yum-apigee-*
gelöscht.
Verwenden Sie Folgendes, um das lokale Repository zu bereinigen:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean
Edge 4.16.0x/4.17.0x in einem 4.17.09-Repository hinzufügen oder aktualisieren
Wenn Sie Installationen für Edge 4.16.0x oder 4.17.01/4.17.05 in einem 4.17.09-Repository verwalten müssen, können Sie ein Repository verwalten, das alle Versionen enthält. Von diesem Repository aus können Sie dann eine beliebige Version von Edge installieren.
So fügen Sie 4.16.0x/4.17.0x zu einem 4.17.09-Repository hinzu:
- Prüfen Sie, ob Sie Version 4.17.09 des
apigee-mirror
-Dienstprogramms installiert haben:> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version
Sie sollten ein Ergebnis im folgenden Format sehen, wobei xyz die Build-Nummer ist:
apigee-mirror-4.17.09-0.0.xyz
- Laden Sie mit dem Dienstprogramm
apigee-mirror
Edge 4.16.0x/4.17.01/4.17/05 in Ihr Repository herunter. Beachten Sie, wie Sie dem Befehl die gewünschte Version als Präfix hinzufügen:> apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
Verwenden Sie denselben Befehl, um später die Repositories 4.16.0x/4.17.05 durch Angabe der erforderlichen Versionsnummern zu aktualisieren.
- Sehen Sie sich das Verzeichnis
/opt/apigee/data/apigee-mirror/repos
an, um die Dateistruktur zu sehen:> ls /opt/apigee/data/apigee-mirror/repos
Sie sollten die folgenden Dateien und Verzeichnisse sehen:
apigee apigee-repo-1.0-6.x86_64.rpm bootstrap_4.16.01.sh bootstrap_4.16.05.sh bootstrap_4.17.01.sh bootstrap_4.17.05.sh bootstrap_4.17.09.sh thirdparty
Beachten Sie, dass Sie eine Bootstrap-Datei für alle Versionen von Edge haben. Das Verzeichnis
apigee
enthält auch separate Verzeichnisse für jede Version von Edge. - Verwenden Sie den folgenden Befehl, um das Repository in einer TAR-Datei zu verpacken:
> apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
Mit diesem Befehl werden alle 4.17.0x- und 4.16.0x-Repositories in derselben TAR-Datei zusammengefasst. Sie können nicht nur einen Teil des Repositorys verpacken.
Wenn Sie Edge über die lokale Repository- oder TAR-Datei installieren möchten, müssen Sie mit einem der folgenden Befehle einfach die richtige Bootstrap-Datei ausführen. In diesem Beispiel wird Edge 4.17.01 installiert:
- Wenn Sie die Installation aus einer TAR-Datei durchführen, führen Sie die richtige Bootstrap-Datei aus dem Repository aus:
> sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Führen Sie die restlichen Schritte im obigen Abschnitt „Über TAR-Datei installieren“ aus, um die Installation abzuschließen.
- Wenn Sie zur Installation den Nginx-Webserver verwenden, laden Sie die richtige Bootstrap-Datei aus dem Repository herunter und führen Sie sie aus:
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh > sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
Führen Sie die restlichen Schritte im obigen Abschnitt "Mit dem Nginx-Webserver aus dem Repository installieren" aus, um die Installation abzuschließen.