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 setzen Sie es in den permissiven Modus. Weitere Informationen finden Sie unter Das 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 zur Verwendung in Tests auf einem einzelnen Knoten oder für die Produktion auf 13 Knoten installieren. Weitere Informationen finden Sie unter Installationstopologien.
5. Installieren Sie auf jedem Knoten in der ausgewählten Topologie das Edge-Dienstprogramm apigee-setup:
   • Laden Sie die Edge-Datei bootstrap_4.54.00.sh in das Verzeichnis /tmp/bootstrap_4.54.00.sh herunter.
   • Installieren Sie das Edge-Dienstprogramm apigee-service und die zugehörigen Abhängigkeiten.
   • Installieren Sie das Edge-Dienstprogramm apigee-setup und die zugehörigen Abhängigkeiten.

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

6. Verwenden Sie das apigee-setup Dienstprogramm, um basierend auf der ausgewählten 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 des Verwaltungsservers das apigee-setup Dienstprogramm, um apigee-provision zu installieren. Dieses Dienstprogramm wird zum Erstellen und Verwalten von Edge Organisationen verwendet.

   Weitere Informationen finden Sie unter Organisation einbinden.

8. Starten Sie die New Edge UI-Komponente auf jedem Knoten nach Abschluss der Installation neu, wie im folgenden Beispiel gezeigt:

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

9. Konfigurieren Sie die Authentifizierung und optionale Einstellungen für die New Edge UI (deren Komponentennamen edge-management-ui und edge-management-ui-static sind).

   Weitere Informationen finden Sie unter New Edge UI konfigurieren.

Nach Abschluss der Installation finden Sie hier eine Liste häufiger Aktionen nach der Installation.

Wer kann die Installation durchführen?

Die Apigee Edge-Distributionsdateien 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. Vollständiger sudo-Zugriff bedeutet, 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-Nutzer oder ein Nutzer mit vollständigem sudo-Zugriff sein:

• Dienstprogramm apigee-service:
  • apigee-service -Befehle: install, uninstall, update.
  • apigee-all -Befehle: install, uninstall, update.
• setup.sh -Skript zum Installieren von Edge-Komponenten (es sei denn, Sie haben bereits "apigee-service install" verwendet, um die erforderlichen RPMs zu installieren. In diesem Fall ist kein Root- oder vollständiger sudo Zugriff erforderlich.)
• update.sh -Skript zum Aktualisieren von Edge-Komponenten

Außerdem erstellt das Edge-Installationsprogramm einen neuen Nutzer auf Ihrem System mit dem Namen „apigee“. 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 ein Nutzer mit vollständigem sudo-Zugriff auf den Nutzer „apigee“ sein. Zu diesen Befehlen gehören:

• Befehle des Dienstprogramms apigee-service, einschließlich:
  • apigee-service -Befehle wie start, stop, restart, configure.
  • apigee-all -Befehle wie start, stop, restart, configure.

Nutzer mit vollständigem sudo-Zugriff auf den Nutzer „apigee“ erstellen

Wenn Sie einen Nutzer mit vollständigem sudo-Zugriff auf den Nutzer „apigee“ konfigurieren möchten, verwenden Sie den Befehl „visudo“, um die Datei „sudoers“ 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 den Inhaber in "apigee:apigee" ändern, um sicherzustellen, dass sie für Edge-Befehle zugänglich ist:

1. Erstellen Sie die Datei in einem Editor als beliebiger Nutzer.
2. Ändern Sie den Inhaber der Datei mit dem Befehl chown in „apigee:apigee“. Wenn Sie den Nutzer , der den Edge-Dienst ausführt, vom Nutzer „apigee“ geändert haben, ändern Sie den Inhaber der Datei in den Nutzer, der den Edge-Dienst ausführt.

Edge-Installationsaufgaben zwischen Root- und Nicht-Root-Nutzern aufteilen

Am einfachsten ist es, den gesamten Edge-Installationsprozess als Root-Nutzer oder von einem Nutzer, der vollständigen sudo-Zugriff hat, auszuführen. Das ist jedoch nicht immer möglich. Stattdessen können Sie den Prozess in Aufgaben aufteilen, 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-Nutzer ausgeführt werden:
   1. Laden Sie die Datei bootstrap_4.54.00.sh herunter und führen Sie sie aus:

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

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

   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-management-ui, edge-management-ui-static, 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 Nutzer "apigee" 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 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.

      Verwenden Sie den folgenden Befehl, um eine All-in-one-Installation durchzuführen:

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

Speicherort der Installationskonfigurationsdateien

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

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

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

Installationsfehler beheben

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.

Starten Sie nach der Installation oder dem Upgrade die New Edge UI-Komponente auf jedem Knoten neu, auf dem sie ausgeführt wird.

Installation mit oder ohne Internetverbindung

Wenn Sie Edge auf einem Knoten installieren möchten, 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, die 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-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.

Lokales Edge-Repository verwenden, um Ihre Edge-Version zu verwalten

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 bei der RPM-Installation auflösen

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 außerhalb der Kontrolle von Apigee liegen und sich jederzeit ändern können. Daher wird in der Dokumentation nicht die genaue Versionsnummer jeder Abhängigkeit aufgeführt.

Wenn Sie eine Installation auf einem Computer mit Internetzugriff durchführen, kann der Knoten die erforderlichen RPMs und Abhängigkeiten herunterladen. Wenn Sie jedoch von einem Knoten ohne Internet Zugriff installieren, richten Sie in der Regel ein internes Repository ein, das alle erforderlichen Abhängigkeiten enthält. Die einzige Möglichkeit , um sicherzustellen, dass alle Abhängigkeiten in Ihrem lokalen Repository enthalten sind, besteht darin, eine Installation zu versuchen, fehlende 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 verwenden 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.

• Alle Yum-Caches leeren:

  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 Stammverzeichnis der Installation so angegeben:

/opt/apigee

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

Protokolldateien

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

Die Protokolldateien für jede Komponente befinden sich im /opt/apigee/var/log Verzeichnis. Jede Komponente hat ein eigenes Unterverzeichnis. Die Protokolle für den Management Server 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 Edge-Installationskonfigurationsdatei unterstützt die folgende Eigenschaft:

ENABLE_SYSTEM_CHECK=y

Wenn Sie diese Eigenschaft auf "y" setzen, prüft das Installationsprogramm, ob das System die CPU- und Arbeitsspeicheranforderungen für die zu installierende Komponente erfüllt. Der Standardwert ist "n", um die Prüfung zu deaktivieren.