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 Prozess:

1. Deaktivieren Sie SELinux auf dem Knoten oder stellen Sie es auf den moderaten Modus ein. Weitere Informationen finden Sie unter Edge-Dienstprogramm „apigee-setup“ installieren.
2. Entscheiden Sie, ob Sie die Cassandra-Authentifizierung aktivieren möchten.
3. Entscheiden Sie, ob Sie die 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 auf jedem Knoten in der ausgewählten Topologie das Edge-apigee-setup-Dienstprogramm:
   • Laden Sie die Edge-Datei bootstrap_4.52.02.sh in /tmp/bootstrap_4.52.02.sh herunter.
   • Installieren Sie das Edge-Dienstprogramm apigee-service und die Abhängigkeiten.
   • Installieren Sie das Edge-Dienstprogramm apigee-setup und die Abhängigkeiten.

     Weitere Informationen finden Sie unter Das Edge-Dienstprogramm „apigee-setup“ installieren.

6. Mit dem apigee-setup-Dienstprogramm können Sie eine oder mehrere Edge-Komponenten auf jedem Knoten basierend auf der ausgewählten Topologie installieren.

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

7. Verwenden Sie auf dem Management Server-Knoten das apigee-setup-Dienstprogramm, um apigee-provision zu installieren. Mit diesen Dienstprogrammen erstellen und verwalten Sie Edge-Organisationen.

   Weitere Informationen finden Sie unter Organisation einrichten.

8. Starten Sie die Classic UI-Komponente auf jedem Knoten nach Abschluss der Installation neu, wie das folgende Beispiel zeigt:

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

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

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

Nach der Installation können Sie sich diese Liste mit häufigen Aktionen nach der Installation ansehen.

Wer kann die Installation durchführen?

Die Apigee Edge-Verteilungsdateien werden als eine Reihe von 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 vollständigem Sudo-Zugriff ausgeführt werden. Für den vollständigen sudo-Zugriff bedeutet dies, dass der Nutzer sudo-Zugriff hat, um dieselben Vorgänge wie der Root-Nutzer auszuführen.

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

• apigee-service-Dienstprogramm:
  • apigee-service-Befehle: install, uninstall, update.
  • apigee-all-Befehle: install, uninstall, update.
• Das Skript setup.sh zum Installieren von Edge-Komponenten (es sei denn, Sie haben bereits „apigee-service install“ verwendet, um die erforderlichen RPMs zu installieren). Dann Root- oder vollständiger sudo-Zugriff, falls nicht erforderlich.)
• update.sh-Skript zum Aktualisieren von Edge-Komponenten

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

Alle Nutzer, die andere als die oben gezeigten Befehle ausführen möchten, müssen Nutzer mit vollständigem SUDO-Zugriff auf den Nutzer „apigee“ sein. Dazu gehören:

• apigee-service-Befehle, darunter:
  • apigee-service-Befehle wie start, stop, restart, configure.
  • apigee-all-Befehle wie start, stop, restart, configure.

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

Wenn Sie einem Nutzer vollständigen Sudo-Zugriff auf den Nutzer „apigee“ gewähren möchten, verwenden Sie den Befehl „visudo“, um die sudoers-Datei zu bearbeiten und Folgendes hinzuzufügen:

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 ihren Eigentümer in „apigee:apigee“ ändern, damit sie für Edge-Befehle zugänglich ist:

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

Aufteilen der Edge-Installationsaufgaben zwischen Root- und Nicht-Root-Nutzer

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

1. Vom Root ausgeführte Aufgaben:
   1. Laden Sie die Datei bootstrap_4.52.02.sh herunter und führen Sie sie aus:

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

      In diesem Schritt wird das Dienstprogramm apigee-service installiert und der Nutzer „apigee“ erstellt.

   2. Konfigurieren Sie einen Nutzer so, dass er vollständigen sudo-Zugriff auf den Nutzer „apigee“ hat, 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

      Welche Edge-RPMs Sie auf dem Knoten installieren, hängt 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 vollem Sudo-Zugriff auf den Nutzer „apigee“ den Konfigurationsprozess ab:
   1. Mit dem Dienstprogramm setup.sh können Sie die Konfiguration der Edge-Komponenten auf dem Knoten abschließ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.

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

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

      Dabei ist configFile die Edge-Konfigurationsdatei.

      Alternativ können Sie die folgende Option verwenden, um alles in einem Schritt zu installieren:

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

Speicherort der Installationskonfigurationsdateien

Sie müssen dem apigee-setup-Dienstprogramm eine Konfigurationsdatei übergeben, die die Informationen zur Edge-Installation enthält. Die einzige Anforderung an die stille Installation ist, dass die Konfigurationsdatei für den Nutzer „apigee“ zugänglich oder lesbar sein muss. Legen Sie die Datei beispielsweise im Verzeichnis /usr/local/var oder /usr/local/share auf dem Knoten ab und chown sie auf „apigee:apigee“.

Alle Informationen in der Konfigurationsdatei sind erforderlich, mit Ausnahme des Passworts des Edge-Systemadministrators. Wenn Sie das Passwort weglassen, werden Sie vom apigee-setup-Dienstprogramm aufgefordert, es in der 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 ist so konzipiert, dass es wiederholt ausgeführt werden kann, 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-UI-Komponente auf jedem Knoten neu starten, auf dem sie ausgeführt wird.

Installation mit oder ohne Internetverbindung

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

• Knoten mit externer 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 Repositories im internen Netzwerk verfügbar sind.

  Zum Erstellen des internen Apigee-Repositorys 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 auf den Edge-Knoten zugänglich machen.

Lokales Edge-Repository zum Verwalten Ihrer Edge-Version verwenden

Einer der Gründe für die Verwendung eines lokalen oder gespiegelten Repositorys ist die Installation von Edge auf Knoten ohne externe Internetverbindung, wie im vorherigen Abschnitt beschrieben.

Abhängigkeiten für die RPM-Installation auflösen

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

Wenn Sie die Installation auf einem Computer mit Internetzugang durchfü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 mit allen erforderlichen Abhängigkeiten ein. Die einzige Möglichkeit, um sicherzustellen, dass alle Abhängigkeiten in Ihrem lokalen Repository enthalten sind, besteht darin, eine Installation zu versuchen, alle fehlenden Abhängigkeiten zu identifizieren und sie in das lokale Repository zu kopieren, bis die Installation erfolgreich ist.

Häufig verwendete Yum-Befehle

Die Edge-Installationstools für Linux basieren auf 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 Operations Guide wird das Stammverzeichnis der Installation 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 setup.sh-Skript 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 Logs für den Verwaltungsserver befinden sich beispielsweise im folgenden Verzeichnis:

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

In der folgenden Tabelle ist der Speicherort der Logdateien aufgeführt:

Daten

Systemprüfung bei der Installation aktivieren

Die Edge-Installationskonfigurationsdatei unterstützt die folgende Eigenschaft:

ENABLE_SYSTEM_CHECK=y

Wenn Sie diese Property auf „y“ setzen, 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.