Edge-Installation – Übersicht

Edge for Private Cloud v. 4.17.05

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:

• Deaktivieren Sie SELinux auf dem Knoten oder legen Sie den moderaten Modus fest. Weitere Informationen finden Sie unter Edge-Dienstprogramm „apigee-setup“ installieren.
• Entscheiden Sie, ob Sie die Cassandra-Authentifizierung aktivieren möchten.
• Entscheiden Sie, ob Sie die 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 zu Testzwecken oder auf 13 Knoten für die Produktion installieren. Weitere Informationen finden Sie unter Installationstopologien.
• Installieren Sie auf jedem Knoten in der ausgewählten Topologie das Edge-Dienstprogramm apigee-setup:
  • Laden Sie die Edge-Datei bootstrap_4.17.05.sh in /tmp/bootstrap_4.17.05.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.
• Verwenden Sie das Dienstprogramm apigee-setup, um eine oder mehrere Edge-Komponenten auf jedem Knoten basierend auf der ausgewählten Topologie zu installieren.
  Weitere Informationen finden Sie unter Edge-Komponenten auf einem Knoten installieren.
• Verwenden Sie auf dem Management Server-Knoten das Dienstprogramm „apigee-setup“, um „apigee-provision“ zu installieren, die Dienstprogramme, mit denen Sie Edge-Organisationen erstellen und verwalten.
  Weitere Informationen finden Sie unter Organisation einrichten.

Wer die Installation durchführen kann

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.

Nutzer, die die folgenden Befehle oder Skripts ausführen möchten, müssen entweder Root-Nutzer oder Nutzer mit vollständigem sudo-Zugriff sein:

• apigee-service-Dienstprogramm:
  • apigee-service-Befehle: install, uninstall, update.
  • apigee-all-Befehle: install, uninstall, update.
• setup.sh-Skript zur Installation 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 namens „apigee“ auf Ihrem System. Viele Edge-Befehle rufen sudo auf, um als „apigee“-Nutzer ausgeführt zu werden.

Nutzer, die andere als die oben aufgeführten Befehle ausführen möchten, müssen über vollständigen SUDO-Zugriff auf den Nutzer „apigee“ verfügen. Diese Befehle umfassen:

• apigee-service-Dienstprogrammbefehle, 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 so konfigurieren möchten, dass er vollen sudo-Zugriff auf den Nutzer „apigee“ hat, 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 den 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. Ändern Sie den Eigentümer der Datei in „apigee:apigee“ oder, wenn Sie den Nutzer, der den Edge-Dienst ausführt, vom Nutzer „apigee“ geändert haben, ändern Sie den Eigentümer der Datei in den Nutzer, der den Edge-Dienst ausführt.

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

Am einfachsten ist es, den gesamten Edge-Installationsprozess als Root-Nutzer oder als Nutzer mit vollständigem sudo-Zugriff auszuführen. Das ist jedoch nicht immer möglich. Stattdessen können Sie den Prozess in Aufgaben aufteilen, die von Root ausgeführt werden, und Aufgaben, die von einem Nutzer mit vollständigem sudo-Zugriff auf den Nutzer „apigee“ ausgeführt werden.

1. Von Root ausgeführte Aufgaben:
   1. Laden Sie die Datei bootstrap_4.17.05.sh herunter und führen Sie sie aus:
      > curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
      > sudo bash /tmp/bootstrap_4.17.05.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 „apigee“-Nutzer hat, wie oben 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-ui, 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.
      
      Wenn Sie eine All-in-One-Installation durchführen möchten, verwenden Sie den folgenden Befehl:
      > /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile

Speicherort der Installationskonfigurationsdateien

Sie müssen eine Konfigurationsdatei an das Dienstprogramm apigee-setup übergeben, die die Informationen zur Edge-Installation enthält. Die einzige Anforderung an automatische Installationen 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 ändern Sie den Eigentümer in „apigee:apigee“.

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 einem Installationsfehler

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

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 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 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 für die Edge-Knoten 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.

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, installieren Sie immer die neuesten Edge-RPMs. Wenn Sie also Edge-RPMs für eine bestimmte Edge-Version herunterladen und speichern möchten, sollten Sie ein lokales Repository für diese Edge-Version erstellen. Sie können dieses lokale Repository dann verwenden, um Installationen für jede Version von Edge durchzuführen.

Sie verwenden beispielsweise zuerst das lokale Repository, um eine Edge-Entwicklungsumgebung zu installieren. Wenn Sie dann bereit sind, in eine Produktionsumgebung zu wechseln, installieren Sie Edge noch einmal aus dem lokalen Repository. Durch die Installation aus dem lokalen Repository wird sichergestellt, dass Ihre Entwicklungs- und Produktionsumgebungen übereinstimmen.

Ein gespiegeltes Repository ist sehr flexibel. Sie können beispielsweise ein gespiegeltes Repository aus den neuesten Edge-RPMs oder aus einer bestimmten Edge-Version 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 Edge-Dienstprogramm „apigee-setup“ installieren.

RPM-Installationsabhängigkeiten auflösen

Die Apigee Edge-Verteilungsdateien 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 explizite Versionsnummer der einzelnen Abhängigkeiten 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 die Installation jedoch von einem Knoten ohne Internetzugriff ausführen, 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 zu versuchen, fehlende Abhängigkeiten zu identifizieren und sie in das lokale Repository zu kopieren, bis die Installation erfolgreich ist.

Gängige 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.

• Löschen 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 Stammverzeichnis der Installation so angegeben:

/opt/apigee

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

Protokolldateien

Die Logdatei für apigee-setup und das Skript setup.sh werden 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 Management Server befinden sich beispielsweise im Verzeichnis:

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

In den folgenden Tabellen sind die Speicherorte der Logdateien aufgeführt:

Daten

Aufgaben nach der Installation

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

Edge-Komponenten nach der Installation konfigurieren

Wenn Sie Edge nach der Installation konfigurieren möchten, 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 Attribute festzulegen. Bei Änderungen an .properties-Dateien 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 ein Attribut 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 bei der Aktualisierung alle Attribute beibehalten werden, die Sie für die Komponente festgelegt haben.

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

Befehle für Edge-Komponenten aufrufen

Edge installiert Verwaltungsprogramme unter /opt/apigee/apigee-service/bin, mit denen Sie eine Edge-Installation verwalten können. Beispielsweise können Sie mit dem Dienstprogramm apigee-all 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 folgendes Format:

/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 im Verzeichnis /opt/apigee einsehen. Dieses Verzeichnis enthält ein Unterverzeichnis für jede auf dem Knoten installierte Edge-Komponente. Jedem Unterverzeichnis wird Folgendes vorangestellt:

• apigee: Eine von Edge verwendete Drittanbieterkomponente. Beispiel: apigee-cassandra.
• edge: eine Edge-Komponente von Apigee. Beispiel: edge-management-server.
• edge-mint: eine 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:

• start, stop, restart
• status, version
• Sicherung, Wiederherstellung
• install, uninstall