Edge-Installation – Übersicht

Edge for Private Cloud Version 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 Vorgang:

  • Deaktivieren Sie SELinux auf dem Knoten oder stellen Sie den Modus in den moderat. Weitere Informationen finden Sie unter Installieren Sie das Hilfsprogramm für das Edge-Apigee-Setup.
  • Legen Sie fest, 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. Zum Beispiel haben Sie Edge kann zu Testzwecken auf einem einzelnen Knoten oder in der Produktion auf 13 Knoten installiert werden. 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 folgenden Ordner herunter: /tmp/bootstrap_4.17.05.sh
    • Installieren Sie das Edge-Dienstprogramm apigee-service und Abhängigkeiten.
    • Installieren Sie das Edge-Dienstprogramm apigee-setup und die Abhängigkeiten.

      Siehe Installieren des Edge-Apigee-Setups .
  • Verwenden Sie das apigee-setup. eine oder mehrere Edge-Komponenten auf jedem Knoten auf Basis des ausgewählten Topologie.
    Weitere Informationen finden Sie unter Edge-Komponenten auf einem Knoten installieren auf einer Knoten.
  • Verwenden Sie auf dem Verwaltungsserverknoten 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 kann die Installation durchführen?

Die Apigee Edge-Verteilungsdateien werden als RPMs und Abhängigkeiten installiert. Bis Edge-RPMs installieren, deinstallieren und aktualisieren, müssen die Befehle vom Root-Nutzer oder von einem Nutzer ausgeführt werden. mit vollem sudo-Zugriff. Bei einem vollständigen sudo-Zugriff hat der Nutzer sudo-Zugriff, um diese auszuführen. dieselben Vorgänge wie Root.

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

  • apigee-service-Dienstprogramm:
    • apigee-service-Befehle: installieren, deinstallieren, aktualisieren.
    • apigee-all-Befehle: installieren, deinstallieren, aktualisieren.
  • Skript setup.sh zum Installieren von Edge-Komponenten (es sei denn, Sie haben bereits „Apigee-Service-Installation“ bis die erforderlichen RPMs installieren. Dann Root- oder vollen Sudo-Zugriff, falls nicht erforderlich.)
  • Script update.sh zum Aktualisieren von Edge-Komponenten

Außerdem erstellt der Edge-Installer einen neuen Benutzer 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 als die oben aufgeführten Befehle ausführen möchte, muss ein Nutzer mit vollständiger sudo-Zugriff auf den „apigee“ Nutzer. Zu diesen Befehlen gehören:

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

Nutzer erstellen mit vollständiger Sudo-Zugriff auf „Apigee“ Nutzer

Um einen Benutzer so zu konfigurieren, dass er vollständigen sudo-Zugriff auf das „apigee“-Element hat verwenden Sie den Befehl „visudo“ Befehl für bearbeiten Sie die sudoers-Datei, um sie hinzuzufügen:

installUser        ALL=(apigee)      NOPASSWD: ALL

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

Berechtigungen werden festgelegt Konfigurationsdateien

Alle von den Edge-Befehlen verwendeten Dateien oder Ressourcen müssen für den „Apigee“ zugänglich sein Nutzer. 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. Wählen Sie den Eigentümer der Datei zu „apigee:apigee“ aus oder wenn Sie den Nutzer geändert haben, aus dem „Apigee“-Dienst Nutzer, geben Sie die Datei an den Nutzer an, der den Edge-Browser ausführt. Service.

Trennen Edge-Installationsaufgaben zwischen Root- und Nicht-Root-Nutzer

Es ist zwar am einfachsten, den gesamten Edge-Installationsprozess als Root oder von einem Benutzer durchzuführen, der vollen Sudo-Zugriff hat, ist das nicht immer möglich. Stattdessen können Sie in Aufgaben, die vom Stammverzeichnis ausgeführt werden, und in Aufgaben, die von einem Nutzer mit vollständiger sudo-Zugriff auf den „apigee“ Nutzer.

  1. Vom 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

      Dieser Schritt installiert das Dienstprogramm apigee-service und erstellt das „Apigee“ Nutzer.
    2. Konfigurieren Sie einen Benutzer so, dass er vollen sudo-Zugriff auf den „Apigee“ hat wie beschrieben oben.
    3. Installieren Sie das Dienstprogramm apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    4. Verwenden Sie das Dienstprogramm apigee-setup zur Installation Edge-RPMs auf dem Knoten:
      > /opt/apigee/apigee-service/bin/apigee-service compName installieren

      Die Edge-RPMs, die Sie auf dem Knoten installieren, hängen von Ihrer Topologie ab. Die Liste der verfügbaren Komponenten umfassen: apigee-provision, Apigee-Validieren, Apigee-Zookeeper, Apigee-Cassandra, Apigee-Openldap, Edge-UI, Edge-Management-Server, Edge-UI, Edge-Router Edge-Nachrichtenprozessor, Apigee-postgresql, Apigee-qpidd, Edge-Postgres-Server, Edge-qpid-Server.
  2. Nachdem der Root-Nutzer die Edge-RPMs auf dem Knoten installiert hat, hat der Nutzer mit vollständiger sudo-Zugriff auf den „apigee“ Der Nutzer schließt den Konfigurationsprozess ab:
    1. Sie verwenden die Datei setup.sh. um die Konfiguration der Edge-Komponenten auf dem Knoten abzuschließen. Die Form des abhängig von den Komponenten, die Sie auf dem Knoten installiert haben. Eine vollständige Liste finden Sie unter Edge-Komponenten auf einem Knoten installieren
      Verwenden Sie beispielsweise Folgendes, um die Installation von ZooKeeper und Cassandra abzuschließen: Befehl:
      > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile

      Dabei ist configFile die Edge-Konfigurationsdatei.

      Wenn Sie eine All-in-one-Installation ausführen möchten, verwenden Sie den folgenden Befehl:
      > /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile

Speicherort der Installationskonfiguration Dateien

Sie müssen eine Konfigurationsdatei an das Dienstprogramm apigee-setup übergeben, das die Informationen zur Edge-Installation. Die einzige Anforderung bei stillen Installationen ist, Konfigurationsdatei muss vom „Apigee“ zugänglich oder lesbar sein Nutzer. Fügen Sie zum Beispiel die Datei im /usr/local/var-Tag oder Verzeichnis /usr/local/share auf dem Knoten und benennen ihn in „apigee:apigee“.

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

Siehe Edge-Komponenten auf einem Knoten installieren für mehr.

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 ausfü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-Internet-Installation

Um Edge auf einem Knoten zu installieren, 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 den Edge zu installieren RPMs und Abhängigkeiten.
  • Knoten ohne externe Internetverbindung

    Knoten ohne externe Internetverbindung können auf eine gespiegelte Version von Apigee zugreifen das Sie intern einrichten. 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-Repositories benötigen Sie einen Knoten mit externem Internetzugriff, um die Edge-RPMs und Abhängigkeiten herunterladen zu können. Sobald Sie die internes Repository, können Sie es dann auf einen anderen Knoten verschieben oder diesen Knoten für den Edge zugänglich machen. Knoten für die Installation.

Lokales Edge-Repository zur Pflege 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 nutzen, wie im vorherigen Abschnitt beschrieben.

Die Verwendung eines lokalen Repositorys hat jedoch auch einen weiteren Vorteil für Knoten mit einem externen eine Internetverbindung. 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 Version von Edge erstellen, 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.

Beispielsweise verwenden Sie zuerst das lokale Repository, um eine Edge-Entwicklungsumgebung zu installieren. Gehen Sie dann so vor: Wenn Sie bereit für den Wechsel in eine Produktionsumgebung sind, installieren Sie Edge erneut von der lokalen Repository. Durch die Installation aus dem lokalen Repository stellen Sie sicher, dass Ihre Entwicklung und Produktion Umgebungen übereinstimmen.

Ein gespiegeltes Repository ist sehr flexibel. Sie können beispielsweise ein gespiegeltes Repository aus aktuelle Edge-RPMs oder von einer bestimmten Edge-Version. Nachdem Sie das Repository erstellt haben, können Sie es auch aktualisieren, um RPMs aus verschiedenen Edge-Versionen hinzuzufügen. Siehe Installieren des Edge-Apigee-Setup-Dienstprogramms für mehr.

RPM-Installationsabhängigkeiten beheben

Die Apigee Edge-Distributionsdateien werden als eine Reihe von RPM-Dateien installiert, von denen jede eine eine eigene Kette von Installationsabhängigkeiten. Viele dieser Abhängigkeiten werden von Drittanbietern Komponenten, die außerhalb der Kontrolle von Apigee liegen und sich jederzeit ändern können. Daher wird in der Dokumentation nicht die explizite Versionsnummer jeder Abhängigkeit aufgeführt.

Wenn Sie eine Installation auf einem Computer mit Internetzugriff ausführen, kann der Knoten die erforderlichen RPMs und Abhängigkeiten herunterladen. Wenn Sie die Installation von einem Knoten ohne Internet aus durchführen, einrichten, 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, fehlende Abhängigkeiten identifizieren und bis zur Installation in das lokale Repository kopieren erfolgreich ist.

Häufig verwendete Yum-Befehle

Die Edge-Installationstools für Linux nutzen Yum, um Komponenten zu installieren und zu aktualisieren. Möglicherweise mehrere Yum-Befehle verwenden müssen, um eine Installation auf einem Knoten zu verwalten.

  • Lösche 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 Handbuch und im Edge-Betriebshandbuch wird das Stammverzeichnis der Installation angegeben. als:

/opt/apigee

Die Installation verwendet die folgende Dateisystemstruktur, um Apigee Edge for Private bereitzustellen Cloud

Protokolldateien

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

Die Protokolldateien für jede Komponente sind im Verzeichnis /opt/apigee/var/log enthalten. Jede Komponente hat ein eigenes Unterverzeichnis. Die Protokolle für den Verwaltungsserver befinden sich beispielsweise im Verzeichnis:

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

In den folgenden Tabellen ist der Speicherort der Logdateien aufgeführt:

Komponenten

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

Edge-Benutzeroberfläche

/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

Qpidd

/opt/apigee/var/log/apigee-qpidd

PostgreSQL-Datenbank

/opt/apigee/var/log/apigee-postgresql

Daten

Komponenten

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

Qpidd

/opt/apigee/data/apigee-qpid/data

PostgreSQL-Datenbank

/opt/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

Um Edge nach der Installation zu konfigurieren, verwenden Sie eine Kombination aus .properties-Dateien und Edge-Dienstprogrammen. Für Beispiel: Um TLS/SSL in der Edge-Benutzeroberfläche zu konfigurieren, bearbeiten Sie .properties-Dateien, um die erforderlichen Eigenschaften. 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.

Um eine Eigenschaft für eine Komponente festzulegen, bearbeiten Sie die entsprechende .properties-Datei und starten Sie dann neu der Komponente:

> /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 /opt/apigee/customer/application gelesen werden. Das bedeutet, dass bei der Aktualisierung alle Eigenschaften beibehalten werden, die Sie für die Komponente festgelegt haben.

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

Befehle in Edge aufrufen Komponenten

Edge installiert Verwaltungs-Dienstprogramme unter /opt/apigee/apigee-service/bin, die Sie ausführen können. zum Verwalten einer Edge-Installation. Sie können beispielsweise das Dienstprogramm apigee-all zum Starten, Stoppen, Neustarten oder den Status aller Edge-Komponenten auf dem Knoten 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 das folgende 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 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. Jedes Unterverzeichnis ist mit dem Präfix:

  • apigee – ein Drittanbieter von Edge verwendete Komponente. Beispiel: apigee-cassandra.
  • edge – eine Edge-Komponente von Apigee. Beispiel: edge-management-server.
  • edge-mint – Monetarisierung Komponente. Beispiel: edge-mint-management-server.
  • baas – ein 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, stopp, neu starten
  • status, version
  • Sicherung, Wiederherstellung
  • install, uninstall