Voraussetzungen für die Installation

Edge for Private Cloud v4.18.01

Hardware Requirements

Sie müssen die folgenden Mindestanforderungen an die Hardware für eine hochverfügbare Infrastruktur in einer Produktionsumgebung erfüllen. Für alle in Installationstopologien beschriebenen Installationsszenarien sind in den folgenden Tabellen die Mindesthardwareanforderungen für die Installationskomponenten aufgeführt.

In diesen Tabellen sind die Festplattenanforderungen zusätzlich zum vom Betriebssystem benötigten Festplattenspeicherplatz angegeben. Je nach Anwendungen und Netzwerkverkehr benötigt Ihre Installation möglicherweise mehr oder weniger Ressourcen als unten aufgeführt.

Installationskomponente RAM CPU Mindestanforderungen an die Festplatte
Cassandra 16 GB 8-core 250 GB lokaler Speicher mit SSD oder schneller Festplatte, die 2.000 IOPS unterstützt
Message Processor/Router auf demselben Computer 16 GB 8-core 100 GB
Analytics – Postgres/Qpid auf demselben Server (nicht für die Produktion empfohlen) 16 GB* 8‑Core* 500 GB bis 1 TB** Netzwerkspeicher***, vorzugsweise mit SSD-Backend, der 1.000 IOPS oder mehr unterstützt*
Analytics – eigenständige Postgres-Instanz 16 GB* 8‑Core* 500 GB bis 1 TB** Netzwerkspeicher***, vorzugsweise mit SSD-Backend, der 1.000 IOPS oder mehr unterstützt*
Analytics – eigenständiges Qpid 8 GB 4‑Core 30–50 GB lokaler Speicher mit SSD oder schneller HDD

Für Installationen mit mehr als 250 TPS wird eine HDD mit lokalem Speicher empfohlen, die 1.000 IOPS unterstützt.

Die Standardgröße der Qpid-Warteschlange beträgt 20 GB. Wenn Sie mehr Kapazität benötigen, fügen Sie zusätzliche Qpid-Knoten hinzu.

Andere (OpenLDAP, Benutzeroberfläche, Management Server) 4 GB 2 Core 60 GB

* Postgres-Systemanforderungen basierend auf dem Durchsatz anpassen:

  • Weniger als 250 TPS: 8 GB, 4 Cores können mit verwaltetem Netzwerkspeicher*** mit 1.000 IOPS oder höher in Betracht gezogen werden.
  • Mehr als 250 TPS: 16 GB, 8 Cores, verwalteter Netzwerkspeicher*** mit 1.000 IOPS oder mehr
  • Mehr als 1.000 TPS: 16 GB, 8 Cores, verwalteter Netzwerkspeicher*** mit mindestens 2.000 IOPS
  • Mehr als 2.000 TPS: 32 GB, 16 Cores, verwalteter Netzwerkspeicher*** mit Unterstützung für mindestens 2.000 IOPS
  • Mehr als 4.000 TPS: 64 GB, 32 Cores, verwalteter Netzwerkspeicher*** mit Unterstützung für mindestens 4.000 IOPS

** Der Wert für die Postgres-Festplatte basiert auf den standardmäßigen Analysen, die von Edge erfasst werden. Wenn Sie den Analysedaten benutzerdefinierte Werte hinzufügen, sollten diese Werte entsprechend erhöht werden. Verwenden Sie die folgende Formel, um den erforderlichen Speicherplatz zu schätzen:

bytes of storage needed =

  (# bytes of analytics data/request) *

  (requests/second) *

  (seconds/hour) *

  (hours of peak usage/day) *

  (days/month) *

  (months of data retention)

Beispiel:

(2K bytes) * (100 req/sec) * (3600 secs/hr) * (18 peak hours/day) * (30 days/month) * (3 months retention)

= 1,194,393,600,000 bytes or 1194.4 GB

*** Netzwerkspeicher wird für die PostgreSQL-Datenbank empfohlen, weil:

  • Sie können die Speichergröße dynamisch hochskalieren, wenn dies erforderlich ist.
  • Die Netzwerk-IOPS können in den meisten aktuellen Umgebungs-/Speicher-/Netzwerk-Subsystemen im laufenden Betrieb angepasst werden.
  • Snapshots auf Speicherebene können als Teil von Sicherungs- und Wiederherstellungslösungen aktiviert werden.

Außerdem finden Sie unten die Hardwareanforderungen für die Installation der Monetarisierungsdienste:

Komponente mit Monetarisierung RAM CPU Festplatte
Verwaltungsserver (mit Monetarisierungsdiensten) 8 GB 4‑Core 60 GB
Analytics – Postgres/Qpid auf demselben Server 16 GB 8-core 500 GB bis 1 TB Netzwerkspeicher, vorzugsweise mit SSD-Backend, der 1.000 IOPS oder mehr unterstützt, oder verwenden Sie die Regel aus der Tabelle oben.
Analytics – eigenständige Postgres-Instanz 16 GB 8-core 500 GB bis 1 TB Netzwerkspeicher, vorzugsweise mit SSD-Backend, der 1.000 IOPS oder mehr unterstützt, oder verwenden Sie die Regel aus der Tabelle oben.
Analytics – eigenständiges Qpid 8 GB 4‑Core 40 GB bis 500 GB lokaler Speicher mit SSD oder schneller HDD

Für Installationen mit mehr als 250 TPS wird eine HDD mit lokalem Speicher empfohlen, die 1.000 IOPS unterstützt.

Im Folgenden sind die Hardwareanforderungen für die Installation von API BaaS aufgeführt:

API BaaS Component RAM CPU Festplatte
ElasticSearch* 8 GB 4‑Core 60–80 GB
API BaaS Stack* 8 GB 4‑Core 60–80 GB
API-BaaS-Portal 1 GB 2 Core 20 GB
Cassandra** 16 GB 8-core 250 GB lokaler Speicher mit SSD oder schneller Festplatte, die 2.000 IOPS unterstützt

* Sie können ElasticSearch und API BaaS Stack auf demselben Knoten installieren. Konfigurieren Sie in diesem Fall ElasticSearch so, dass 4 GB Speicher verwendet werden (Standard). Wenn ElasticSearch auf einem eigenen Knoten installiert ist, konfigurieren Sie es so, dass 6 GB Arbeitsspeicher verwendet werden.

** Optional. In der Regel verwenden Sie denselben Cassandra-Cluster für Edge- und API BaaS-Dienste.

Anforderungen an das Betriebssystem und an Drittanbietersoftware

Diese Installationsanleitung und die mitgelieferten Installationsdateien wurden auf den Betriebssystemen und der Drittanbietersoftware getestet, die unter Unterstützte Software und unterstützte Versionen aufgeführt sind.

Apigee-Nutzer erstellen

Bei der Installation wird ein Unix-Systemnutzer namens „apigee“ erstellt. Edge-Verzeichnisse und -Dateien gehören dem Nutzer „apigee“, ebenso wie Edge-Prozesse. Das bedeutet, dass Edge-Komponenten als Nutzer „apigee“ ausgeführt werden. Bei Bedarf können Sie Komponenten als anderen Nutzer ausführen.

Installationsverzeichnis

Standardmäßig schreibt das Installationsprogramm alle Dateien in das Verzeichnis /opt/apigee. Sie können den Speicherort dieses Verzeichnisses nicht ändern. Sie können dieses Verzeichnis zwar nicht ändern, aber wie unten beschrieben einen symbolischen Link erstellen, um /opt/apigee einem anderen Speicherort zuzuordnen.

In der Anleitung in diesem Leitfaden wird das Installationsverzeichnis als /opt/apigee angegeben.

Erstellen eines Symlinks von /opt/apigee

Bevor Sie den Symlink erstellen, müssen Sie zuerst einen Nutzer und eine Gruppe mit dem Namen „apigee“ erstellen. Das ist dieselbe Gruppe und derselbe Nutzer, die vom Edge-Installationsprogramm erstellt wurden.

Führen Sie die folgenden Schritte aus, bevor Sie die Datei „bootstrap_4.18.01.sh“ herunterladen, um den Symlink zu erstellen. Sie müssen alle diese Schritte als Root ausführen:

  1. Nutzer und Gruppe „apigee“ erstellen:
    groupadd -r apigee > useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigee platform user" apigee
  2. Erstellen Sie einen Symlink von /opt/apigee zu Ihrem gewünschten Installationsstammverzeichnis:
    ln -Ts /srv/myInstallDir /opt/apigee

    Dabei ist /srv/myInstallDir der gewünschte Speicherort der Edge-Dateien.

  3. Ändern Sie den Eigentümer des Installationsstamms und des Symlinks zum Nutzer „apigee“:
    chown -h apigee:apigee /srv/myInstallDir /opt/apigee

Java

Vor der Installation muss auf jedem Computer eine unterstützte Version von Java 1.8 installiert sein. Unterstützte JDKs sind unter Unterstützte Software und unterstützte Versionen aufgeführt.

Achten Sie darauf, dass JAVA_HOME auf das Stammverzeichnis des JDK für den Nutzer verweist, der die Installation durchführt.

SELinux

Abhängig von Ihren SELinux-Einstellungen können bei der Installation und beim Starten von Edge-Komponenten Probleme auftreten. Bei Bedarf können Sie SELinux während der Installation deaktivieren oder in den permissiven Modus versetzen und es nach der Installation wieder aktivieren. Weitere Informationen finden Sie unter Edge-Einrichtungsprogramm „apigee-setup“ installieren.

Einstellung für Werbenetzwerke

Es wird empfohlen, die Netzwerkeinstellung vor der Installation zu prüfen. Das Installationsprogramm geht davon aus, dass alle Computer feste IP-Adressen haben. Verwenden Sie die folgenden Befehle, um die Einstellung zu validieren:

  • hostname gibt den Namen der Maschine zurück.
  • hostname -i gibt die IP-Adresse für den Hostnamen zurück, der von anderen Computern aus angesprochen werden kann.

Je nach Betriebssystemtyp und ‑version müssen Sie möglicherweise /etc/hosts und /etc/sysconfig/network bearbeiten, wenn der Hostname nicht richtig festgelegt ist. Weitere Informationen finden Sie in der Dokumentation zu Ihrem Betriebssystem.

Wenn ein Server mehrere Schnittstellenkarten hat, gibt der Befehl „hostname -i“ eine durch Leerzeichen getrennte Liste von IP-Adressen zurück. Standardmäßig verwendet das Edge-Installationsprogramm die erste zurückgegebene IP-Adresse, die in einigen Situationen möglicherweise nicht korrekt ist. Alternativ können Sie die folgende Property in der Installationskonfigurationsdatei festlegen:

ENABLE_DYNAMIC_HOSTIP=y

Wenn diese Eigenschaft auf „y“ gesetzt ist, werden Sie vom Installationsprogramm aufgefordert, die IP-Adresse auszuwählen, die im Rahmen der Installation verwendet werden soll. Der Standardwert ist „n“. Weitere Informationen finden Sie in der Referenz zur Edge-Konfigurationsdatei.

TCP-Wrapper

TCP Wrappers können die Kommunikation einiger Ports blockieren und sich auf die Installation von OpenLDAP, Postgres und Cassandra auswirken. Prüfen Sie auf diesen Knoten /etc/hosts.allow und /etc/hosts.deny, um sicherzustellen, dass für die erforderlichen OpenLDAP-, Postgres- und Cassandra-Ports keine Portbeschränkungen gelten.

iptables

Prüfen Sie, ob iptables-Richtlinien die Verbindung zwischen Knoten an den erforderlichen Edge-Ports verhindern. Bei Bedarf können Sie iptables während der Installation mit dem folgenden Befehl beenden:

sudo/etc/init.d/iptables stop

Unter CentOS 7.x:

systemctl stop firewalld

Achten Sie darauf, dass der Edge-Router auf /etc/rc.d/init.d/functions zugreifen kann.

Die Edge Router- und BaaS Portal-Knoten verwenden den Nginx-Router und benötigen Lesezugriff auf /etc/rc.d/init.d/functions.

Wenn Sie im Rahmen Ihres Sicherheitsverfahrens Berechtigungen für /etc/rc.d/init.d/functions festlegen müssen, legen Sie sie nicht auf 700 fest, da der Router sonst nicht gestartet werden kann. Berechtigungen können auf 744 festgelegt werden, um Lesezugriff auf /etc/rc.d/init.d/functions zu ermöglichen.

Cassandra

Alle Cassandra-Knoten müssen mit einem Ring verbunden sein. Cassandra speichert Datenreplikate auf mehreren Knoten, um Zuverlässigkeit und Fehlertoleranz zu gewährleisten. Die Replikationsstrategie für jeden Edge-Schlüsselbereich bestimmt die Cassandra-Knoten, auf denen Replikate platziert werden. Weitere Informationen finden Sie unter Cassandra-Replikationsfaktor und ‑Konsistenzebene.

Cassandra passt die Größe des Java-Heaps automatisch an den verfügbaren Arbeitsspeicher an. Weitere Informationen finden Sie unter Java-Ressourcen optimieren. Bei Leistungseinbußen oder hohem Arbeitsspeicherverbrauch.

Nach der Installation von Edge for Private Cloud können Sie prüfen, ob Cassandra richtig konfiguriert ist, indem Sie die Datei /opt/apigee/apigee-cassandra/conf/cassandra.yaml untersuchen. Prüfen Sie beispielsweise, ob im Installationsskript für Edge for Private Cloud die folgenden Eigenschaften festgelegt wurden:

  • cluster_name
  • initial_token
  • partitioner
  • seeds
  • listen_address
  • rpc_address
  • snitch

PostgreSQL-Datenbank

Nach der Installation von Edge können Sie die folgenden PostgreSQL-Datenbankeinstellungen an die Menge an RAM anpassen, die auf Ihrem System verfügbar ist:

conf_postgresql_shared_buffers = 35% of RAM      # min 128kB
conf_postgresql_effective_cache_size = 45% of RAM
conf_postgresql_work_mem = 512MB       # min 64kB

So legen Sie diese Werte fest:

  1. Bearbeiten Sie die Datei „postgresql.properties“:
    vi /opt/apigee/customer/application/postgresql.properties

    Wenn die Datei nicht vorhanden ist, erstellen Sie sie.

  2. Legen Sie die oben aufgeführten Attribute fest.
  3. Speichern Sie die Änderungen.
  4. Starten Sie die PostgreSQL-Datenbank neu:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

Systemlimits

Achten Sie darauf, dass Sie die folgenden Systemlimits für Cassandra- und Message Processor-Knoten festgelegt haben:

  • Legen Sie auf Cassandra-Knoten die Grenzwerte für „soft“ und „hard“ für „memlock“, „nofile“ und „address space“ (as) für den Installationsnutzer (Standard ist „apigee“) in /etc/security/limits.d/90-apigee-edge-limits.conf fest, wie unten dargestellt:
    apigee soft memlock unlimited
    apigee hard memlock unlimited
    apigee soft nofile 32768
    apigee hard nofile 65536
    apigee soft as unlimited
    apigee hard as unlimited
  • Legen Sie auf Message Processor-Knoten die maximale Anzahl geöffneter Dateideskriptoren in /etc/security/limits.d/90-apigee-edge-limits.conf auf 64.000 fest, wie unten gezeigt:
    apigee soft nofile 32768
    apigee hard nofile 65536

    Bei Bedarf können Sie dieses Limit erhöhen. Das kann beispielsweise der Fall sein, wenn Sie viele temporäre Dateien gleichzeitig geöffnet haben.

jsvc

„jsvc“ ist eine Voraussetzung für die Verwendung von API BaaS. Version 1.0.15-dev wird installiert, wenn Sie API BaaS installieren.

Network Security Services (NSS)

Network Security Services (NSS) ist eine Reihe von Bibliotheken, die die Entwicklung von sicherheitsfähigen Client- und Serveranwendungen unterstützen. Sie sollten NSS v3.19 oder höher installiert haben.

So prüfen Sie Ihre aktuelle Version:

yum info nss

So aktualisieren Sie NSS:

yum update nss

Weitere Informationen

DNS-Lookup für IPv6 deaktivieren, wenn NSCD (Name Service Cache Daemon) verwendet wird

Wenn Sie NSCD (Name Service Cache Daemon) installiert und aktiviert haben, führt der Message Processor zwei DNS-Lookups durch: eines für IPv4 und eines für IPv6. Sie sollten den DNS-Lookup für IPv6 deaktivieren, wenn Sie NSCD verwenden.

So deaktivieren Sie den DNS-Lookup für IPv6:

  1. Bearbeiten Sie /etc/nscd.conf auf jedem Message Processor-Knoten.
  2. Legen Sie das folgende Attribut fest:
    enable-cache hosts no

IPv6 in der Google Cloud Platform für RedHat/CentOS 7 deaktivieren

Wenn Sie Edge auf RedHat 7 oder CentOS 7 auf der Google Cloud Platform installieren, müssen Sie IPv6 auf allen Qpid-Knoten deaktivieren.

Eine Anleitung zum Deaktivieren von IPv6 finden Sie in der Dokumentation von RedHat oder CentOS für Ihre spezifische Betriebssystemversion. Beispiele:

  1. Öffnen Sie /etc/hosts in einem Editor.
  2. Fügen Sie in Spalte 1 der folgenden Zeile ein „#“-Zeichen ein, um sie auszukommentieren:
    #::1 localhost localhost.localdomain localhost6 localhost6.localdomain6
  3. Speichern Sie die Datei.

AWS AMI

Wenn Sie Edge auf einem AWS Amazon Machine Image (AMI) für Red Hat Enterprise Linux 7.x installieren, müssen Sie zuerst den folgenden Befehl ausführen:

yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

Tools

Das Installationsprogramm verwendet die folgenden UNIX-Tools in der Standardversion, die von EL5 oder EL6 bereitgestellt wird.

awk

expr

libxslt

Atemzüge/Min.

unzip

basename

grep

lua-socket

rpm2cpio

useradd

bash

Hostname

ls

sed

wc

bc

id

net-tools

sudo

wget

curl

libaio

perl (aus procps)

tar

xerces-c

cyrus-sasl libdb4 pgrep (aus procps) tr yum

Datum

libdb-cxx

ps

uuid

chkconfig

Verz.-name libibverbs pwd uname  
Echo librdmacm Python    

ntpdate

Es wird empfohlen, die Zeiten der Server zu synchronisieren. Wenn noch nicht konfiguriert, kann das ntpdate-Dienstprogramm verwendet werden, um zu prüfen, ob die Server zeitsynchronisiert sind. Mit yum install ntp können Sie das Dienstprogramm installieren. Das ist besonders nützlich, wenn Sie OpenLDAP-Einrichtungen replizieren möchten. Die Serverzeitzone wird in UTC eingerichtet.

openldap 2.4

Für die lokale Installation ist OpenLDAP 2.4 erforderlich. Wenn Ihr Server eine Internetverbindung hat, lädt das Edge-Installationsskript OpenLDAP herunter und installiert es. Wenn Ihr Server keine Internetverbindung hat, müssen Sie dafür sorgen, dass OpenLDAP bereits installiert ist, bevor Sie das Edge-Installationsskript ausführen. Unter RHEL/CentOS können Sie yum install openldap-clients openldap-servers ausführen, um OpenLDAP zu installieren.

Bei Installationen mit 13 Hosts und Installationen mit 12 Hosts mit zwei Rechenzentren ist eine OpenLDAP-Replikation erforderlich, da OpenLDAP auf mehreren Knoten gehostet wird.

Firewalls und virtuelle Hosts

Der Begriff virtual wird in der IT-Branche häufig überladen, so auch bei einer Bereitstellung von Apigee Edge for Private Cloud und virtuellen Hosts. Zur Klarstellung: Der Begriff virtual wird hauptsächlich in zwei Kontexten verwendet:

  • Virtuelle Maschinen (VMs): Nicht erforderlich, aber bei einigen Bereitstellungen wird die VM-Technologie verwendet, um isolierte Server für die Apigee-Komponenten zu erstellen. VM-Hosts können wie physische Hosts Netzwerkschnittstellen und Firewalls haben.
  • Virtuelle Hosts: Webendpunkte, die einem virtuellen Apache-Host entsprechen.

Ein Router in einer VM kann mehrere virtuelle Hosts bereitstellen, sofern sie sich in ihrem Hostalias oder in ihrem Schnittstellenport voneinander unterscheiden.

Ein Beispiel: Auf einem einzelnen physischen Server A werden möglicherweise zwei VMs mit den Namen „VM1“ und „VM2“ ausgeführt. Angenommen, „VM1“ stellt eine virtuelle Ethernet-Schnittstelle bereit, die in der VM als „eth0“ bezeichnet wird und der von der Virtualisierungssoftware oder einem Netzwerk-DHCP-Server die IP-Adresse 111.111.111.111 zugewiesen wird. Angenommen, VM2 stellt ebenfalls eine virtuelle Ethernet-Schnittstelle bereit, die als „eth0“ bezeichnet wird und der die IP-Adresse 111.111.111.222 zugewiesen wird.

Möglicherweise wird auf jeder der beiden VMs ein Apigee-Router ausgeführt. Die Router stellen Endpunkte für virtuelle Hosts wie in diesem hypothetischen Beispiel bereit:

Der Apigee-Router in VM1 stellt drei virtuelle Hosts auf seiner eth0-Schnittstelle (mit einer bestimmten IP-Adresse) bereit: api.mycompany.com:80, api.mycompany.com:443 und test.mycompany.com:80.

Der Router in VM2 macht api.mycompany.com:80 verfügbar (derselbe Name und Port wie von VM1).

Das Betriebssystem des physischen Hosts hat möglicherweise eine Netzwerk-Firewall. Wenn dies der Fall ist, muss diese Firewall so konfiguriert werden, dass TCP-Traffic, der für die Ports bestimmt ist, die auf den virtualisierten Schnittstellen (111.111.111.111:{80, 443} und 111.111.111.222:80) bereitgestellt werden, weitergeleitet wird. Außerdem kann das Betriebssystem jeder VM eine eigene Firewall auf der eth0-Schnittstelle bereitstellen. Auch diese müssen Verbindungen über die Ports 80 und 443 zulassen.

Der Basispfad ist die dritte Komponente, die beim Weiterleiten von API-Aufrufen an verschiedene API-Proxys, die Sie möglicherweise bereitgestellt haben, eine Rolle spielt. API-Proxy-Bundles können einen Endpunkt gemeinsam nutzen, wenn sie unterschiedliche Basispfade haben. Ein Basispfad kann beispielsweise als http://api.mycompany.com:80/ und ein anderer als http://api.mycompany.com:80/salesdemo definiert werden.

In diesem Fall benötigen Sie einen Load Balancer oder Traffic Director, der den Traffic von http://api.mycompany.com:80/ zwischen den beiden IP-Adressen (111.111.111.111 auf VM1 und 111.111.111.222 auf VM2) aufteilt. Diese Funktion ist spezifisch für Ihre Installation und wird von Ihrer lokalen Netzwerkgruppe konfiguriert.

Der Basispfad wird beim Bereitstellen einer API festgelegt. Im obigen Beispiel können Sie zwei APIs, mycompany und testmycompany, für die Organisation mycompany-org mit dem virtuellen Host bereitstellen, der den Hostalias api.mycompany.com und den auf 80 festgelegten Port hat. Wenn Sie in der Bereitstellung keinen Basispfad deklarieren, weiß der Router nicht, an welche API eingehende Anfragen gesendet werden sollen.

Wenn Sie die API testmycompany jedoch mit der Basis-URL /salesdemo bereitstellen, greifen Nutzer über http://api.mycompany.com:80/salesdemo auf die API zu. Wenn Sie Ihre API „mycompany“ mit der Basis-URL / bereitstellen, greifen Ihre Nutzer über die URL http://api.mycompany.com:80/ auf die API zu.

Edge-Portanforderungen

Die Verwaltung der Firewall geht über die virtuellen Hosts hinaus. Sowohl die VM- als auch die physischen Host-Firewalls müssen Traffic für die Ports zulassen, die für die Kommunikation der Komponenten miteinander erforderlich sind.

Das folgende Bild zeigt die Anforderungen an die Ports für jede Edge-Komponente:

Hinweise zu diesem Diagramm:

  • * Port 8082 auf dem Message Processor muss nur für den Zugriff durch den Router geöffnet sein, wenn Sie TLS/SSL zwischen dem Router und dem Message Processor konfigurieren. Wenn Sie TLS/SSL zwischen dem Router und dem Message Processor nicht konfigurieren, muss der Standardport 8082 auf dem Message Processor weiterhin geöffnet sein, um die Komponente zu verwalten. Der Router benötigt jedoch keinen Zugriff darauf.
  • Die Ports mit dem Präfix „M“ werden zum Verwalten der Komponente verwendet und müssen auf der Komponente für den Zugriff durch den Management Server geöffnet sein.
  • Die folgenden Komponenten benötigen Zugriff auf Port 8080 auf dem Management Server: Router, Message Processor, UI, Postgres und Qpid.
  • Ein Message Processor muss Port 4528 als Managementport öffnen. Wenn Sie mehrere Message Processors haben, müssen sie alle über Port 4528 aufeinander zugreifen können. Das wird im Diagramm oben durch den Schleifenpfeil für Port 4528 auf dem Message Processor dargestellt. Wenn Sie mehrere Rechenzentren haben, muss der Port von allen Message Processors in allen Rechenzentren aus zugänglich sein.
  • Es ist zwar nicht erforderlich, aber Sie können Port 4527 auf dem Router für den Zugriff durch einen beliebigen Message Processor öffnen. Andernfalls werden möglicherweise Fehlermeldungen in den Logdateien des Message Processors angezeigt.
  • Ein Router muss Port 4527 als Verwaltungsport öffnen. Wenn Sie mehrere Router haben, müssen alle über Port 4527 aufeinander zugreifen können. Das wird im Diagramm oben durch den Schleifenpfeil für Port 4527 auf dem Router dargestellt.
  • Für die Edge-UI ist Zugriff auf den Router über die von API-Proxys bereitgestellten Ports erforderlich, um die Schaltfläche Senden im Trace-Tool zu unterstützen.
  • Der Management Server benötigt Zugriff auf den JMX-Port auf den Cassandra-Knoten.
  • Für den Zugriff auf JMX-Ports kann ein Nutzername/Passwort erforderlich sein. Weitere Informationen finden Sie unter Überwachung.
  • Optional können Sie den TLS/SSL-Zugriff für bestimmte Verbindungen konfigurieren, die unterschiedliche Ports verwenden können. Weitere Informationen finden Sie unter TLS/SSL.
  • Wenn Sie zwei Postgres-Knoten für die Master-Standby-Replikation konfigurieren, müssen Sie auf jedem Knoten Port 22 für den SSH-Zugriff öffnen. Sie können optional Ports auf einzelnen Knoten öffnen, um SSH-Zugriff zu ermöglichen.
  • Sie können den Management Server und die Edge-Benutzeroberfläche so konfigurieren, dass E-Mails über einen externen SMTP-Server gesendet werden. Wenn dies der Fall ist, müssen Sie dafür sorgen, dass der Management Server und die Benutzeroberfläche auf den erforderlichen Port auf dem SMTP-Server zugreifen können. Bei Nicht-TLS-SMTP ist die Portnummer in der Regel 25. Für TLS-fähiges SMTP ist es oft 465. Fragen Sie aber bei Ihrem SMTP-Anbieter nach.

In der folgenden Tabelle sind die Ports aufgeführt, die in Firewalls für die einzelnen Edge-Komponenten geöffnet werden müssen:

Komponente Port Beschreibung
Standard-HTTP-Ports 80, 443 HTTP und alle anderen Ports, die Sie für virtuelle Hosts verwenden
Verwaltungsserver 8080 Port für Edge-Verwaltungs-API-Aufrufe. Diese Komponenten benötigen Zugriff auf Port 8080 auf dem Management Server: Router, Message Processor, UI, Postgres und Qpid.
1099 JMX-Port
4526 Für verteilte Cache- und Verwaltungsaufrufe
Verwaltungs-UI 9000 Port für den Browserzugriff auf die Verwaltungsoberfläche
Message Processor 8998 Message Processor-Port für die Kommunikation vom Router
8082

Standardverwaltungsport für Message Processor, der für den Zugriff durch den Verwaltungsserver auf der Komponente geöffnet sein muss.

Wenn Sie TLS/SSL zwischen dem Router und dem Message Processor konfigurieren, wird es vom Router verwendet, um Systemdiagnosen für den Message Processor durchzuführen.

1101 JMX-Port
4528 Für verteilte Cache- und Verwaltungsaufrufe zwischen Message Processors und für die Kommunikation vom Router und Management Server
Router 8081 Standardmäßiger Verwaltungsport für den Router, der auf der Komponente für den Zugriff durch den Verwaltungsserver geöffnet sein muss.
4527 Für verteilte Cache- und Verwaltungsaufrufe
15999

Systemdiagnose-Port. Ein Load Balancer verwendet diesen Port, um festzustellen, ob der Router verfügbar ist.

Um den Status eines Routers abzurufen, sendet der Load Balancer eine Anfrage an Port 15999 auf dem Router:

curl -v http://routerIP:15999/v1/servers/self/reachable

Wenn der Router erreichbar ist, wird HTTP 200 zurückgegeben.

59001 Port, der vom Dienstprogramm apigee-validate zum Testen der Edge-Installation verwendet wird. Für dieses Dienstprogramm ist der Zugriff auf Port 59001 auf dem Router erforderlich. Weitere Informationen zu Port 59001 finden Sie unter Installation testen.
ZooKeeper 2181 Wird von anderen Komponenten wie Management Server, Router, Message Processor usw. verwendet.
2888, 3888 Wird intern von ZooKeeper für die Kommunikation des ZooKeeper-Clusters (als ZooKeeper-Ensemble bezeichnet) verwendet.
Cassandra 7000, 9042, 9160 Apache Cassandra-Ports für die Kommunikation zwischen Cassandra-Knoten und für den Zugriff durch andere Edge-Komponenten.
7199 JMX-Port. Muss für den Zugriff durch den Management Server geöffnet sein.
Qpid 5672 Wird für die Kommunikation vom Router und Message Processor zum Qpid-Server verwendet.
8083 Standardmäßiger Verwaltungsport auf dem Qpid-Server, der auf der Komponente für den Zugriff durch den Verwaltungsserver geöffnet sein muss.
1102 JMX-Port
4529 Für verteilte Cache- und Verwaltungsaufrufe
Postgres 5432 Wird für die Kommunikation vom Qpid-/Management-Server zu Postgres verwendet
8084 Standardmäßiger Verwaltungsport auf dem Postgres-Server, der auf der Komponente für den Zugriff durch den Verwaltungsserver geöffnet sein muss.
1103 JMX-Port
4530 Für verteilte Cache- und Verwaltungsaufrufe
22 Wenn Sie zwei Postgres-Knoten für die Master-Standby-Replikation konfigurieren, müssen Sie Port 22 auf jedem Knoten für den SSH-Zugriff öffnen.
LDAP 10389 OpenLDAP
SmartDocs 59002 Der Port auf dem Edge-Router, an den SmartDocs-Seitenanfragen gesendet werden.

In der folgenden Tabelle sind dieselben Ports numerisch aufgeführt, zusammen mit den Quell- und Zielkomponenten:

Portnummer Zweck Quellkomponente Zielkomponente
virtual_host_port HTTP und alle anderen Ports, die Sie für den Traffic von API-Aufrufen für virtuelle Hosts verwenden. Die Ports 80 und 443 werden am häufigsten verwendet. Der Message Router kann TLS/SSL-Verbindungen beenden. Externer Client (oder Load Balancer) Listener für Nachrichtenrouter
1099 bis 1103 JMX-Verwaltung JMX-Client Management Server (1099)
Message Processor (1101)
Qpid Server (1102)
Postgres Server (1103)
2181 Zookeeper-Clientkommunikation Management Server
Router
Message Processor
Qpid Server
Postgres Server
Zookeeper
2888 und 3888 Zookeeper-Knotenverwaltung Zookeeper Zookeeper
4526 RPC-Managementport Verwaltungsserver Verwaltungsserver
4527 RPC-Verwaltungsport für verteilte Cache- und Verwaltungsaufrufe sowie für die Kommunikation zwischen Routern Verwaltungsserver
Router
Router
4528 Für verteilte Cache-Aufrufe zwischen Message Processors und für die Kommunikation vom Router Management Server
Router
Message Processor
Message Processor
4529 RPC-Verwaltungsport für verteilte Cache- und Verwaltungsaufrufe Verwaltungsserver Qpid-Server
4530 RPC-Verwaltungsport für verteilte Cache- und Verwaltungsaufrufe Verwaltungsserver Postgres-Server
5432 Postgres-Client Qpid-Server Postgres
5672

Wird verwendet, um Analysen von Router und Message Processor an Qpid zu senden.

Router
Message Processor
Qpid-Server
7000 Cassandra-Knotenkommunikation Cassandra Anderer Cassandra-Knoten
7199 JMX-Verwaltung. Muss für den Zugriff auf den Cassandra-Knoten durch den Management Server geöffnet sein. JMX-Client Cassandra
8080 Management API-Port Management API-Clients Verwaltungsserver
8081 bis 8084

Component API-Ports, die zum direkten Senden von API-Anfragen an einzelne Komponenten verwendet werden. Jede Komponente öffnet einen anderen Port. Der genaue Port hängt von der Konfiguration ab, muss aber für den Zugriff durch den Management Server auf der Komponente geöffnet sein.

Management API-Clients Router (8081)
Message Processor (8082)
Qpid Server (8083)
Postgres Server (8084)
8998 Kommunikation zwischen Router und Nachrichtenprozessor Router Message Processor
9000 Standardport für die Edge-Verwaltungs-UI Browser Verwaltungs-UI-Server
9042 Nativer CQL-Transport Router
Message Processor
Management Server
Cassandra
9160 Cassandra-Thrift-Client Router
Message Processor
Management Server
Cassandra
10389 LDAP-Port Verwaltungsserver OpenLDAP
15999 Systemdiagnose-Port. Ein Load Balancer verwendet diesen Port, um festzustellen, ob der Router verfügbar ist. Load-Balancer Router
59001 Port, der vom apigee-validate-Dienstprogramm zum Testen der Edge-Installation verwendet wird apigee-validate Router
59002 Der Router-Port, an den SmartDocs-Seitenanfragen gesendet werden SmartDocs Router

Ein Message Processor hält einen dedizierten Verbindungspool zu Cassandra offen, der so konfiguriert ist, dass er nie das Zeitlimit überschreitet. Wenn sich eine Firewall zwischen einem Message-Prozessor und einem Cassandra-Server befindet, kann die Verbindung durch die Firewall unterbrochen werden. Der Nachrichtenprozessor ist jedoch nicht dafür konzipiert, Verbindungen zu Cassandra wiederherzustellen.

Um dies zu verhindern, empfiehlt Apigee, dass sich der Cassandra-Server, der Message Processor und die Router im selben Subnetz befinden, damit keine Firewall in die Bereitstellung dieser Komponenten eingebunden ist.

Wenn sich zwischen dem Router und den Message-Prozessoren eine Firewall befindet, für die ein TCP-Leerlauf-Timeout festgelegt ist, empfehlen wir Folgendes:

  1. Legen Sie net.ipv4.tcp_keepalive_time = 1800 in den sysctl-Einstellungen unter Linux fest. Der Wert 1800 sollte dabei niedriger sein als das TCP-Leerlauftimeout der Firewall. Diese Einstellung sollte die Verbindung in einem etablierten Zustand halten, damit die Firewall die Verbindung nicht trennt.
  2. Bearbeiten Sie auf allen Message Processors /opt/apigee/customer/application/message-processor.properties, um das folgende Attribut hinzuzufügen. Wenn die Datei nicht vorhanden ist, erstellen Sie sie.
    conf_system_cassandra.maxconnecttimeinmillis=-1
  3. Message Processor neu starten:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
  4. Bearbeiten Sie auf allen Routern /opt/apigee/customer/application/router.properties, um das folgende Attribut hinzuzufügen. Wenn die Datei nicht vorhanden ist, erstellen Sie sie.
    conf_system_cassandra.maxconnecttimeinmillis=-1
  5. Router neu starten:
    /opt/apigee/apigee-service/bin/apigee-service edge-router restart

Wenn Sie die Clusterkonfiguration mit 12 Hosts und zwei Rechenzentren installieren, müssen die Knoten in den beiden Rechenzentren über die unten aufgeführten Ports kommunizieren können:

API-Anforderungen für BaaS-Ports

Wenn Sie sich für die Installation von API BaaS entscheiden, fügen Sie die Komponenten „API BaaS Stack“ und „API BaaS Portal“ hinzu. Diese Komponenten verwenden die in der Abbildung unten gezeigten Ports:

Hinweise zu diesem Diagramm:

  • Das API BaaS-Portal sendet niemals Anfragen direkt an einen BaaS-Stack-Knoten. Wenn sich ein Entwickler im Portal anmeldet, wird die Portal-App in den Browser heruntergeladen. Die im Browser ausgeführte Portal-App stellt dann Anfragen an die BaaS-Stack-Knoten.
  • Bei einer Produktionsinstallation von API BaaS wird ein Load Balancer zwischen dem API BaaS-Portal-Knoten und den API BaaS-Stack-Knoten verwendet. Wenn Sie das Portal konfigurieren und BaaS-API-Aufrufe ausführen, geben Sie die IP-Adresse oder den DNS-Namen des Load Balancers und nicht der Stack-Knoten an.
  • Alle Stack-Knoten müssen Port 2551 für den Zugriff von allen anderen Stack-Knoten öffnen (im Diagramm oben durch den Schleifenpfeil für Port 2551 auf den Stack-Knoten dargestellt). Wenn Sie mehrere Rechenzentren haben, muss der Port von allen Stack-Knoten in allen Rechenzentren aus zugänglich sein.
  • Sie müssen alle BaaS Stack-Knoten so konfigurieren, dass E‑Mails über einen externen SMTP-Server gesendet werden. Bei Nicht-TLS-SMTP ist die Portnummer in der Regel 25. Für TLS-fähiges SMTP ist es oft 465. Fragen Sie aber bei Ihrem SMTP-Anbieter nach.
  • Die Cassandra-Knoten können für API BaaS vorgesehen oder für Edge freigegeben sein.

In der folgenden Tabelle sind die Standardports aufgeführt, die in Firewalls geöffnet werden müssen, nach Komponente:

Komponente Port Beschreibung
API BaaS-Portal 9000 Port für die API BaaS-Benutzeroberfläche
API BaaS Stack 8080 Port, über den API-Anfragen empfangen werden
2551

Port für die Kommunikation zwischen allen Stack-Knoten. Muss für alle anderen Stack -Knoten im Rechenzentrum zugänglich sein.

Wenn Sie mehrere Rechenzentren haben, muss der Port von allen Stack-Knoten in allen Rechenzentren aus zugänglich sein.

ElasticSearch 9200 bis 9400 Für die Kommunikation mit API BaaS Stack und zwischen ElasticSearch-Knoten

Lizenzierung

Für jede Installation von Edge ist eine eindeutige Lizenzdatei erforderlich, die Sie von Apigee erhalten. Sie müssen den Pfad zur Lizenzdatei bei der Installation des Verwaltungsservers angeben, z. B. /tmp/license.txt.

Das Installationsprogramm kopiert die Lizenzdatei nach /opt/apigee/customer/conf/license.txt.

Wenn die Lizenzdatei gültig ist, prüft der Verwaltungsserver das Ablaufdatum und die zulässige Anzahl von Message Processors (MPs). Wenn eine der Lizenzeinstellungen abgelaufen ist, finden Sie die Logs unter /opt/apigee/var/log/edge-management-server/logs. In diesem Fall können Sie sich an den Apigee Edge-Support wenden, um weitere Informationen zur Migration zu erhalten.

Wenn Sie noch keine Lizenz haben, wenden Sie sich an den Apigee-Vertrieb.