Diese Seite wurde von der Cloud Translation API übersetzt.

Edge-Installation – Übersicht

Eine typische Edge-Installation besteht aus Edge-Komponenten, die über 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 setzen Sie es in den moderaten Modus. Weitere Informationen finden Sie unter Edge-Apigee-Setup-Dienstprogramm 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 zu Testzwecken auf einem einzelnen Knoten oder für die 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-bootstrap_4.19.06.sh-Datei in /tmp/bootstrap_4.19.06.sh herunter.
- Installieren Sie das Edge-apigee-service-Dienstprogramm und die Abhängigkeiten.
- Installieren Sie das Edge-apigee-setup-Dienstprogramm 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.
Weitere Informationen finden Sie unter Edge-Komponenten auf einem Knoten installieren.
Verwenden Sie auf dem Management-Server-Knoten das Dienstprogramm apigee-setup zum Installieren von apigee-provision, den Dienstprogrammen, die Sie zum Erstellen und Verwalten von Edge-Organisationen verwenden.
Weitere Informationen finden Sie unter Organisation einrichten.
Starten Sie die Komponente der klassischen UI auf jedem Knoten neu, nachdem die Installation abgeschlossen hat. Hier ein Beispiel:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
(Empfohlen) Nach Abschluss der Erstinstallation empfiehlt Apigee die Installation der neuen Edge-UI (ihren Komponentennamens edge-management-ui), einer erweiterten Benutzeroberfläche für Entwickler und Administratoren von Apigee Edge für Private Cloud.

Weitere Informationen finden Sie unter Neue Edge-Benutzeroberfläche installieren.

Nach Abschluss der Installation findest du hier eine Liste gängiger Aktionen nach der Installation.

Wer die Installation durchführen kann

Die Apigee Edge-Distributionsdateien werden als Gruppe 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 den vollständigen Sudo-Zugriff bedeutet dies, dass der Nutzer einen Sudo-Zugriff hat, der dieselben Vorgänge ausführen kann wie der Stamm.

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

apigee-service-Dienstprogramm:
- apigee-service-Befehle: install, uninstall, update.
- apigee-all-Befehle: install, uninstall, update.
setup.sh, um Edge-Komponenten zu installieren (es sei denn, Sie haben „apigee-service install“ bereits verwendet, um die erforderlichen RPMs zu installieren. Ist kein Root- oder uneingeschränkter Sudo-Zugriff erforderlich, sind dies nicht erforderlich.
update.sh-Skript zum Aktualisieren von Edge-Komponenten

Außerdem erstellt das Edge-Installationsprogramm auf Ihrem System einen neuen Nutzer namens „apigee“. Viele Edge-Befehle rufen „sudo“ auf, um sie als „apigee“-Nutzer auszuführen.

Jeder Nutzer, der alle anderen Befehle als die oben aufgeführten ausführen möchte, muss ein Nutzer mit uneingeschränktem Sudo-Zugriff auf den Apigee-Nutzer sein. Diese Befehle umfassen:

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

Einen Nutzer mit uneingeschränktem Sudo-Zugriff auf „apigee“-Nutzer erstellen

HINWEIS: Sie können diesen Schritt erst ausführen, nachdem Sie die Datei bootstrap_4.19.06.sh zum Erstellen des Apigee-Nutzers ausgeführt haben.

Mit dem Befehl „visudo“ können Sie einen Nutzer so konfigurieren, dass er uneingeschränkten Sudo-Zugriff auf den Apigee-Nutzer hat:

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 Edge-Befehlen verwendet werden, müssen für den Apigee-Nutzer zugänglich sein. Dazu gehören die Edge-Lizenzdatei und alle Konfigurationsdateien.

Sie können beim Erstellen einer Konfigurationsdatei den Inhaber in „apigee:apigee“ ändern, damit von Edge-Befehlen darauf zugegriffen werden kann:

Erstellen Sie die Datei in einem Editor als einen beliebigen Nutzer.
chown des Eigentümers der Datei in „apigee:apigee“ oder, wenn Sie den Nutzer, der den Edge-Dienst ausführt, vom „apigee“-Nutzer zu ändern, den Zugriff der Datei auf den Nutzer verzeichnen, der den Edge-Dienst ausführt.

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

Es ist zwar am einfachsten, den gesamten Edge-Installationsvorgang als Root oder von einem Nutzer mit uneingeschränktem Sudo-Zugriff auszuführen, dies ist jedoch nicht immer möglich. Sie können den Vorgang stattdessen in Aufgaben unterteilen, die vom Stamm ausgeführt werden, sowie von Aufgaben, die von einem Nutzer mit uneingeschränktem Sudo-Zugriff auf den Apigee-Nutzer ausgeführt werden.

Vom Stamm ausgeführte Aufgaben:
1. Laden Sie die Datei bootstrap_4.19.06.sh herunter und führen Sie sie aus:
```
curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
sudo bash /tmp/bootstrap_4.19.06.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 vollen Sudo-Zugriff auf den Apigee-Nutzer hat, wie unter Nutzer mit uneingeschränktem 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. 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.
Nachdem der Root-Nutzer die Edge-RPMs auf dem Knoten installiert hat, schließt der Nutzer mit uneingeschränktem Sudo-Zugriff auf den Apigee-Nutzer den Konfigurationsvorgang 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.
  
  Sie können auch den folgenden Befehl ausführen, um eine Komplettlösung zu installieren:
```
/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, das die Informationen zur Edge-Installation enthält. Die einzige Voraussetzung für stille 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 chown auf „apigee:apigee“.

Mit Ausnahme des Passworts des Edge-Systemadministrators sind alle Informationen in der Konfigurationsdatei erforderlich. Wenn Sie das Passwort weglassen, werden Sie vom apigee-setup-Dienstprogramm aufgefordert, es in der Befehlszeile einzugeben.

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

Behebung eines Installationsfehlers

Falls 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 wird, wenn es einen Fehler erkennt oder wenn Sie eine Komponente später nach der Installation ändern oder aktualisieren möchten.

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

Installation mit oder ohne Internetverbindung

Damit Edge auf einem Knoten installiert werden kann, muss er 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 Repositorys im internen Netzwerk verfügbar sind.

Hinweis: Apigee hostet nicht alle Drittanbieter-Abhängigkeiten 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 einem externen 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.

Verwenden eines lokalen Edge-Repositorys zur Verwaltung Ihrer Edge-Version

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.

Hinweis: Die Verwendung eines lokalen Repositorys hat jedoch einen weiteren Vorteil – selbst für Knoten mit einer externen Internetverbindung. Wenn Sie Edge über das öffentliche Apigee-Repository installieren, installieren Sie immer die neuesten Edge-RPMs. Wenn Sie Edge-RPMs für eine bestimmte Version von Edge herunterladen und speichern möchten, sollten Sie daher ein lokales Repository für diese Edge-Version erstellen. Sie können dieses lokale Repository dann verwenden, um Installationen für jede Edge-Version durchzuführen.

Verwenden Sie beispielsweise zuerst das lokale Repository, um eine Edge-Entwicklungsumgebung zu installieren. Wenn Sie dann in eine Produktionsumgebung wechseln möchten, installieren Sie Edge wieder aus dem lokalen Repository. Durch die Installation aus dem lokalen Repository wird gewährleistet, 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 von einer bestimmten Version von Edge erstellen. Nachdem Sie das Repository erstellt haben, können Sie es auch so aktualisieren, dass RPMs von unterschiedlichen Edge-Versionen hinzugefügt werden. Weitere Informationen finden Sie unter Edge-Apigee-Setup-Dienstprogramm installieren.

RPM-Installationen (abhängig)

Die Apigee Edge-Distributionsdateien werden als Gruppe von RPM-Dateien installiert, die jeweils eine eigene Kette von Installationsabhängigkeiten haben können. Viele dieser Abhängigkeiten werden von Komponenten von Drittanbietern definiert, die außerhalb der Kontrolle von Apigee liegen und sich jederzeit ändern können. Die Dokumentation enthält daher nicht die explizite Versionsnummer jeder Abhängigkeit.

Wenn Sie eine Installation auf einem Computer mit Internetzugang ausführen, kann der Knoten die erforderlichen RPMs und Abhängigkeiten herunterladen. Wenn Sie jedoch von einem Knoten ohne Internetzugriff 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 zu versuchen, fehlende Abhängigkeiten zu ermitteln und sie bis zum Abschluss der Installation in das lokale Repository zu kopieren.

Gängige Befehle für Yum

Die Edge-Installationstools für Linux basieren auf 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 bereinigen:
```
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 Operations Guide ist das Stammverzeichnis für die Installation wie folgt 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 werden 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 sind die Speicherorte 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 UI (nicht die neue Edge-UI, 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 der Installation aktivieren

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

ENABLE_SYSTEM_CHECK=y

Wenn Sie dieses Attribut auf „y“ setzen, prüft das Installationsprogramm, ob das System die CPU- und Arbeitsspeicheranforderungen für die zu installierende Komponente erfüllt. Der Standardwert ist „n“, um die Prüfung zu deaktivieren.