Diese Seite wurde von der Cloud Translation API übersetzt.

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 erfolgt in mehreren Schritten:

Deaktivieren Sie SELinux auf dem Knoten oder stellen Sie den Modus in den moderat. Weitere Informationen finden Sie unter Edge-Apigee-Setup-Dienstprogramm installieren.
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. Sie können Edge beispielsweise zu Testzwecken auf einem einzelnen Knoten oder in der Produktion auf 13 Knoten 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.52.02.sh in /tmp/bootstrap_4.52.02.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-Apigee-Setup-Dienstprogramm installieren.
Verwenden Sie das Dienstprogramm apigee-setup, um eine oder mehrere Edge-Komponenten auf jedem Knoten basierend auf der ausgewählten Topologie zu installieren.
Siehe Edge-Komponenten auf einem Knoten installieren.
Verwenden Sie auf dem Verwaltungsserverknoten 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.
Starten Sie die klassische UI-Komponente auf jedem Knoten neu, nachdem die Installation abgeschlossen ist, wie im folgenden Beispiel gezeigt:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
(Empfohlen) Nachdem Sie die Erstinstallation abgeschlossen haben, empfiehlt Apigee, dass Sie die neue Edge-Benutzeroberfläche (mit dem Komponentennamen edge-management-ui) installieren. Diese ist eine verbesserte Benutzeroberfläche für Entwickler und Administratoren von Apigee Edge für Private Cloud.

Weitere Informationen finden Sie unter Installieren der neuen Edge-Benutzeroberfläche.

Sehen Sie sich nach Abschluss der Installation diese Liste gängiger Aktionen nach der Installation an.

Wer kann die Installation durchführen?

Die Apigee Edge-Distributionsdateien werden als ein Satz von RPMs und Abhängigkeiten installiert. Um Edge-RPMs zu installieren, zu deinstallieren und zu aktualisieren, müssen die Befehle vom Root-Nutzer oder von einem Nutzer mit uneingeschränktem sudo-Zugriff ausgeführt werden. Für einen vollständigen 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 Skripts ausführen möchte, muss entweder ein Root-Nutzer oder ein Nutzer mit uneingeschränktem sudo-Zugriff sein:

apigee-service-Dienstprogramm:
- 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" zum Installieren der erforderlichen RPMs verwendet. Root-Zugriff oder vollständigen Sudo-Zugriff, falls nicht erforderlich.)
Skript 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 „Apigee“-Benutzer ausgeführt zu werden.

Jeder Nutzer, der alle anderen Befehle als die oben gezeigten ausführen möchte, muss ein Nutzer mit vollständigem sudo-Zugriff auf den „apigee“-Nutzer sein. Zu diesen Befehlen gehören:

Apigee-service-Dienstprogrammbefehle, einschließlich:
- apigee-service-Befehle wie start, stop, restart, configure.
- apigee-all-Befehle wie z. B. start, stop, restart, configure.

Benutzer mit vollständigem sudo-Zugriff auf den „Apigee“-Benutzer erstellen

HINWEIS: Sie können diesen Schritt erst ausführen, nachdem Sie die Datei bootstrap_4.52.02.sh ausgeführt haben, um den „apigee“-Nutzer zu erstellen.

Um einen Benutzer so zu konfigurieren, dass er vollständigen sudo-Zugriff auf den „apigee“-Nutzer 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. Dies umfasst die Edge-Lizenzdatei und alle Konfigurationsdateien.

Beim Erstellen einer Konfigurationsdatei können Sie deren Eigentümer in „apigee:apigee“ ändern, um sicherzustellen, dass Edge-Befehle Zugriff auf die Datei haben:

Erstellen Sie die Datei in einem Editor als beliebiger Nutzer.
chown ist der Eigentümer der Datei zu „apigee:apigee“. Wenn Sie den Nutzer, der den Edge-Dienst ausführt, vom „Apigee“-Benutzer geändert haben, weisen Sie die Datei dem Benutzer zu, der den Edge-Dienst ausführt.

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

Es ist zwar am einfachsten, den gesamten Edge-Installationsprozess als Root oder von einem Benutzer mit vollem sudo-Zugriff durchzuführen, dies ist jedoch nicht immer möglich. Stattdessen können Sie den Prozess in Aufgaben aufteilen, die vom Root ausgeführt werden, und Aufgaben, die von einem Benutzer mit vollständigem Sud-Zugriff auf den „Apigee“-Benutzer ausgeführt werden.

Vom Root ausgeführte Aufgaben:
1. Laden Sie die Datei bootstrap_4.52.02.sh herunter und führen Sie sie aus:
```
curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord
```
  Dieser Schritt installiert das Dienstprogramm apigee-service und erstellt den „apigee“-Nutzer.
2. Konfigurieren Sie einen Nutzer so, dass er vollständigen sudo-Zugriff auf den „apigee“-Nutzer hat, wie unter Nutzer mit vollständigem sudo-Zugriff auf „apigee“-Nutzer erstellen beschrieben.
3. Installieren Sie das Dienstprogramm apigee-setup:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
```
4. Installieren Sie mit dem Dienstprogramm apigee-setup Edge-RPMs auf dem Knoten:
```
/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.
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 ausführen möchten, verwenden Sie den folgenden Befehl:
```
/opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
```

Speicherort der Konfigurationsdateien für die Installation

Sie müssen eine Konfigurationsdatei an das Dienstprogramm apigee-setup übergeben, das die Informationen zur Edge-Installation enthält. Die einzige Anforderung bei stillen Installationen besteht darin, dass die Konfigurationsdatei für den „apigee“-Nutzer 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 chown setzen Sie sie 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 die Befehlszeile einzugeben.

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

Umgang mit Installationsfehlern

Tritt bei der Installation einer Edge-Komponente ein Fehler auf, 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 wird, wenn ein Fehler erkannt wird oder Sie später eine Komponente nach der Installation ändern oder aktualisieren möchten.

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

Internet- oder Nicht-Internet-Installation

Um Edge auf einem Knoten zu installieren, 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, 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.

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-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 Edge-Knoten zur Installation zugänglich machen.

Verwenden eines lokalen Edge-Repositorys zum Verwalten Ihrer Edge-Version

Einer der Gründe für die Verwendung eines lokalen oder gespiegelten Repositorys besteht darin, Edge auf Knoten ohne externe Internetverbindung zu installieren, wie im vorherigen Abschnitt beschrieben.

Hinweis: Die Verwendung eines lokalen Repositorys hat jedoch auch bei 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 daher 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.

Beispielsweise verwenden Sie zuerst das lokale Repository, um eine Edge-Entwicklungsumgebung zu installieren. Wenn Sie dann in eine Produktionsumgebung wechseln möchten, installieren Sie Edge noch einmal aus dem lokalen Repository. Durch die Installation aus dem lokalen Repository stellen Sie sicher, 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 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 Edge-Apigee-Setup-Dienstprogramm installieren.

RPM-Installationsabhängigkeiten beheben

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 Komponenten von Drittanbietern 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 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 Internetzugang installieren, 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 auszuführen, fehlende Abhängigkeiten zu ermitteln und sie in das lokale Repository zu kopieren, bis die Installation erfolgreich ist.

Häufig verwendete 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.

Leeren 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 dieser Anleitung und im Edge-Betriebshandbuch wird das Stammverzeichnis der Installation wie folgt vermerkt:

/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 sind im Verzeichnis /opt/apigee/var/log enthalten. Jede Komponente hat ein eigenes Unterverzeichnis. Die Logs 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:

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`
QPID	`/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`
QPID	`/opt/apigee/data/apigee-qpid/data`
PostgreSQL-Datenbank	`/opt/apigee/data/apigee-postgres/pgdata`
`apigee-monit`	`/opt/apigee/data/apigee-monit`

Systemprüfung bei Installation aktivieren

Die Konfigurationsdatei für die Edge-Installation unterstützt die folgende Eigenschaft:

ENABLE_SYSTEM_CHECK=y

Wenn Sie dieses Attribut auf „y“ festlegen, 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.