Installationsanforderungen

Edge for Private Cloud v4.19.01

Hardwareanforderungen

Sie müssen die folgenden Mindestanforderungen an die Hardware für eine hochverfügbare Infrastruktur in einer produktionsreifen Umgebung erfüllen.

Das folgende Video bietet allgemeine Hinweise zur Dimensionierung Ihrer Installation:

Für alle unter Installationstopologien beschriebenen Installationsszenarien sind in den folgenden Tabellen die Mindesthardwareanforderungen für die Installationskomponenten aufgeführt.

In diesen Tabellen sind die Festplattenanforderungen zusätzlich zu dem vom Betriebssystem benötigten Speicherplatz aufgeführt. Je nach Anwendungen und Netzwerkverkehr sind für Ihre Installation möglicherweise mehr oder weniger Ressourcen als unten aufgeführt erforderlich.

Außerdem sind im Folgenden die Hardwareanforderungen aufgeführt, wenn Sie die Monetarisierungsdienste installieren möchten (nicht bei der All-in-One-Installation unterstützt):

Anforderungen an das Betriebssystem und Drittanbietersoftware

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

Nutzer „apigee“ erstellen

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

Installationsverzeichnis

Standardmäßig schreibt das Installationsprogramm alle Dateien in das Verzeichnis /opt/apigee. Sie können diesen Verzeichnisspeicherort nicht ändern. Sie können dieses Verzeichnis zwar nicht ändern, aber einen Symlink erstellen, um /opt/apigee einem anderen Speicherort zuzuordnen, wie unter Symlink von /opt/apigee erstellen beschrieben.

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

Symlink von /opt/apigee erstellen

Bevor Sie den symbolischen Link erstellen, müssen Sie zuerst einen Nutzer und eine Gruppe mit dem Namen „apigee“ erstellen. Dies 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.19.01.sh herunterladen, um den symbolischen Link zu erstellen. Sie müssen alle diese Schritte als Root ausführen:

1. Erstellen Sie den Nutzer und die Gruppe „apigee“:

   groupadd -r apigee > useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigee platform user" apigee

2. Erstellen Sie einen symbolischen Link von /opt/apigee zum gewünschten Installationsstammverzeichnis:

   ln -Ts /srv/myInstallDir /opt/apigee

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

3. Ändern Sie die Inhaberschaft des Installationsstammverzeichnisses 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 die Umgebungsvariable JAVA_HOME auf das Stammverzeichnis des JDK für den Nutzer verweist, der die Installation ausführt.

SELinux

Je nach Ihren Einstellungen für SELinux 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 Modus „Permissive“ versetzen und nach der Installation wieder aktivieren. Weitere Informationen finden Sie unter Edge-Dienstprogramm „apigee-setup“ installieren.

Werbenetzwerkeinstellung

Apigee empfiehlt, die Netzwerkeinstellung vor der Installation zu prüfen. Das Installationsprogramm erwartet, dass alle Maschinen feste IP-Adressen haben. Verwenden Sie die folgenden Befehle, um die Einstellung zu prüfen:

• hostname gibt den Namen der Maschine zurück.
• hostname -i gibt die IP-Adresse für den Hostnamen zurück, der von anderen Maschinen aus adressiert 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 möglicherweise nicht in allen Situationen korrekt ist. Alternativ können Sie das folgende Attribut in der Installationskonfigurationsdatei festlegen:

ENABLE_DYNAMIC_HOSTIP=y

Wenn dieses Attribut 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-Wrapper 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 keine Portbeschränkungen für die erforderlichen OpenLDAP-, Postgres- und Cassandra-Ports bestehen.

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

Verzeichniszugriff

In der folgenden Tabelle sind Verzeichnisse auf Edge-Knoten aufgeführt, die besondere Anforderungen an Edge-Prozesse haben:

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-Keyspace bestimmt die Cassandra-Knoten, auf denen Replikate platziert werden. Weitere Informationen finden Sie unter Cassandra-Replikationsfaktor und -Konsistenzebene.

Cassandra passt die Java-Heap-Größe automatisch an den verfügbaren Arbeitsspeicher an. Weitere Informationen finden Sie unter Java-Ressourcen optimieren, wenn die Leistung beeinträchtigt ist oder der Arbeitsspeicherverbrauch hoch ist.

Nach der Installation von Edge for Private Cloud können Sie prüfen, ob Cassandra richtig konfiguriert ist. Sehen Sie sich dazu die Datei /opt/apigee/apigee-cassandra/conf/cassandra.yaml an. Prüfen Sie beispielsweise, ob das Installationsskript für Edge for Private Cloud die folgenden Attribute festgelegt hat:

• 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 basierend auf der Menge des auf Ihrem System verfügbaren RAM anpassen:

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 weichen und harten Limits 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 gezeigt:

  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 ist beispielsweise der Fall, wenn Sie eine große Anzahl temporärer Dateien gleichzeitig geöffnet haben.

Network Security Services (NSS)

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

So prüfen Sie die aktuelle Version:

yum info nss

So aktualisieren Sie NSS:

yum update nss

Weitere Informationen finden Sie in diesem Artikel von RedHat.

DNS-Lookup für IPv6 bei Verwendung von NSCD (Name Service Cache Daemon) deaktivieren

Wenn Sie NSCD (Name Service Cache Daemon) installiert und aktiviert haben, führen die Message Processors zwei DNS-Suchen durch: eine für IPv4 und eine für IPv6. Wenn Sie NSCD verwenden, sollten Sie die DNS-Suche für IPv6 deaktivieren.

So deaktivieren Sie die DNS-Suche für IPv6:

1. Bearbeiten Sie auf jedem Message Processor-Knoten die Datei /etc/nscd.conf.
2. Legen Sie das folgende Attribut fest:

   enable-cache hosts no

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

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

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

1. Öffnen Sie /etc/hosts in einem Editor.
2. Fügen Sie in der ersten Spalte 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.

ntpdate

Apigee empfiehlt, dass Sie die Zeiten Ihrer Server synchronisieren. Falls noch nicht konfiguriert, kann das Dienstprogramm ntpdate diesen Zweck erfüllen, da es prüft, ob die Server zeitsynchronisiert sind. Sie können yum install ntp verwenden, um das Dienstprogramm zu installieren. Dies ist besonders nützlich, um OpenLDAP-Einrichtungen zu replizieren. Beachten Sie, dass Sie die Serverzeitzone in UTC einrichten.

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 die OpenLDAP-Replikation erforderlich, da mehrere Knoten OpenLDAP hosten.

Firewalls und virtuelle Hosts

Der Begriff virtual wird im IT-Bereich häufig überlastet, so auch bei einer Apigee Edge for Private Cloud-Bereitstellung und virtuellen Hosts. Zur Verdeutlichung: Der Begriff virtual wird hauptsächlich in zwei Zusammenhängen verwendet:

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

Ein Router in einer VM kann mehrere virtuelle Hosts verfügbar machen, sofern sie sich im Host-Alias oder im Schnittstellenport voneinander unterscheiden.

Beispiel: Auf einem einzelnen physischen Server A werden zwei VMs mit den Namen „VM1“ und „VM2“ ausgeführt. Angenommen, „VM1“ stellt eine virtuelle Ethernet-Schnittstelle bereit, die innerhalb der VM den Namen „eth0“ erhält und der von der Virtualisierungsmaschine oder einem Netzwerk-DHCP-Server die IP-Adresse 111.111.111.111 zugewiesen wird. Nehmen wir außerdem an, dass VM2 eine virtuelle Ethernet-Schnittstelle bereitstellt, die ebenfalls den Namen „eth0“ hat und der die IP-Adresse 111.111.111.222 zugewiesen wird.

In jeder der beiden VMs wird möglicherweise ein Apigee-Router ausgeführt. Die Router stellen virtuelle Hostendpunkte bereit, wie in diesem hypothetischen Beispiel:

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

Der Router in VM2 stellt api.mycompany.com:80 bereit (selber Name und Port wie von VM1 bereitgestellt).

Das Betriebssystem des physischen Hosts verfügt möglicherweise über eine Netzwerk-Firewall. In diesem Fall muss diese Firewall so konfiguriert sein, dass TCP-Traffic an die Ports weitergeleitet wird, die auf den virtualisierten Schnittstellen (111.111.111.111:{80, 443} und 111.111.111.222:80) freigegeben sind. Darüber hinaus kann das Betriebssystem jeder VM eine eigene Firewall auf der eth0-Schnittstelle bereitstellen. Auch diese muss Traffic über die Ports 80 und 443 zulassen.

Der Basispfad ist die dritte Komponente, die am Routing von API-Aufrufen an verschiedene API-Proxys beteiligt ist, die Sie möglicherweise bereitgestellt haben. API-Proxy-Bundles können einen Endpunkt gemeinsam nutzen, wenn sie unterschiedliche Basispfade haben. Beispielsweise kann ein Basispfad 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 jeweilige Installation und wird von Ihrer lokalen Netzwerkgruppe konfiguriert.

Der Basispfad wird festgelegt, wenn Sie eine API bereitstellen. Im obigen Beispiel können Sie zwei APIs, mycompany und testmycompany, für die Organisation mycompany-org mit dem virtuellen Host bereitstellen, der den Host-Alias api.mycompany.com und den Port 80 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 diese API zu. Wenn Sie die API „mycompany“ mit der Basis-URL / bereitstellen, greifen Ihre Nutzer über die URL http://api.mycompany.com:80/ auf die API zu.

Lizenzierung

Für jede Installation von Edge ist eine eindeutige Lizenzdatei erforderlich, die Sie von Apigee erhalten. Sie müssen den Pfad zur Lizenzdatei angeben, wenn Sie den Management Server installieren, z. B. /tmp/license.txt.

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

Wenn die Lizenzdatei gültig ist, validiert der Verwaltungsserver das Ablaufdatum und die zulässige Anzahl von Message Processors (MP). 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 Migrationsdetails zu erhalten.

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