Edge-Dienstprogramm für Apigee-Setup installieren

Wenn Sie Edge auf einem Knoten installieren möchten, müssen Sie zuerst das Edge-Dienstprogramm `apigee-setup` installieren. In einer Umgebung, 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. Dieses Verzeichnis kann nicht geändert werden. Bei Bedarf können Sie jedoch einen Symlink erstellen, um /opt/apigee einem anderen Speicherort zuzuordnen. Weitere Informationen finden Sie unter Installationsanforderungen.

Voraussetzung: SELinux deaktivieren

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 versetzen es in den permissiven Modus:
    1. Öffnen Sie /etc/sysconfig/selinux in einem Editor.
    2. Legen Sie SELINUX=disabled oder SELINUX=permissive fest.
    3. Speichern Sie Ihre Änderungen.
    4. Starten Sie den Knoten neu.
    5. Aktivieren Sie SELinux nach der Installation von Edge bei Bedarf wieder, indem Sie diese Schritte wiederholen und SELINUX=enabled festlegen.

    • 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. Führen Sie für Red Hat Enterprise Linux (RHEL) 9.x, Rocky Linux 9.x oder Oracle Linux 9.x die folgenden Befehle aus:

    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
sudo rpm -ivh epel-release-latest-9.noarch.rpm

    Voraussetzung für RHEL 9, Rocky 9 und 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. Extra Packages for Enterprise Linux (EPEL) aktivieren: 
      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 für PostgreSQL und LDAP finden Sie unter Anforderungen für die Vorinstallation der PostgreSQL-Datenbank und Änderungen vor der Installation von SymasLDAP 2.6.10.

    Edge-Dienstprogramm `apigee-setup` auf einem Knoten mit externer Internet Verbindung installieren

    So installieren Sie Edge auf einem Knoten mit externer Internetverbindung:

    1. Rufen Sie den Nutzernamen und das Passwort von Apigee ab, mit denen Sie auf das Apigee-Repository zugreifen. Wenn Sie bereits ein username:password für die Apigee-FTP-Website haben, können Sie diese Anmeldedaten verwenden.
    2. Melden Sie sich als Root-Nutzer 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 oder Oracle 9 ausführen, folgen Sie der Anleitung unter Voraussetzungen für RHEL 9, Rocky 9 und Oracle 9.
    6. Laden Sie die Edge-Datei bootstrap_4.54.00.sh in /tmp/bootstrap_4.54.00.sh herunter: 
      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
    7. Installieren Sie das Edge-Dienstprogramm `apigee-service` und die zugehörigen Abhängigkeiten: 
      sudo bash /tmp/bootstrap_4.54.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, es einzugeben.

      Für Apigee Edge for Private Cloud 4.54.00 ist die Unterstützung für zwei Java-Versionen erforderlich, wobei sowohl Java 17 und Java 21 auf dem Knoten installiert sein müssen. Sie müssen sowohl Java 17 als auch Java 21 installieren, bevor Sie das Bootstrap-Skript ausführen. Das Installationsprogramm prüft nur, ob beide JDK-Versionen installiert sind. Java wird nicht automatisch installiert.

      Bei der Installation des Dienstprogramms `apigee-service` wird die Datei /etc/yum.repos.d/apigee.repo erstellt die das Apigee-Repository definiert. Verwenden Sie den folgenden Befehl, um die Definitionsdatei aufzurufen:

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

      Verwenden Sie den folgenden Befehl, um den Inhalt des Repositorys aufzurufen:

      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 externer Internetverbindung auszuführen, können 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
    Passwort enthält ungültige Zeichen Verwenden Sie keine Sonderzeichen in Ihrem Apigee-Passwort.
    Verbindungsprobleme

    Testen Sie Ihre Netzwerkverbindung mit dem folgenden ncat Befehl:

    nc -v software.apigee.com 443

    Sie sollten eine Meldung ähnlich der folgenden 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 ausgeführt werden, können Sie die offene Verbindung mit Strg + C abbrechen.

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

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

    Prüfen Sie beispielsweise, ob ein Fehler auftritt, wenn Sie den folgenden Befehl mit Ihrem Apigee-Nutzernamen und ‑Passwort verwenden:

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

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

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

    Edge -Dienstprogramm `apigee-setup` auf einem Knoten ohne externe Internetverbindung installieren

    Wenn sich Ihre Edge-Knoten hinter einer Firewall befinden oder auf andere Weise der Zugriff auf das Internet verhindert wird, müssen Sie mehrere Repositorys oder Spiegel erstellen, die 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 Spiegel zugreifen, um Edge zu installieren.

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

    Lokales Apigee-Repository erstellen

    Zum Erstellen des internen Apigee-Repositorys benötigen Sie einen Knoten mit externem Internet zugriff, 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 Edge-Knoten zur Installation 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 wie Sie es aktualisieren.

    So erstellen Sie ein lokales Apigee-Repository :

    1. Rufen Sie den Nutzernamen und das Passwort von Apigee ab, mit denen Sie auf das Apigee-Repository zugreifen. Wenn Sie bereits einen Nutzernamen und ein Passwort für die Apigee-FTP-Website haben, können Sie diese Anmeldedaten verwenden.
    2. Melden Sie sich als Root-Nutzer auf Ihrem Knoten an, um die Edge-RPMs zu installieren.
    3. Deaktivieren Sie SELinux wie oben beschrieben.
    4. Laden Sie die Edge-Datei bootstrap_4.54.00.sh in /tmp/bootstrap_4.54.00.sh herunter: 
      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
    5. Installieren Sie das Edge-Dienstprogramm `apigee-service` und die zugehörigen Abhängigkeiten: 
      sudo bash /tmp/bootstrap_4.54.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, es 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 apigee-mirror Dienstprogramm, um das Apigee-Repository mit dem /opt/apigee/data/apigee-mirror/repos/ Verzeichnis zu synchronisieren.

      Um die Größe des Repositorys zu minimieren, fügen Sie --only-new-rpms hinzu, um nur die neuesten RPMs herunterzuladen.

    8. (Optional) Wenn Sie Edge aus dem lokalen Repository auf demselben Knoten installieren möchten, auf dem sich das lokale Repository befindet, müssen Sie zuerst die folgenden Befehle ausführen:
      1. Führen Sie bootstrap_4.54.00.sh aus dem lokalen Repository aus, um das apigee-service Dienstprogramm zu installieren: 
        sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.54.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

    Sie haben 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 einen Webserver auf dem Knoten mit dem lokalen Repository, 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 aus der .tar-Datei :

    1. Verwenden Sie auf dem Knoten mit dem lokalen Repository den folgenden Befehl, um das lokale Repository in einer einzelnen .tar-Datei mit dem Namen /opt/apigee/data/apigee-mirror/apigee-4.54.00.tar.gz zu packen: 
      /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 sie beispielsweise in das /tmp Verzeichnis auf dem neuen Knoten.
    3. Deaktivieren Sie SELinux auf dem neuen Knoten wie oben beschrieben.
    4. Achten Sie auf dem neuen Knoten darauf, dass Sie auf das lokale Yum-Dienstprogramm-Repository und das EPEL Repository zugreifen können.
    5. Prüfen Sie noch einmal, ob alle externen Internet-Repositorys deaktiviert sind. Das sollte der Fall sein, da Sie die Installation auf einem Computer ohne Internetzugriff ausführen: 
      sudo yum repolist

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

    6. Verwenden Sie apigee-service, um das Dienstprogramm apigee-setup 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.

    Installation aus dem Repository mit dem Nginx-Webserver

    So installieren Sie aus dem Repository mit dem 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 werden. So ändern Sie diese Werte:
      1. Öffnen Sie /opt/apigee/customer/application/mirror.properties in einem Editor. Erstellen Sie die Datei, falls sie 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 restart
    3. Standardmäßig erfordert das Repository einen Nutzernamen und ein Passwort von admin:admin. Wenn Sie diese Anmeldedaten ändern möchten, legen Sie die folgenden Umgebungsvariablen fest: 
      MIRROR_USERNAME=uName
MIRROR_PASSWORD=pWord
    4. Achten Sie auf dem neuen Knoten darauf, dass das EPEL-Repository lokal aktiviert ist.
    5. Prüfen Sie auf dem neuen Knoten Ihre Version von libdb4 wie oben beschrieben.
    6. Installieren Sie auf dem Remote-Knoten das Edge-Dienstprogramm apigee-service und die zugehörigen Abhängigkeiten: 
      sudo bash /tmp/bootstrap_4.54.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      Dabei sind uName:pWord der Nutzername und das Passwort des Repositorys.

    7. Verwenden Sie auf dem Remote-Knoten apigee-service, um das apigee-setup Dienstprogramm zu installieren: 
      /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 Datei „bootstrap_4.54.00.sh“ herunterladen und dann eine neue Synchronisierung durchführen.

    So aktualisieren Sie das Repository :

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

    3. Aktualisieren Sie apigee-mirror: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
    4. Führen Sie die Synchronisierung aus: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
    5. Wenn Sie das gesamte Repository synchronisieren möchten: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

    Lokales Apigee-Repository bereinigen

    Beim Bereinigen 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