Edge-Dienstprogramm für Apigee-Setup installieren

Um Edge auf einem Knoten zu installieren, installieren Sie zuerst das Edge-Dienstprogramm für die Apigee-Einrichtung. Wenn sich Ihre Knoten in einer Umgebung befinden, in der sie 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. Dieses Verzeichnis kann nicht geändert werden. Sie können jedoch einen Symlink erstellen, um /opt/apigee einem anderen Speicherort zuzuordnen. Weitere Informationen finden Sie unter Installationsanforderungen.

Voraussetzung: Deaktivieren Sie SELinux.

Sie müssen SELinux deaktivieren oder in den permissiven Modus versetzen, bevor Sie das Edge-apigee-setup-Dienstprogramm oder Edge-Komponenten installieren können. Nach der Installation von Edge können Sie SELinux bei Bedarf wieder aktivieren.

  • So deaktivieren Sie SELinux dauerhaft oder stellen es auf den Modus „erlaubt“ ein:
    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 Installation von Edge bei Bedarf wieder, indem Sie diese Schritte wiederholen, um SELINUX=enabled festzulegen.
  • Voraussetzung: EPEL-Repository aktivieren

    Sie müssen Extra Packages for Enterprise Linux (EPEL) aktivieren, um Edge zu installieren oder zu aktualisieren oder ein lokales Repository zu erstellen. Welchen Befehl Sie verwenden, hängt von Ihrer RedHat-/CentOS-Version ab:

    • Für Red Hat/CentOS/Oracle 8.x:
      wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
      sudo rpm -ivh epel-release-latest-8.noarch.rpm
    • Für Red Hat/CentOS/Oracle 9.x:
      wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
      sudo rpm -ivh epel-release-latest-9.noarch.rpm
    • Voraussetzungen für RHEL 8/Rocky 8/Oracle 8

      Wenn Sie Edge auf einem Server mit Red Hat Enterprise Linux (RHEL) 8 installieren, führen Sie vor der Installation die folgenden Schritte aus:

      1. Aktivieren Sie Zusätzliche Pakete für Enterprise Linux (EPEL):
        sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
      2. Deaktivieren Sie Postgres und Nginx:
        sudo dnf module disable postgresql
        sudo dnf module disable nginx

      Voraussetzung für RHEL 9/Rocky 9/Oracle 9

      Wenn Sie Edge auf einem Server mit Red Hat Enterprise Linux (RHEL) 9, Rocky 9 oder Oracle 9 installieren, führen Sie vor der Installation die folgenden Schritte aus:

      1. Aktivieren Sie Zusätzliche Pakete für Enterprise Linux (EPEL):
        sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
      2. Postgres und Nginx deaktivieren:
        sudo dnf module disable postgresql
        sudo dnf module disable nginx

      Informationen zu den Änderungen vor der Installation von PostgreSQL und LDAP finden Sie unter Anforderungen vor der Installation der PostgreSQL-Datenbank bzw. Änderungen vor der Installation von OpenLDAP 2.4.

      Edge-Apigee-Einrichtungs-Dienstprogramm auf einem Knoten mit einer externen Internetverbindung installieren

      So installieren Sie Edge auf einem Knoten mit einer externen Internetverbindung:

      1. Rufen Sie von Apigee den Nutzernamen und das Passwort ab, mit denen Sie auf das Apigee-Repository zugreifen. Wenn Sie bereits eine username:password für die Apigee-FTP-Website haben, können Sie diese Anmeldedaten verwenden.
      2. Melden Sie sich als Root auf Ihrem Knoten an, um die Edge-RPMs zu installieren.
      3. Deaktivieren Sie SELinux.
      4. Aktivieren Sie das EPEL-Repository.
      5. Wenn Sie die Installation unter RHEL 9/Rocky 9/Oracle 9 durchführen, folgen Sie der Anleitung unter Voraussetzungen für RHEL 9/Rocky 9/Oracle 9.
      6. Laden Sie die Edge-Datei bootstrap_4.53.00.sh auf /tmp/bootstrap_4.53.00.sh herunter:
        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      7. Installieren Sie das Edge-Apigee-Dienst-Hilfsprogramm und die Abhängigkeiten:
        sudo bash /tmp/bootstrap_4.53.00.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, sie einzugeben.

        Standardmäßig wird beim Installationsvorgang geprüft, ob Java 1.8 installiert ist. Andernfalls wird es automatisch installiert. Verwenden Sie die Option JAVA_FIX, um anzugeben, wie die Java-Installation erfolgen soll. JAVA_FIX kann folgende Werte haben:

        • I: OpenJDK 1.8 installieren (Standard)
        • C: Fortfahren, ohne Java zu installieren
        • F: Beenden. Dazu müssen Sie Java selbst installieren.

        Durch die Installation des Dienstprogramms „apigee-service“ wird die Datei „/etc/yum.repos.d/apigee.repo“ erstellt, in der das Apigee-Repository definiert wird. Die Definitionsdatei rufen Sie mit dem folgenden Befehl auf:

        cat /etc/yum.repos.d/apigee.repo

        Den Repository-Inhalt rufen Sie mit dem folgenden Befehl auf:

        sudo yum -v repolist 'apigee*'
      8. Verwenden Sie apigee-service, um das Dienstprogramm apigee-setup zu installieren:
        /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
      9. 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.

      Fehlerbehebung

      Wenn Sie versuchen, die Installation auf einem Knoten mit einer externen Internetverbindung durchzuführen, kann einer oder mehrere der folgenden Fehler auftreten:

      Cannot open: https://username@software.apigee.com/apigee-repo-4.53.00.rpm
      
      bootstrap.sh: Error: Repo configuration failed
      
      error: package package_name is not installed

      In der folgenden Tabelle sind einige mögliche Lösungen für diese Fehler aufgeführt:

      Fehlertyp Mögliche Lösung
      Das Passwort enthält unzulässige Zeichen Verwenden Sie keine Sonderzeichen in Ihrem Apigee-Passwort.
      Verbindungsprobleme

      Testen Sie die Netzwerkverbindung mit dem folgenden ncat-Befehl:

      nc -v software.apigee.com 443

      Sie sollten eine Meldung wie diese erhalten:

      Connection to software.apigee.com 443 port [tcp/https] succeeded!

      Wenn nc nicht installiert ist, können Sie den folgenden telnet-Befehl ausführen:

      telnet software.apigee.com 443

      Wenn die Befehle erfolgreich waren, können Sie die geöffnete Verbindung mit STRG + C beenden.

      Wenn einer der Befehle fehlschlägt, haben Sie nur eine eingeschränkte oder gar keine Netzwerkverbindung. Wenden Sie sich an Ihren Netzwerkadministrator.

      Falsche Anmeldedaten

      Prüfen Sie, ob Ihr Nutzername und Ihr Passwort korrekt sind.

      Prüfen Sie beispielsweise, ob Sie einen Fehler erhalten, wenn Sie versuchen, den folgenden Befehl mit Ihrem Apigee-Nutzernamen und -Passwort zu verwenden:

      curl -i -u username:password https://software.apigee.com/apigee-repo.rpm
      Probleme mit dem Proxy Ihre lokale Konfiguration verwendet einen ausgehenden HTTP-Proxy und Sie haben diese Konfiguration nicht auf den yum-Paketmanager ausgeweitet. Prüfen Sie Ihre Umgebungsvariablen:
      echo $http_proxy
      echo $https_proxy

      Für einen ausgehenden HTTP-Proxy sollten Sie eine der folgenden Optionen verwenden:

      • HTTP-Proxykonfiguration unter /etc/yum.conf hinzufügen
      • Globale HTTP-Proxykonfiguration unter /etc/environment hinzufügen

      Installieren Sie das Edge-Apigee-Setup-Hilfsprogramm auf einem Knoten ohne externe Internetverbindung.

      Wenn sich Ihre Edge-Knoten hinter einer Firewall befinden oder auf andere Weise nicht auf das Internet zugreifen können, müssen Sie mehrere Repositories oder Mirrors erstellen, die Dateien enthalten, die Sie während der Installation benötigen. Diese Spiegel müssen dann für alle Knoten zugänglich sein. Nach der Erstellung können Knoten auf diese lokalen Mirrors zugreifen, um Edge zu installieren.

      Für die Installation von Apigee Edge auf Knoten ohne Internetverbindung ist Zugriff auf die folgenden lokalen Repos erforderlich:

      Lokales Apigee-Repository erstellen

      Zum Erstellen des internen Apigee-Repositories benötigen Sie einen Knoten mit externem Internetzugriff, um die Edge-RPMs und Abhängigkeiten herunterladen zu können. Nachdem Sie das interne Repository erstellt haben, können Sie es auf einen anderen Knoten verschieben oder diesen Knoten für die Installation für die Edge-Knoten zugänglich machen.

      Nachdem Sie ein lokales Apigee-Repository erstellt haben, müssen Sie es möglicherweise später mit den neuesten Edge-Release-Dateien aktualisieren. In den folgenden Abschnitten wird beschrieben, wie Sie ein lokales Apigee-Repository erstellen und aktualisieren.

      So erstellen Sie ein lokales Apigee-Repository:

      1. Erkundigen Sie sich bei Apigee nach dem Nutzernamen und Passwort, mit dem Sie auf das Apigee-Repository zugreifen. Wenn Sie bereits einen „username:password“ für die Apigee-FTP-Website haben, können Sie diese Anmeldedaten verwenden.
      2. Melden Sie sich als Root auf Ihrem Knoten an, um die Edge-RPMs zu installieren.
      3. Deaktivieren Sie SELinux wie oben beschrieben.
      4. Laden Sie die Edge bootstrap_4.53.00.sh-Datei in /tmp/bootstrap_4.53.00.sh herunter:
        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      5. Installieren Sie das Edge-Apigee-Dienstprogramm und die Abhängigkeiten:
        sudo bash /tmp/bootstrap_4.53.00.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, sie einzugeben.

      6. Installieren Sie das Dienstprogramm apigee-mirror auf dem Knoten:
        /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
      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 Repos zu minimieren, geben Sie --only-new-rpms an, um nur die neuesten RPMs herunterzuladen.

      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.53.00.sh aus dem lokalen Repository aus, um das Dienstprogramm apigee-service zu installieren:
          sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.53.00.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
        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.

      Apigee-setup auf einem Remote-Knoten aus dem lokalen Repository installieren

      Es gibt zwei Möglichkeiten, Edge aus dem lokalen Repository zu installieren. Du hast 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 auf dem Knoten mit dem lokalen Repository einen Webserver, damit andere Knoten darauf zugreifen können. Apigee stellt den Nginx-Webserver zur Verfügung. Sie können aber auch Ihren eigenen Webserver verwenden.

      Aus der TAR-Datei installieren

      So installieren Sie das Programm über die TAR-Datei:

      1. Verpacken Sie das lokale Repository auf dem Knoten mit dem lokalen Repository mit dem folgenden Befehl in einer einzelnen TAR-Datei mit dem Namen /opt/apigee/data/apigee-mirror/apigee-4.53.00.tar.gz:
        /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
      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 auf dem neuen Knoten SELinux, wie oben beschrieben.
      4. Achten Sie darauf, dass Sie auf dem neuen Knoten auf das lokale Yum-Utility-Repository und das EPEL-Repository zugreifen können.
      5. Prüfen Sie noch einmal, ob alle externen Internet-Repositories deaktiviert sind. Das sollte der Fall sein, da Sie die Installation auf einem Computer ohne Internetzugang ausführen:
        sudo yum repolist

        Alle externen Repositories sollten deaktiviert sein, das lokale Apigee-Repository und Ihre internen Repositories sollten jedoch aktiviert sein.

      6. Verwenden Sie apigee-service, um das apigee-setup-Dienstprogramm zu installieren:
        /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
      7. 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.

      Über das Repository mit dem Nginx-Webserver installieren

      So installieren Sie das Repository über den Nginx-Webserver:

      1. Installieren Sie den Nginx-Webserver auf dem Repository-Knoten:
        /opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
      2. Standardmäßig ist Nginx 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 nach Bedarf die folgenden Werte fest:
          conf_apigee_mirror_listen_port=3939
          conf_apigee_mirror_server_name=localhost
        3. Starten Sie Nginx neu:
          /opt/nginx/scripts/apigee-nginx restart
      3. Standardmäßig ist für das Repository der Nutzername:Passwort admin:admin erforderlich. Wenn Sie diese Anmeldedaten ändern möchten, legen Sie die folgenden Umgebungsvariablen fest:
        MIRROR_USERNAME=uName
        MIRROR_PASSWORD=pWord
      4. Prüfen Sie auf dem neuen Knoten, ob das EPEL-Repository lokal aktiviert ist.
      5. Prüfen Sie auf dem neuen Knoten wie oben beschrieben die Version von libdb4.
      6. Installieren Sie auf dem Remote-Knoten das Edge-apigee-service-Hilfsprogramm und die Abhängigkeiten:
        sudo bash /tmp/bootstrap_4.53.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

        Dabei sind uName:pWord der Nutzername und das Passwort für das Repository.

      7. Installieren Sie auf dem Remote-Knoten mit apigee-service das Dienstprogramm apigee-setup:
        /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
      8. 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

      Wenn Sie das Repository aktualisieren möchten, müssen Sie die neueste bootstrap_4.53.00.sh-Datei herunterladen und dann eine neue Synchronisierung ausführen.

      So aktualisieren Sie das Repository:

      1. Laden Sie die Edge-Datei „bootstrap_4.53.00.sh“ auf /tmp/bootstrap_4.53.00.sh herunter:
        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      2. Führen Sie die Edge-bootstrap_4.53.00.sh-Datei aus:
        sudo bash/tmp/bootstrap_4.53.00.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, sie einzugeben.

      3. Aktualisieren Sie apigee-mirror:
        /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
      4. Führen Sie die Synchronisierung durch:
        /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
      5. So klonen Sie das gesamte Repository:
        /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.

      So bereinigen Sie das lokale Repository:

      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean