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 den Berechtigungsmodus 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-Stand-by-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 zum Testen 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-apigee-setup-Dienstprogramm:
    • Laden Sie die Edge-Datei bootstrap_4.52.01.sh in /tmp/bootstrap_4.52.01.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 Edge-Dienstprogramm apigee-setup installieren.

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

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

  7. Verwenden Sie auf dem Verwaltungsserver-Knoten das Dienstprogramm apigee-setup, um apigee-provision zu installieren. Dies sind die Dienstprogramme, mit denen Sie Edge-Organisationen erstellen und verwalten.

    Weitere Informationen finden Sie unter Organisation einrichten.

  8. Starten Sie die Komponente der klassischen UI auf jedem Knoten nach Abschluss der Installation neu, wie im folgenden Beispiel gezeigt:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  9. (Empfohlen) Nach Abschluss der Erstinstallation empfiehlt Apigee, dass Sie die neue Edge-UI installieren, deren Komponentenname edge-management-ui lautet. Diese 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.

Sehen Sie sich nach Abschluss der Installation diese Liste häufiger Aktionen nach der Installation an.

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 uneingeschränktem sudo-Zugriff ausgeführt werden. Für vollständigen Sudo-Zugriff bedeutet das, dass der Nutzer sudo-Zugriff hat und dieselben Vorgänge wie Root ausführen kann.

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

  • Dienstprogramm apigee-service:
    • apigee-service-Befehle: install, uninstall, update.
    • apigee-all-Befehle: install, uninstall, update.
  • setup.sh-Skript zum Installieren der Edge-Komponenten (es sei denn, Sie haben zur Installation der erforderlichen RPMs bereits „apigee-service install“ verwendet). Root- oder vollständigen Sudo-Zugriff, falls nicht erforderlich.)
  • Skript update.sh zum Aktualisieren von Edge-Komponenten

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

Jeder Nutzer, der alle anderen als die oben aufgeführten Befehle ausführen möchte, muss ein Nutzer mit uneingeschränktem Sudo-Zugriff auf den Nutzer „apigee“ sein. Zu diesen Befehlen gehören:

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

Erstellen eines Benutzers mit vollständigem Sudo-Zugriff auf den Benutzer „apigee“

Wenn Sie einen Nutzer so konfigurieren möchten, dass er vollständigen sudo-Zugriff auf den Nutzer „apigee“ hat, verwenden Sie den Befehl „visudo“, um die sudoers-Datei zu bearbeiten und hinzuzufügen:

installUser        ALL=(apigee)      NOPASSWD: ALL

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

Berechtigungen für Konfigurationsdateien festlegen

Alle von den Edge-Befehlen verwendeten Dateien oder Ressourcen müssen für den „Apigee“-Benutzer zugänglich sein. Dazu gehören die Edge-Lizenzdatei und alle Konfigurationsdateien.

Beim Erstellen einer Konfigurationsdatei können Sie ihren Eigentümer in „apigee:apigee“ ändern, um sicherzustellen, dass sie für Edge-Befehle zugänglich ist:

  1. Erstellen Sie die Datei als beliebiger Nutzer in einem Editor.
  2. chown den Eigentümer der Datei in „apigee:apigee“ oder, wenn Sie den Benutzer, der den Edge-Dienst ausführt, vom Benutzer „apigee“ aus geändert haben, wählen Sie die Datei für den Benutzer aus, der den Edge-Dienst ausführt.

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

Es ist zwar am einfachsten, den gesamten Edge-Installationsprozess als Root oder durch einen Nutzer mit uneingeschränktem sudo-Zugriff auszuführen. Dies ist jedoch nicht immer möglich. Stattdessen können Sie den Prozess in Aufgaben unterteilen, die von Root ausgeführt werden, und Aufgaben, die von einem Nutzer mit uneingeschränktem Sudo-Zugriff auf den „apigee“-Nutzer ausgeführt werden.

  1. Von Root ausgeführte Aufgaben:
    1. Laden Sie die Datei bootstrap_4.52.01.sh herunter und führen Sie sie aus:
      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
      sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

      Mit 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 "apigee"-Benutzer hat, wie unter Erstellen eines Benutzers mit vollständigem Sudo-Zugriff für den "apigee"-Benutzer 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.

      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 den folgenden Befehl verwenden, um eine Komplettinstallation durchzuführen:

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

Speicherort der Konfigurationsdateien der Installation

Sie müssen eine Konfigurationsdatei an das Dienstprogramm apigee-setup übergeben, das die Informationen zur Edge-Installation enthält. Die einzige Anforderung bei unbeaufsichtigten Installationen besteht darin, dass die Konfigurationsdatei für den „Apigee“-Benutzer zugänglich oder lesbar sein muss. Speichern Sie die Datei beispielsweise im Verzeichnis /usr/local/var oder /usr/local/share auf dem Knoten und chown in „apigee:apigee“.

Alle Informationen in der Konfigurationsdatei sind mit Ausnahme des Kennworts des Edge-Systemadministrators erforderlich. 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.

Umgang mit Installationsfehlern

Wenn während der Installation einer Edge-Komponente ein Fehler auftritt, können Sie versuchen, das Problem zu beheben, und das Installationsprogramm dann noch einmal ausführen. Das Installationsprogramm ist so konzipiert, dass es wiederholt ausgeführt werden kann, wenn ein Fehler festgestellt wird oder wenn Sie eine Komponente später nach der Installation ändern oder aktualisieren möchten.

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

Installation über das Internet oder andere Geräte

Damit Sie Edge auf einem Knoten installieren können, 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 darauf achten, 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 einem externen Internetzugriff, um die Edge-RPMs und Abhängigkeiten herunterzuladen. 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.

Ein 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.

RPM-Installationsabhängigkeiten 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 durch Drittanbieterkomponenten definiert, die sich außerhalb der Kontrolle von Apigee befinden und sich jederzeit ändern können. Daher enthält die Dokumentation nicht die explizite Versionsnummer jeder Abhängigkeit.

Wenn Sie die Installation auf einem Computer mit Internetzugang ausführen, kann der Knoten die erforderlichen RPMs und Abhängigkeiten herunterladen. Wenn die Installation jedoch von einem Knoten ohne Internetzugang erfolgt, richten Sie normalerweise 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 durchzufü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 benötigen für die Installation und Aktualisierung der Komponenten Yum. Möglicherweise müssen Sie mehrere Yum-Befehle verwenden, um eine Installation auf einem Knoten zu verwalten.

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

Struktur des Dateisystems

Edge installiert alle Dateien im Verzeichnis /opt/apigee.

In dieser Anleitung und im Edge-Betriebshandbuch wird das Stammverzeichnis für die Installation folgendermaßen angegeben:

/opt/apigee

Die Installation verwendet die folgende Dateisystemstruktur, um Apigee Edge für Private Cloud bereitzustellen.

Protokolldateien

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

Die Logdateien für jede Komponente 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 den folgenden Tabellen ist der Speicherort der Protokolldateien aufgeführt:

Komponente Standort

Verwaltungsserver

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

Router

/opt/apigee/var/log/edge-router

Der Edge Router wird mit Nginx implementiert. Weitere Logs finden Sie unter:

/opt/apigee/var/log/edge-router/nginx
/opt/nginx/logs

Message Processor

/opt/apigee/var/log/edge-message-processor

Apigee Qpid-Server

/opt/apigee/var/log/edge-qpid-server
Apigee Postgres-Server /opt/apigee/var/log/edge-postgres-server
Klassische Benutzeroberfläche (nicht die neue Edge-Benutzeroberfläche, deren Komponentenname edge-management-ui ist) /opt/apigee/var/log/edge-ui
ZooKeeper /opt/apigee/var/log/apigee-zookeeper
OpenLDAP /opt/apigee/var/log/apigee-openldap
Cassandra /opt/apigee/var/log/apigee-cassandra/system.log
Logo: QPidd /opt/apigee/var/log/apigee-qpidd
PostgreSQL-Datenbank /opt/apigee/var/log/apigee-postgresql
apigee-monit /opt/apigee/var/log/apigee-monit

Daten

Komponente Standort
Verwaltungsserver /opt/apigee/data/edge-management-server
Router /opt/apigee/data/edge-router
Message Processor /opt/apigee/data/edge-message-processor
Apigee Qpid-Agent /opt/apigee/data/edge-qpid-server
Apigee Postgres-Agent /opt/apigee/data/edge-postgres-server
ZooKeeper /opt/apigee/data/apigee-zookeeper
OpenLDAP /opt/apigee/data/apigee-openldap
Cassandra /opt/apigee/data/apigee-cassandra/data
Logo: QPidd /opt/apigee/data/apigee-qpid/data
PostgreSQL-Datenbank /opt/apigee/data/apigee-postgres/pgdata
apigee-monit /opt/apigee/data/apigee-monit

Systemprüfung bei der Installation aktivieren

Die Konfigurationsdatei der Edge-Installation unterstützt das folgende Attribut:

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 installierte Komponente erfüllt. Der Standardwert ist „n“, um die Prüfung zu deaktivieren.