Edge-Installation – Übersicht

Eine typische Edge-Installation besteht aus Edge-Komponenten, die auf mehrere Knoten verteilt sind. Nachdem Sie Edge auf einem Knoten installiert haben, installieren und konfigurieren Sie eine oder mehrere Edge-Komponenten auf dem Knoten.

Installationsprozess

Die Installation von Edge auf einem Knoten ist ein mehrstufiger Vorgang:

1. Deaktivieren Sie SELinux auf dem Knoten oder setzen Sie es auf den Modus „Permissive“. Weitere Informationen finden Sie unter Installieren Sie das Hilfsprogramm für das Edge-Apigee-Setup.
2. Entscheiden Sie, ob Sie die Cassandra-Authentifizierung aktivieren möchten.
3. Entscheiden Sie, ob Sie eine Master-Standby-Replikation für Postgres einrichten möchten.
4. Wählen Sie Ihre Edge-Konfiguration aus der Liste der empfohlenen Topologien aus. Sie können Edge beispielsweise auf einem einzelnen Knoten für Tests oder auf 13 Knoten für die Produktion installieren. Weitere Informationen finden Sie unter Installationstopologien.
5. Installieren Sie das Edge apigee-setup-Dienstprogramm auf jedem Knoten in der ausgewählten Topologie:
   • Laden Sie die Edge-Datei bootstrap_4.53.00.sh auf /tmp/bootstrap_4.53.00.sh herunter.
   • Installieren Sie das Edge apigee-service-Hilfsprogramm und die Abhängigkeiten.
   • Installieren Sie das Edge apigee-setup-Hilfsprogramm und die Abhängigkeiten.

     Weitere Informationen finden Sie unter Installieren Sie das Hilfsprogramm für das Edge-Apigee-Setup.

6. Verwenden Sie das Dienstprogramm apigee-setup, um je nach ausgewählter Topologie eine oder mehrere Edge-Komponenten auf jedem Knoten zu installieren.

   Weitere Informationen finden Sie unter Edge-Komponenten auf einem Knoten installieren.

7. Verwenden Sie auf dem Knoten „Verwaltungsserver“ das Dienstprogramm apigee-setup, um apigee-provision zu installieren. Mit diesen Dienstprogrammen können Sie Edge-Organisationen erstellen und verwalten.

   Weitere Informationen finden Sie unter Organisation einrichten.

8. Starten Sie die Komponente der klassischen Benutzeroberfläche auf jedem Knoten neu, nachdem die Installation abgeschlossen ist, wie im folgenden Beispiel gezeigt:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

9. (Empfohlen) Nach Abschluss der Erstinstallation empfiehlt Apigee, die neue Edge-Benutzeroberfläche (Komponentenname edge-management-ui) zu installieren. Dies ist eine erweiterte Benutzeroberfläche für Entwickler und Administratoren von Apigee Edge for Private Cloud.

   Weitere Informationen finden Sie unter Neue Edge-Benutzeroberfläche installieren.

Sehen Sie sich nach Abschluss der Installation diese Liste gängiger Aktionen nach der Installation an.

Wer die Installation durchführen kann

Die Apigee Edge-Verteilungsdateien werden als RPMs und Abhängigkeiten installiert. Zum Installieren, Deinstallieren und Aktualisieren von Edge-RPMs müssen die Befehle vom Root-Nutzer oder von einem Nutzer mit vollem Sudo-Zugriff ausgeführt werden. Für den uneingeschränkten sudo-Zugriff bedeutet dies, dass der Nutzer sudo-Zugriff hat, um dieselben Vorgänge wie root auszuführen.

Jeder Nutzer, der die folgenden Befehle oder Skripts ausführen möchte, muss entweder ein Root-Nutzer oder ein Nutzer mit uneingeschränktem sudo-Zugriff sein:

• apigee-service-Dienstprogramm:
  • apigee-service-Befehle: install, uninstall, update.
  • apigee-all-Befehle: install, uninstall, update.
• Skript setup.sh zum Installieren von Edge-Komponenten, sofern Sie die erforderlichen RPMs nicht bereits mit apigee-service install installiert haben Root-Zugriff oder vollständigen Sudo-Zugriff, falls nicht erforderlich.)
• Script update.sh zum Aktualisieren von Edge-Komponenten

Außerdem erstellt das Edge-Installationsprogramm einen neuen Nutzer mit dem Namen „apigee“ auf Ihrem System. Viele Edge-Befehle rufen sudo auf, um als Nutzer „apigee“ ausgeführt zu werden.

Jeder Nutzer, der alle anderen Befehle als die oben genannten ausführen möchte, muss einen vollständigen Sudo-Zugriff auf den Nutzer „apigee“ haben. Zu diesen Befehlen gehören:

• Dienstbefehle für apigee-service, darunter:
  • apigee-service-Befehle wie start, stop, restart, configure
  • apigee-all-Befehle wie z. B. start, stop, restart, configure.

Nutzer mit vollem Sudo-Zugriff auf den Nutzer „apigee“ erstellen

Wenn Sie einen Nutzer mit vollem Sudo-Zugriff auf den Nutzer „apigee“ konfigurieren möchten, bearbeiten Sie mit dem Befehl „visudo“ die Sudoers-Datei und fügen Sie Folgendes hinzu:

installUser        ALL=(apigee)      NOPASSWD: ALL

Dabei ist installUser der Nutzername der Person, die mit Edge arbeitet.

Berechtigungen für Konfigurationsdateien festlegen

Alle Dateien oder Ressourcen, die von den Edge-Befehlen verwendet werden, müssen für den Nutzer „apigee“ zugänglich sein. Dazu gehören die Edge-Lizenzdatei und alle Konfigurationsdateien.

Wenn Sie eine Konfigurationsdatei erstellen, können Sie den Eigentümer in „apigee:apigee“ ändern, damit Edge-Befehle darauf zugreifen können:

1. Erstellen Sie die Datei in einem Editor als beliebiger Nutzer.
2. chown den Eigentümer der Datei auf „apigee:apigee“ festlegen oder, wenn Sie den Nutzer geändert haben, der den Edge-Dienst ausführt, die Datei dem Nutzer zuweisen, der den Edge-Dienst ausführt.

Edge-Installationsaufgaben zwischen Root- und Nicht-Root-Nutzer trennen

Es ist zwar am einfachsten, den gesamten Edge-Installationsprozess als Root oder von einem Benutzer mit vollem sudo-Zugriff durchzuführen, dies ist jedoch nicht immer möglich. Stattdessen können Sie den Prozess in Aufgaben unterteilen, die vom Root-Nutzer und von einem Nutzer mit vollständigem sudo-Zugriff auf den Nutzer „apigee“ ausgeführt werden.

1. Aufgaben, die vom Root ausgeführt werden:
   1. Laden Sie die Datei bootstrap_4.53.00.sh herunter und führen Sie sie aus:

      curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord

      Dieser Schritt installiert das Dienstprogramm apigee-service und erstellt den „apigee“-Nutzer.

   2. Konfigurieren Sie einen Nutzer mit vollständigem sudo-Zugriff auf den Nutzer „apigee“, wie unter Nutzer mit vollständigem sudo-Zugriff auf den Nutzer „apigee“ erstellen beschrieben.
   3. Installieren Sie das Dienstprogramm apigee-setup:

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

   4. Verwenden Sie das Dienstprogramm apigee-setup, um Edge-RPMs auf dem Knoten zu installieren:

      /opt/apigee/apigee-service/bin/apigee-service compName install

      Die Edge-RPMs, die Sie auf dem Knoten installieren, hängen von Ihrer Topologie ab. Die Liste der verfügbaren Komponenten umfasst: apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-management-server, edge-ui, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server.

2. Nachdem der Root-Nutzer die Edge-RPMs auf dem Knoten installiert hat, schließt der Nutzer mit vollständigem sudo-Zugriff auf den „Apigee“-Nutzer den Konfigurationsprozess ab:
   1. Verwenden Sie das Dienstprogramm setup.sh, um die Konfiguration der Edge-Komponenten auf dem Knoten abzuschließen. Die Form des Befehls hängt von den Komponenten ab, die Sie auf dem Knoten installiert haben. Eine vollständige Liste finden Sie unter Edge-Komponenten auf einem Knoten installieren.

      Um beispielsweise die Installation von ZooKeeper und Cassandra abzuschließen, verwenden Sie den folgenden Befehl:

      /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile

      Dabei ist configFile die Edge-Konfigurationsdatei.

      Für eine Komplettinstallation können Sie auch den folgenden Befehl verwenden:

      /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile

Speicherort der Installationskonfigurationsdateien

Sie müssen dem Dienstprogramm apigee-setup eine Konfigurationsdatei mit den Informationen zur Edge-Installation übergeben. Die einzige Voraussetzung für die Installation im Hintergrund ist, dass die Konfigurationsdatei für den Nutzer „apigee“ zugänglich oder lesbar sein muss. Sie können die Datei beispielsweise im Verzeichnis /usr/local/var oder /usr/local/share auf dem Knoten ablegen und chown auf „apigee:apigee“ festlegen.

Alle Informationen in der Konfigurationsdatei sind erforderlich, mit Ausnahme des Passworts des Edge-Systemadministrators. Wenn Sie das Passwort weglassen, werden Sie vom Dienstprogramm apigee-setup aufgefordert, es in die Befehlszeile einzugeben.

Weitere Informationen finden Sie unter Edge-Komponenten auf einem Knoten installieren.

Umgang mit Installationsfehlern

Wenn bei der Installation einer Edge-Komponente ein Fehler auftritt, können Sie versuchen, das Problem zu beheben und das Installationsprogramm dann noch einmal auszuführen. Das Installationsprogramm kann wiederholt ausgeführt werden, wenn ein Fehler erkannt wird oder wenn Sie eine Komponente nach der Installation ändern oder aktualisieren möchten.

Nach der Installation oder dem Upgrade müssen Sie die Edge-Benutzeroberfläche auf jedem Knoten neu starten, auf dem sie ausgeführt wird.

Internet- oder nicht internetbasierte Installation

Damit Edge auf einem Knoten installiert werden kann, muss der Knoten auf das Apigee-Repository zugreifen können:

• Knoten mit einer externen Internetverbindung

  Knoten mit einer externen Internetverbindung greifen auf das Apigee-Repository zu, um die Edge-RPMs und -Abhängigkeiten zu installieren.

• Knoten ohne externe Internetverbindung

  Knoten ohne externe Internetverbindung können auf eine gespiegelte Version des Apigee-Repositorys zugreifen, das Sie intern eingerichtet haben. Dieses Repository enthält alle Edge-RPMs. Sie müssen jedoch dafür sorgen, dass alle anderen Abhängigkeiten aus Repos im internen Netzwerk verfügbar sind.

  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 Edge-Knoten zur Installation zugänglich machen.

Verwenden eines lokalen Edge-Repositorys zum Verwalten Ihrer Edge-Version

Einer der Gründe für die Verwendung eines lokalen oder gespiegelten Repositorys besteht darin, Edge auf Knoten ohne externe Internetverbindung zu installieren, wie im vorherigen Abschnitt beschrieben.

RPM-Installationsabhängigkeiten beheben

Die Apigee Edge-Distributionsdateien werden als eine Reihe von RPM-Dateien installiert, von denen jede eine eigene Kette von Installationsabhängigkeiten haben kann. Viele dieser Abhängigkeiten werden von Drittanbieterkomponenten definiert, die nicht von Apigee verwaltet werden und sich jederzeit ändern können. Daher wird in der Dokumentation nicht die explizite Versionsnummer jeder Abhängigkeit aufgeführt.

Wenn Sie eine Installation auf einem Computer mit Internetzugang ausführen, kann der Knoten die erforderlichen RPMs und Abhängigkeiten herunterladen. Wenn Sie jedoch von einem Knoten ohne Internetzugang installieren, richten Sie in der Regel ein internes Repository ein, das alle erforderlichen Abhängigkeiten enthält. Die einzige Möglichkeit, sicherzustellen, dass alle Abhängigkeiten in Ihrem lokalen Repository enthalten sind, besteht darin, eine Installation auszuführen, fehlende Abhängigkeiten zu ermitteln und sie in das lokale Repository zu kopieren, bis die Installation erfolgreich ist.

Gängige Yum-Befehle

Die Edge-Installationstools für Linux nutzen Yum, um Komponenten zu installieren und zu aktualisieren. Möglicherweise müssen Sie mehrere Yum-Befehle verwenden, um eine Installation auf einem Knoten zu verwalten.

• Leeren Sie alle Yum-Caches:

  sudo yum clean all

• So aktualisieren Sie eine Edge-Komponente:

  sudo yum update componentName

  Beispiel:

  sudo yum update apigee-setup
  sudo yum update edge-management-server

Dateisystemstruktur

Edge installiert alle Dateien im Verzeichnis /opt/apigee.

In diesem Leitfaden und im Edge-Betriebsleitfaden wird das Stamminstallationsverzeichnis so angegeben:

/opt/apigee

Bei der Installation wird die folgende Dateisystemstruktur verwendet, um Apigee Edge for Private Cloud bereitzustellen.

Logdateien

Die Logdatei für apigee-setup und das Skript setup.sh wird in /tmp/setup-root.log geschrieben.

Die Logdateien für die einzelnen Komponenten befinden sich im Verzeichnis /opt/apigee/var/log. Jede Komponente hat ein eigenes Unterverzeichnis. Die Protokolle für den Verwaltungsserver befinden sich beispielsweise im Verzeichnis:

/opt/apigee/var/log/edge-management-server

In den folgenden Tabellen ist der Speicherort der Protokolldateien aufgeführt:

Daten

Systemprüfung bei der Installation aktivieren

Die Konfigurationsdatei für die Edge-Installation unterstützt die folgende Eigenschaft:

ENABLE_SYSTEM_CHECK=y

Wenn Sie diese Property auf „y“ festlegen, prüft das Installationsprogramm, ob das System die CPU- und Speicheranforderungen für die zu installierende Komponente erfüllt. Der Standardwert ist „n“, um die Prüfung zu deaktivieren.