Edge-Dienstprogramm für Apigee-Setup installieren

Edge for Private Cloud Version 4.18.01

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 Standort 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 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:
    1. Auf einem Linux 6.x-Betriebssystem:
      sudo echo 0 > /selinux/enforce

      So aktivieren Sie SELinux nach der Installation von Edge wieder:
      sudo echo 1 > /selinux/enforce
    2. Auf einem Linux 7.x-Betriebssystem:
      sudo setenforce 0

      So aktivieren Sie SELinux nach der Installation von Edge wieder:
      sudo setenforce 1
  • So deaktivieren Sie SELinux dauerhaft oder setzen es auf den mäßigen Modus:
    1. Öffnen Sie /etc/sysconfig/selinux in einem Editor.
    2. Legen Sie SELINUX=disabled oder SELINUX=permissive fest.
    3. Speichern Sie die Änderungen.
    4. Starten Sie den Knoten neu.
    5. Aktivieren Sie SELinux nach der Edge-Installation wieder, indem Sie diesen Vorgang wiederholen, um SELINUX=enabled festzulegen.

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

Überprü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. Wenn Sie eine neuere Version haben, deinstallieren Sie diese. Das Edge-Installationsprogramm installiert dann Version 4.8.

Mit dem folgenden Befehl können Sie Ihre Version prüfen:

> rpm -qa | grep libdb4

Wenn Sie feststellen, dass die RPM-Version von libdb4 höher als Version 4.8 ist, deinstallieren Sie sie.

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:

  1. 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.
  2. Melden Sie sich als Root beim Knoten an, um die Edge-RPMs zu installieren.
    Hinweis: Für die RPM-Installation ist Root-Zugriff erforderlich. Sie können die Edge-Konfiguration aber auch ohne Root-Zugriff durchführen.
  3. Installieren Sie yum-utils und yum-plugin-priorities:
    > sudo yum install yum-utils
    > sudo yum install yum-plugin-priorities
  4. Deaktivieren Sie SELinux wie oben beschrieben.
  5. Aktivieren Sie das EPEL-Repository wie oben beschrieben.
  6. Überprüfen Sie Ihre Version von libdb4 wie oben beschrieben.
  7. Wenn Sie die Installation auf Oracle 7.x durchführen,führen Sie den folgenden Befehl aus:
    > sudo yum-config-manager --enable ol7_optional_latest
  8. Bei der Installation auf AWS führen Sie die folgenden yum-configure-manager-Befehle aus:
    > yum update rh-amazon-rhui-client.noarch
    > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  9. Laden Sie die Edge-Datei bootstrap_4.18.01.sh in /tmp/bootstrap_4.18.01.sh herunter:
    > curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
  10. Installieren Sie das Edge-Apigee-Dienst-Dienstprogramm und die Abhängigkeiten:
    > sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

    wobei uName:pWord der Benutzername und das Passwort ist, die Sie von Apigee erhalten haben. Wenn Sie pWord auslassen, werden Sie aufgefordert, ihn einzugeben.

    Das Installationsprogramm prüft standardmäßig, ob Java 1.8 installiert ist. Andernfalls wird die App automatisch installiert. Verwenden Sie die Option JAVA_FIX, um anzugeben, wie die Java-Installation zu behandeln ist. Für JAVA_FIX werden folgende Werte verwendet:

    I = Install OpenJDK 1.8 (Standard)
    C = Weiter ohne Java-Installation
    Q = 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. Verwenden Sie den folgenden Befehl, um die Definitionsdatei anzuzeigen:
    > cat /etc/yum.repos.d/apigee.repo

    Verwenden Sie den folgenden Befehl, um den Repository-Inhalt anzuzeigen:
    > sudo yum -v repolist 'apigee*'
  11. Verwenden Sie apigee-service zur Installation des Dienstprogramms apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup installieren
  12. 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.

Hinweis: Apigee hostet nicht alle Abhängigkeiten von Drittanbietern in unseren öffentlichen Repositories. Sie müssen diese Abhängigkeiten aus öffentlich zugänglichen Repositories herunterladen und installieren.

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:

  1. 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.
  2. Melden Sie sich bei Ihrem Knoten als Root an, um die Edge-RPMs zu installieren.
    Hinweis: Für die RPM-Installation ist Root-Zugriff erforderlich. Sie können die Edge-Konfiguration aber auch ohne Root-Zugriff durchführen.
  3. Deaktivieren Sie SELinux wie oben beschrieben.
  4. Laden Sie die Edge-Datei bootstrap_4.18.01.sh in /tmp/bootstrap_4.18.01.sh herunter:
    > curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
  5. Installieren Sie das Edge Apigee-Dienstprogramm und die Abhängigkeiten:
    > sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

    , wobei uName:pWord der Benutzername und das Passwort ist, die Sie von Apigee erhalten haben. Wenn Sie pWord auslassen, werden Sie aufgefordert, ihn einzugeben.
  6. Installieren Sie das Dienstprogramm apigee-mirror auf dem Knoten:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror installieren

    Hinweis: Wenn Sie ein vorhandenes Repository auf 4.18.01 aktualisieren, müssen Sie nur apigee-mirror aktualisieren:
    > /opt/apigee-mirror aktualisieren:
    > /opt/apigee-mirror aktualisieren
  7. 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-Synchronisierung

    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.
  8. (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:
    1. Führen Sie bootstrap_4.18.01.sh aus dem lokalen Repository aus, um das Dienstprogramm apigee-service zu installieren:
      > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirr
    2. Verwenden Sie apigee-service, um das Dienstprogramm apigee-setup zu installieren:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    3. 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 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:

  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.18.01.tar.gz zu verpacken:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror-Paket
  2. 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.
  3. Deaktivieren Sie SELinux auf dem neuen Knoten wie oben beschrieben.
  4. Aktivieren Sie auf dem neuen Knoten das EPEL-Repository wie oben beschrieben.
  5. Achten Sie darauf, dass Sie auf dem neuen Knoten alle externen Internet-Repositories deaktiviert haben. Wenn Sie den folgenden Befehl ausführen, sollten alle externen Repositories als deaktiviert angezeigt werden. Das lokale Apigee-Repository und alle Ihre internen Repositories sollten jedoch aktiviert sein:
    > sudo yum repolist
  6. Installieren Sie auf dem neuen Knoten yum-utils und yum-plugin-priorities:
    > sudo yum install yum-utils
    > sudo yum install yum-plugin-priorities
  7. Überprüfen Sie auf dem neuen Knoten die Version von libdb4 wie oben beschrieben.
  8. Wenn Sie die Installation auf Oracle 7.x durchführen,führen Sie den folgenden Befehl aus:
    > sudo yum-config-manager --enable ol7_optional_latest
  9. Bei der Installation auf AWS 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
  10. Entpacken Sie die Datei auf dem neuen Knoten in das /tmp-Verzeichnis:
    > tar -xzf apigee-4.18.01.tar.gz

    Mit diesem Befehl wird ein neues Verzeichnis namens repos in dem Verzeichnis erstellt, das die .tar-Datei enthält. Beispiel: /tmp/repos.
  11. Installieren Sie das Edge-Apigee-Dienst-Dienstprogramm und die Abhängigkeiten aus /tmp/repos:
    > sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Beachten Sie, dass Sie in diesem Befehl den Pfad zum Repository-Verzeichnis angeben.
  12. Verwenden Sie apigee-service, um das Dienstprogramm apigee-setup zu installieren:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  13. 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:

  1. Installieren Sie den Nginx-Webserver auf dem Repository-Knoten:
    > opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
  2. Nginx ist standardmäßig so konfiguriert, dass localhost als Servername und Port 3939 verwendet wird. So ändern Sie diese Werte:
    1. Öffnen Sie /opt/apigee/customer/application/mirror.properties in einem Editor. Erstellen Sie die Datei, falls sie noch nicht vorhanden ist.
    2. Legen Sie die folgenden Werte nach Bedarf fest:
      conf_apigee_mirror_listen_port=3939
      conf_apigee_mirror_server_name=localhost
    3. Starten Sie Nginx neu:
      ?> /opt/nginx/scripts/apigee-nginx Neustart
  3. Standardmäßig ist für das Repository der Nutzername admin:admin als Nutzername:Passwort erforderlich. Legen Sie die folgenden Umgebungsvariablen fest, um diese Anmeldedaten zu ändern:
    MIRROR_USERNAME=uName
    MIRROR_PASSWORT=pWord
  4. Installieren Sie auf dem neuen Knoten yum-utils und yum-plugin-priorities:
    > sudo yum install yum-utils
    > sudo yum install yum-plugin-priorities
  5. Deaktivieren Sie SELinux auf dem neuen Knoten wie oben beschrieben.
  6. Aktivieren Sie auf dem neuen Knoten das EPEL-Repository wie oben beschrieben.
  7. Überprüfen Sie auf dem neuen Knoten die Version von libdb4 wie oben beschrieben.
  8. Laden Sie auf dem Remote-Knoten die Datei Edge bootstrap_4.18.01.sh in /tmp/bootstrap_4.18.01.sh herunter:
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01. re-Word1.

  9. Installieren Sie auf dem Remote-Knoten das Dienstprogramm Edge Apigee-Dienst und die Abhängigkeiten:
    > sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeepassword=pWord apigeepassword=pWord u.pWordpWord-Nutzername: /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939

  10. Verwenden Sie auf dem Remote-Knoten apigee-service, um das Dienstprogramm apigee-setup zu installieren:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  11. Verwenden Sie apigee-setup, um Edge-Komponenten auf dem Remoteknoten zu installieren und zu konfigurieren. Weitere Informationen finden Sie unter Edge-Komponenten auf einem Knoten installieren.

Lokales Apigee-Repository aktualisieren

Zum Aktualisieren des Repositorys müssen Sie die neueste Datei bootstrap_4.18.01.sh herunterladen und dann einen neuen Sysnc ausführen:

  1. Laden Sie die Datei Edge bootstrap_4.18.01.sh in /tmp/bootstrap_4.18.01.sh herunter:
    > curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
  2. Führen Sie die Edge-Datei bootstrap_4.18.01.sh aus:
    > sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

    wobei uName:pWord der Nutzername und das Passwort sind, die Sie von Apigee erhalten haben. Wenn Sie pWord auslassen, werden Sie aufgefordert, ihn einzugeben.
  3. Aktualisieren von apigee-mirror:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror-Aktualisierung
  4. Führen Sie die Synchronisierung durch:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
  5. Wenn Sie das gesamte Repository laden möchten:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror-Synchronisierung

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.18.01-Repository hinzufügen oder aktualisieren

Wenn Sie Installationen für Edge 4.16.0x oder 4.17.0x in einem 4.18.01-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.18.01-Repository hinzu:

  1. Achten Sie darauf, dass Sie die Version 4.18.01 des Dienstprogramms apigee-mirror installiert haben:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror-Version installiert

    Sie sollten ein Ergebnis im folgenden Formular sehen, wobei xyz die Build-Nummer ist:
    apigee-mirror-0.18.01.
  2. Verwenden Sie das Dienstprogramm apigee-mirror, um Edge 4.16.0x/4.17.0x in Ihr Repository herunterzuladen. 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 erforderlichen Versionen von 4.16.0x/4.17.0x zu aktualisieren.
  3. Prüfen Sie das Verzeichnis /opt/apigee/data/apigee-mirror/repos/opt/apigee/data/apigee-mirror/repos





    Das Verzeichnis apigee enthält auch separate Verzeichnisse für jede Version von Edge.
  4. Verwenden Sie den folgenden Befehl, um das Repository in eine TAR-Datei zu verpacken:
    > apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service, apigee-mirror-Paket

    Dieser Befehl fasst alle 4.17.0x- und 4.16.0x-Repositories in dieselbe .tar-Datei zusammen. 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:

  • Führen Sie bei der Installation aus einer TAR-Datei 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 aus der .tar-Datei aus, um die Installation abzuschließen.
  • Wenn Sie die Installation mit dem Nginx-Webserver ausführen, laden Sie die korrekte Bootstrap-Datei aus dem Repository herunter und führen Sie sie dann aus:
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.01.sh -o /tmp/bootstrap_bootstrap_bootstrap_4.17.01.boot_Webserver