Diese Seite wurde von der Cloud Translation API übersetzt.

Edge-Installation – Übersicht

Edge for Private Cloud v4.19.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 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 Installieren Sie das Edge-Apigee-Setup-Dienstprogramm für mehr.
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 Weitere Informationen finden Sie unter Installationstopologien.
Installieren Sie auf jedem Knoten in der ausgewählten Topologie das Edge-Dienstprogramm apigee-setup: <ph type="x-smartling-placeholder">
- Laden Sie die Edge-Datei bootstrap_4.19.01.sh herunter in /tmp/bootstrap_4.19.01.sh.
- Installieren Sie das Edge-Dienstprogramm apigee-service und die Abhängigkeiten.
- Installieren Sie das Edge-Dienstprogramm apigee-setup und die Abhängigkeiten.
  Siehe Edge-Apigee-Setup-Dienstprogramm installieren finden Sie weitere Informationen.
Installieren Sie mit dem Dienstprogramm apigee-setup eine oder mehrere Edge-Komponenten auf jeder Komponente Knoten basierend auf der ausgewählten Topologie.
Siehe Edge-Komponenten auf einem Knoten installieren.
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.
Starten Sie die Edge-UI-Komponente auf jedem Knoten nach Abschluss der Installation neu, wie Das folgende Beispiel zeigt:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```

Nach Abschluss der Installation können Sie sich diese Liste gängige Aktionen nach der Installation.

Wer kann die Installation durchführen?

Die Apigee Edge-Distributionsdateien werden als ein Satz von 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 eine Aktion 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: <ph type="x-smartling-placeholder">
- 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“ um die erforderlichen RPMs zu installieren. Dann Root oder vollständiges sudo Zugriffsrechte, falls diese nicht erforderlich sind.)
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 Sie sudo auf, um als „apigee“ ausgeführt zu werden. Nutzer.

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: <ph type="x-smartling-placeholder">
- 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 „apigee“ erstellen Nutzer

Hinweis: Sie können diesen Schritt erst ausführen, nachdem Sie bootstrap_4.19.01.sh-Datei zum Erstellen des Apigee Nutzer.

Um einen Benutzer so zu konfigurieren, dass er vollen sudo-Zugriff auf den „Apigee“ 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 für Konfigurationsdateien festlegen

Alle von den Edge-Befehlen verwendeten Dateien oder Ressourcen müssen für den „Apigee“ zugänglich sein Nutzer. Dieses enthält die Edge-Lizenzdatei und alle Konfigurationsdateien.

Beim Erstellen einer Konfigurationsdatei können Sie deren Eigentümer in „apigee:apigee“ ändern um sicherzustellen, Es ist für Edge-Befehle zugänglich:

Erstellen Sie die Datei in einem Editor als beliebiger Nutzer.
chown ist der Eigentümer der Datei an „apigee:apigee“ oder, wenn Sie den Nutzer Ausführen des Edge-Dienstes aus dem „Apigee“ Nutzer, geben Sie die Datei an den Nutzer an, der ausgeführt wird. dem Edge-Dienst.

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

Vom Root ausgeführte Aufgaben: <ph type="x-smartling-placeholder">
1. Laden Sie die Datei bootstrap_4.19.01.sh herunter und führen Sie sie aus:
```
curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
sudo bash /tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord
```
  Dieser Schritt installiert das Dienstprogramm apigee-service und erstellt den Apigee Nutzer.
2. Konfigurieren Sie einen Benutzer, um vollständigen sudo-Zugriff auf den „Apigee“ zu haben wie beschrieben in Nutzer mit vollständigem sudo-Zugriff auf „apigee“ erstellen Nutzer.
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ügbare Komponenten sind: 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, kann der Nutzer mit vollständigem sudo-Zugriff Apigee Der Nutzer schließt den Konfigurationsprozess ab: <ph type="x-smartling-placeholder">
1. Verwenden Sie das Dienstprogramm setup.sh, um die Konfiguration des Edges abzuschließen Komponenten auf dem Knoten. Die Form des Befehls hängt von den Komponenten ab, die auf dem Knoten installiert sind. 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 Konfigurationsdateien für die Installation

Sie müssen eine Konfigurationsdatei an das apigee-setup-Dienstprogramm ü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 Verzeichnis /usr/local/var oder /usr/local/share auf dem Knoten und chown es in „apigee:apigee“ ein.

Alle Informationen in der Konfigurationsdatei sind erforderlich, mit Ausnahme des Edge-Systems Administratorpasswort eingeben. Wenn Sie das Passwort weglassen, fordert das apigee-setup-Dienstprogramm eine entsprechende Meldung an. in die Befehlszeile eingeben müssen.

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, und führen Sie das Installationsprogramm dann erneut aus. Das Installationsprogramm ist so konzipiert, dass es wiederholt in wenn ein Fehler erkannt wird oder Sie später eine Komponente nach dem Installation.

Nach der Installation oder dem Upgrade müssen Sie die Edge-Benutzeroberflächenkomponente auf jedem Knoten neu starten, auf dem 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 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. Achten Sie darauf, dass alle anderen Abhängigkeiten aus Repositories auf dem internen Netzwerk.

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

Zum Erstellen des internen Apigee-Repositorys benötigen Sie einen Knoten mit externem Internet 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.

Verwenden eines lokalen Edge-Repositorys zum Verwalten 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 nutzen, wie im vorherigen Abschnitt beschrieben.

</ph> Hinweis: Die Verwendung eines lokalen Repositorys hat jedoch auch für Knoten mit einem eine externe Internetverbindung nutzen. Wenn Sie Edge aus dem öffentlichen Apigee-Repository installieren, immer die neuesten Edge-RPMs installieren. Wenn Sie Edge zum Herunterladen und Speichern RPMs für eine bestimmte Edge-Version festlegen, 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. 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 dem aktuelle Edge-RPMs oder von einer bestimmten Edge-Version. Nachdem Sie das Repository erstellt haben, können Sie Aktualisieren Sie es, 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 entspricht der Parameter ist in der Dokumentation nicht die explizite Versionsnummer der einzelnen Abhängigkeiten aufgeführt.

Wenn Sie eine Installation auf einem Computer mit Internetzugang ausführen, kann der Knoten die erforderlichen RPMs und Abhängigkeiten. 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, Ermitteln Sie fehlende Abhängigkeiten und kopieren Sie sie bis zur Installation in das lokale Repository. 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.

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 diesem Handbuch und im Edge-Betriebshandbuch wird das Installationsverzeichnis wie folgt angegeben:

/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 wird in /tmp/setup-root.log

Die Protokolldateien für jede Komponente sind in /opt/apigee/var/log enthalten. -Verzeichnis. Jede Komponente hat ein eigenes Unterverzeichnis. Zum Beispiel die Logs für die Verwaltung Die Server befinden sich 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`
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`
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 diese Eigenschaft auf „y“ setzen, prüft das Installationsprogramm, ob das System die CPU- und für die zu installierende Komponente benötigt werden. Der Standardwert ist „n“. zum Deaktivieren der überprüfen.