Edge-Installation – Übersicht

Edge for Private Cloud Version 4.17.01

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:

  • Deaktivieren Sie SELinux auf dem Knoten oder stellen Sie den Modus in den moderat. Weitere Informationen finden Sie unter Edge-Apigee-Setup-Dienstprogramm installieren.
  • Entscheiden Sie, ob Sie die Cassandra-Authentifizierung aktivieren möchten.
  • Entscheiden Sie, ob Sie eine Master-Standby-Replikation für Postgres einrichten möchten.
  • 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 Master-Standby-Replikation für Postgres einrichten.
  • Installieren Sie auf jedem Knoten in der ausgewählten Topologie das Edge-Hilfsprogramm apigee-setup:
    • Laden Sie die Edge-Datei bootstrap_4.17.01.sh in /tmp/bootstrap_4.17.01.sh herunter.
    • Installieren Sie das Dienstprogramm apigee-service von Edge und die Abhängigkeiten.
    • Installieren Sie das Edge-Hilfsprogramm apigee-setup und die Abhängigkeiten.

      Weitere Informationen finden Sie unter Edge-Apigee-Setup-Dienstprogramm installieren.
  • Verwenden Sie das apigee-setup-Dienstprogramm, 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.
  • Verwenden Sie auf dem Management-Server-Knoten das Hilfsprogramm „apigee-setup“, um „apigee-provision“ zu installieren. Mit diesen Dienstprogrammen können Sie Edge-Organisationen erstellen und verwalten.
    Weitere Informationen finden Sie unter Organisationen einrichten.

Wer die Installation durchführen kann

Die Apigee Edge-Verteilungsdateien werden als RPMs und Abhängigkeiten installiert. Zum Installieren, Deinstallieren und Aktualisieren von Edge müssen die Edge-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 Scripts ausführen möchte, muss entweder Root-Nutzer oder ein Nutzer mit vollem 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 (es sei denn, Sie haben bereits „apigee-service install“ zum Installieren der erforderlichen RPMs verwendet. 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 start, stop, neu starten, konfigurieren.

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

installUser        ALL=(apigee)      NOPASSWD: ALL

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

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.

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. Weisen Sie den Eigentümer der Datei „apigee:apigee“ zu oder, falls Sie den Nutzer geändert haben, der den Edge-Dienst ausführt, weisen Sie die Datei dem Nutzer zu, der den Edge-Dienst ausführt.

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 die Eigentümerschaft 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 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 kann wiederholt ausgeführt werden, wenn ein Fehler erkannt wird oder wenn Sie eine Komponente nach der Installation ändern oder aktualisieren möchten.

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.

    Hinweis: Apigee hostet nicht alle Abhängigkeiten von Drittanbietern in unseren öffentlichen Repositories. Sie müssen diese Abhängigkeiten aus öffentlich zugänglichen Repositories herunterladen und installieren.

    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 an einen anderen Knoten verschieben oder diesen Knoten für die Installation für die Edge-Knoten zugänglich machen.

Lokales Edge-Repository zur Pflege Ihrer Edge-Version verwenden

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

Die Verwendung eines lokalen Repositorys bietet jedoch auch für Knoten mit einer externen Internetverbindung einen weiteren Vorteil. Wenn Sie Edge aus dem öffentlichen Apigee-Repository installieren, werden immer die neuesten Edge-RPMs installiert. Wenn Sie also Edge-RPMs für eine bestimmte Version von Edge herunterladen und speichern möchten, sollten Sie ein lokales Repository für diese Edge-Version erstellen. Sie können dann mit diesem lokalen Repository Installationen für jede Version von Edge ausführen.

Sie verwenden beispielsweise zuerst das lokale Repository, um eine Edge-Entwicklungsumgebung zu installieren. Wenn Sie dann bereit sind, zu einer Produktionsumgebung zu wechseln, installieren Sie Edge noch einmal aus dem lokalen Repository. Wenn Sie aus dem lokalen Repository installieren, sorgen Sie dafür, dass Ihre Entwicklungs- und Produktionsumgebung übereinstimmen.

Ein gespiegeltes Repository ist sehr flexibel. Sie können beispielsweise ein gespiegeltes Repository aus den neuesten Edge-RPMs oder aus einer bestimmten Version von Edge erstellen. Nachdem Sie das Repository erstellt haben, können Sie es auch aktualisieren, um RPMs aus verschiedenen Edge-Versionen hinzuzufügen. Weitere Informationen finden Sie unter Installieren Sie das Hilfsprogramm für das Edge-Apigee-Setup.

RPM-Installationsabhängigkeiten beheben

Die Apigee Edge-Verteilungsdateien werden als 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 die Installation auf einem Computer mit Internetzugriff ausführen, kann der Knoten die erforderlichen RPMs und Abhängigkeiten herunterladen. Wenn Sie jedoch von einem Knoten ohne Internetzugriff aus installieren, richten Sie in der Regel ein internes Repository mit allen erforderlichen Abhängigkeiten ein. Die einzige Möglichkeit, dafür zu sorgen, 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.

  • 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 Stamminstallationsverzeichnis so bezeichnet:

<inst_root>/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 jede Komponente befinden sich im Verzeichnis /opt/apigee/var/log. Jede Komponente hat ein eigenes Unterverzeichnis. Die Protokolle 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:

Komponenten

Standort

Verwaltungsserver

<inst_root>/apigee/var/log/edge-management-server

Router

<inst_root>/apigee/var/log/edge-router

Message Processor

<inst_root>/apigee/var/log/edge-message-processor

Apigee Qpid-Server

<inst_root>/apigee/var/log/edge-qpid-server

Apigee Postgres-Server

&lt;inst_root&gt;/apigee/var/log/edge-postgres-server

Edge-Benutzeroberfläche

<inst_root>/apigee/var/log/edge-ui

ZooKeeper

&lt;inst_root&gt;/apigee/var/log/apigee-zookeeper

OpenLDAP

&lt;inst_root&gt;/apigee/var/log/apigee-openldap

Cassandra

<inst_root>/apigee/var/log/apigee-cassandra

Qpidd

<inst_root>/apigee/var/log/apigee-qpidd

PostgreSQL-Datenbank

&lt;inst_root&gt;/apigee/var/log/apigee-postgresql

Daten

Komponenten

Standort

Verwaltungsserver

&lt;data_root&gt;/apigee/data/edge-management-server

Router

<data_root>/apigee/data/edge-router

Message Processor

<data_root>/apigee/data/edge-message-processor

Apigee-Qpid-Agent

&lt;data_root&gt;/apigee/data/edge-qpid-server

Apigee Postgres-Agent

<data_root>/apigee/data/edge-postgres-server

ZooKeeper

<data_root>/apigee/data/apigee-zookeeper

OpenLDAP

&lt;data_root&gt;/apigee/data/apigee-openldap

Cassandra

<data_root>/apigee/data/apigee-cassandra/data

Qpidd

&lt;data_root&gt;/apigee/data/apigee-qpid/data

PostgreSQL-Datenbank

<data_root>/apigee/data/apigee-postgres/pgdata

Aufgaben nach der Installation

Nach Abschluss der Installation können Sie weitere Aktionen für Edge-Komponenten ausführen.

Konfigurieren von Edge-Komponenten nach der Installation

Zum Konfigurieren von Edge nach der Installation verwenden Sie eine Kombination aus .properties-Dateien und Edge-Dienstprogrammen. Wenn Sie beispielsweise TLS/SSL in der Edge-Benutzeroberfläche konfigurieren möchten, bearbeiten Sie .properties-Dateien, um die erforderlichen Eigenschaften festzulegen. Wenn Sie Änderungen an .properties-Dateien vornehmen, müssen Sie die betroffene Edge-Komponente neu starten.

Die .properties-Dateien befinden sich im Verzeichnis /opt/apigee/customer/application. Jede Komponente hat in diesem Verzeichnis eine eigene .properties-Datei. Beispiel: router.properties und management-server.properties.

Wenn Sie eine Eigenschaft für eine Komponente festlegen möchten, bearbeiten Sie die entsprechende .properties-Datei und starten Sie die Komponente dann neu:

> /opt/apigee/apigee-service/bin/apigee-service component restart

Beispiel:

> /opt/apigee/apigee-service/bin/apigee-service edge-router restart

Wenn Sie Edge aktualisieren, werden die .properties-Dateien im Verzeichnis /opt/apigee/customer/application gelesen. Das bedeutet, dass alle Eigenschaften, die Sie für die Komponente festgelegt haben, beibehalten werden.

Weitere Informationen zur Edge-Konfiguration finden Sie unter So konfigurieren Sie Edge.

Befehle auf Edge-Komponenten ausführen

Edge installiert Verwaltungs-Dienstprogramme unter /opt/apigee/apigee-service/bin, mit denen Sie eine Edge-Installation verwalten können. Mit dem Dienstprogramm apigee-all können Sie beispielsweise alle Edge-Komponenten auf dem Knoten starten, beenden, neu starten oder den Status ermitteln:

/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version

Verwenden Sie das Dienstprogramm apigee-service, um einzelne Komponenten zu steuern und zu konfigurieren. Das Dienstprogramm apigee-service hat die Form:

/opt/apigee/apigee-service/bin/apigee-service component action

So starten Sie beispielsweise den Edge-Router neu:

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

Sie können die Liste der auf dem Knoten installierten Komponenten ermitteln, indem Sie das Verzeichnis /opt/apigee untersuchen. Dieses Verzeichnis enthält ein Unterverzeichnis für jede Edge-Komponente, die auf dem Knoten installiert ist. Jedem Unterverzeichnis wird das Präfix

  • apigee: Eine Drittanbieterkomponente, die von Edge verwendet wird. Beispiel: apigee-cassandra.
  • edge: eine Edge-Komponente von Apigee. Beispiel: edge-management-server.
  • edge-mint: Monetarisierungskomponente Beispiel: edge-mint-management-server.
  • baas – eine API-BaaS-Komponente. Beispiel: baas-usergrid.

Die vollständige Liste der Aktionen für eine Komponente hängt von der Komponente selbst ab. Alle Komponenten unterstützen jedoch die folgenden Aktionen:

  • Starten, Stoppen, Neustarten
  • status, version
  • Sicherung, Wiederherstellung
  • install, uninstall