Edge for Private Cloud Version 4.16.09
Nachdem Sie das Edge-Dienstprogramm apigee-setup auf einem Knoten installiert haben, verwenden Sie das Dienstprogramm apigee-setup, um eine oder mehrere Edge-Komponenten auf dem Knoten zu installieren.
Das Dienstprogramm apigee-setup verwendet einen Befehl im folgenden Format:
> /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile
Dabei ist component die zu installierende Edge-Komponente und configFile die stille Konfigurationsdatei, die die Installationsinformationen enthält. Die Konfigurationsdatei muss für den „apigee“-Benutzer zugänglich oder lesbar sein. Sie können beispielsweise ein neues Verzeichnis für die Dateien erstellen, sie im Verzeichnis /usr/local oder /usr/local/share oder an einer anderen Stelle auf dem Knoten ablegen, auf die der Nutzer „apigee“ zugreifen kann.
So installieren Sie beispielsweise den Edge-Verwaltungsserver:
> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f /usr/local/myConfig
Hinweise zur Installation
Berücksichtigen Sie beim Schreiben der Konfigurationsdatei die folgenden Optionen.
Postgres-Master-Standby-Replikation einrichten
Standardmäßig installiert Edge alle Postgres-Knoten im Mastermodus. In Produktionssystemen mit mehreren Postgres-Knoten müssen Sie diese jedoch für die Verwendung der Master-Standby-Replikation konfigurieren, damit der Standby-Knoten weiterhin Traffic bereitstellen kann, wenn der Master-Knoten ausfällt.
Sie können die Master-Standby-Replikation bei der Installation mithilfe von Attributen in der unbeaufsichtigten Konfigurationsdatei aktivieren und konfigurieren. Alternativ können Sie die Master-Standby-Replikation nach der Installation aktivieren. Weitere Informationen finden Sie unter Master-Standby-Replikation für Postgres einrichten.
Cassandra-Authentifizierung aktivieren
Standardmäßig wird Cassandra ohne aktivierte Authentifizierung installiert. Das bedeutet, dass jeder auf Cassandra zugreifen kann. Sie können die Authentifizierung nach der Installation von Edge oder als Teil des Installationsvorgangs aktivieren.
Sie können die Cassandra-Authentifizierung als Installationszeit mithilfe von Attributen in der unbeaufsichtigten Konfigurationsdatei aktivieren. Alternativ können Sie sie nach der Installation aktivieren.
Weitere Informationen finden Sie unter Cassandra-Authentifizierung aktivieren.
Router an einen geschützten Port binden
Wenn Sie den Router an einen geschützten Port binden möchten, z. B. Portnummern unter 1024, müssen Sie ihn so konfigurieren, dass er als Nutzer mit Zugriff auf diese Ports ausgeführt wird. Standardmäßig wird der Router als Nutzer „apigee“ ausgeführt, der keinen Zugriff auf privilegierte Ports hat.
So führen Sie den Router als ein anderer Nutzer aus:
- Erstellen Sie als Root die Datei /opt/apigee/etc/edge-router.d/RUN_USER.sh.
- Fügen Sie der Datei den folgenden Eintrag hinzu:
RUN_USER=root
Wenn Sie den Router nicht als Root ausführen möchten, geben Sie einen Nutzer mit Zugriff auf den Port an. - Speichere die Datei.
- Wenn Sie einen anderen Benutzer als Root angegeben haben, ändern Sie den Eigentümer der Datei in diesen Benutzer:
> Geben Sie NUTZER:NUTZER /opt/apigee/etc/edge-router.d/RUN_USER.sh an: - Router neu starten:
> /opt/apigee/apigee-service/bin/apigee-service-Edge-Router-Neustart
Zu installierende Komponenten angeben
In der folgenden Tabelle sind die Optionen aufgeführt, die Sie an die Option -p des Dienstprogramms Apigee-Dienst übergeben, um anzugeben, welche Komponenten auf dem Knoten installiert werden sollen:
Komponente |
Beschreibung |
---|---|
c |
Installieren Sie nur Cassandra. |
ZK | nur ZooKeeper installieren. |
ds |
Installieren Sie ZooKeeper und Cassandra. |
ld |
Installieren Sie nur OpenLDAP. |
ms |
Installieren Sie den Edge-Verwaltungsserver, der auch die Edge-Benutzeroberfläche und OpenLDAP installiert. Wenn Sie in der Konfigurationsdatei USE_LDAP_REMOTE_HOST=y festlegen, wird die OpenLDAP-Installation übersprungen und der Verwaltungsserver verwendet OpenLDAP, das auf einem anderen Knoten installiert ist. |
r |
Installieren Sie nur Edge Router. |
mp |
Installieren Sie nur den Edge Message Processor. |
RPM |
Installieren Sie Edge Router und Message Processor. |
ui |
Installieren Sie die Edge-Benutzeroberfläche. |
qs |
Installieren Sie nur den Qpid-Server. |
ps |
Installieren Sie nur den Postgres-Server. |
Saxofon |
Installieren Sie die Analysekomponenten, d. h. Qpid und Postgres. Verwenden Sie diese Option nur für Entwicklung und Tests, nicht für die Produktion. |
Monat |
Monetarisierung installieren. |
sa |
Installieren Sie eigenständige Edge-Geräte, d. h. Cassandra, ZooKeeper, Management Server, OpenLDAP, Edge-UI, Router und Message Processor. Bei dieser Option werden die Edge-Analysekomponenten weggelassen: Qpid und Postgres. Verwenden Sie diese Option nur für Entwicklung und Tests, nicht für die Produktion. |
Aio |
Installieren Sie alle Komponenten auf einem einzelnen Knoten. Verwenden Sie diese Option nur für Entwicklung und Tests, nicht für die Produktion. |
Konfigurationsdatei erstellen
Die Konfigurationsdatei enthält alle Informationen, die zum Installieren von Edge erforderlich sind. Häufig können Sie dieselbe Konfigurationsdatei verwenden, um alle Komponenten in einer Edge-Installation zu installieren.
Sie müssen jedoch andere Konfigurationsdateien verwenden oder die Konfigurationsdatei ändern, wenn:
- Sie installieren mehrere OpenLDAP-Server und müssen die Replikation im Rahmen einer Installation mit 13 Knoten konfigurieren. Jede Datei erfordert unterschiedliche Werte für LDAP_SID und LDAP_PEER.
- Sie erstellen mehrere Rechenzentren im Rahmen einer Installation mit 12 Knoten. Jedes Rechenzentrum benötigt unterschiedliche Einstellungen für Properties wie ZK_CLIENT_HOSTS und CASS_HOSTS.
Beispiel: Konfigurationsdatei
Unten sehen Sie ein Beispiel für eine vollständige Konfigurationsdatei im Hintergrund für eine Edge-Installation mit neun Knoten. Bearbeiten Sie diese Datei nach Bedarf für Ihre Konfiguration. Verwenden Sie die Option -f, um diese Datei in setup.sh aufzunehmen. Unten finden Sie außerdem Konfigurationsdateien für jede Edge-Topologie.
# IP address or DNS name of nodes. IP1=192.168.1.1 # Management Server, OpenLDAP, UI, ZooKeeper, Cassandra IP2=192.168.1.2 # ZooKeeper, Cassandra IP3=192.168.1.3 # ZooKeeper, Cassandra IP4=192.168.1.4 # Router, Message Processor IP5=192.168.1.5 # Router, Message Processor IP6=192.168.1.6 # Qpid IP7=192.168.1.7 # Qpid IP8=192.168.1.8 # Postgres IP9=192.168.1.9 # Postgres # Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost. HOSTIP=$(hostname -i) # Set Edge sys admin credentials. ADMIN_EMAIL=your@email.com APIGEE_ADMINPW=yourPassword # If omitted, you are prompted for it. # Location of Edge license file. LICENSE_FILE=/tmp/license.txt # Management Server information. MSIP=$IP1 # IP or DNS name of Management Server node. # Specify the port the Management Server listens on for API calls. # APIGEE_PORT_HTTP_MS=8080 # Default is 8080. # # OpenLDAP information. # # Set to y if you are connecting to a remote LDAP server. # If n, Edge installs OpenLDAP when it installs the Management Server. USE_LDAP_REMOTE_HOST=n # If connecting to remote OpenLDAP server, specify the IP/DNS name and port. # LDAP_HOST=$IP1 # IP or DNS name of OpenLDAP node. # LDAP_PORT=10389 # Default is 10389. APIGEE_LDAPPW=yourLdapPassword # Specify OpenLDAP without replication, 1, or with replication, 2. LDAP_TYPE=1 # Set only if using replication. # LDAP_SID=1 # Unique ID for this LDAP server. # LDAP_PEER= # IP or DNS name of LDAP peer. BIND_ON_ALL_INTERFACES=y # The Message Processor and Router pod. MP_POD=gateway # The name of the region, corresponding to the data center name. REGION=dc-1 # Use dc-1 unless installing in a # multi-data center environment. # ZooKeeper information. # See table below if installing in a multi-data center environment. ZK_HOSTS="$IP1 $IP2 $IP3" # IP/DNS names of all ZooKeeper nodes. ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" # IP/DNS names of all ZooKeeper nodes. # Cassandra information. CASS_CLUSTERNAME=Apigee # Default name is Apigee. # IP addresses of the Cassandra hosts separated by spaces. CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1" # Set to enable Cassandra authentication. # CASS_AUTH=y # The default value is n. # Cassandra uname/pword required if you enabled Cassandra authentication. # CASS_USERNAME= # CASS_PASSWORD= # Use to enable Postgres master-standby replication # when you have multiple Postgres nodes. # PG_MASTER=IPorDNSofNewMaster # PG_STANDBY=IPorDNSofOldMaster # SMTP information. SKIP_SMTP=n # Skip now and configure later by specifying "y". SMTPHOST=smtp.gmail.com SMTPUSER=your@email.com SMTPPASSWORD=yourEmailPassword SMTPSSL=y SMTPPORT=465 # If no SSL, use a different port, such as 25.
Die folgende Tabelle enthält zusätzliche Informationen zu diesen Eigenschaften:
Attribut |
Hinweis |
---|---|
IP-/DNS-Namen |
Verwenden Sie keine Hostnamenzuordnung zu 127.0.0.1 oder die IP-Adresse 127.0.0.1, wenn Sie die IP-Adresse eines Knotens angeben. |
ADMIN_EMAIL |
Das Passwort des Systemadministrators muss mindestens 8 Zeichen lang sein und einen Großbuchstaben, einen Kleinbuchstaben, eine Ziffer oder ein Sonderzeichen enthalten. Wenn Sie das Passwort weglassen, werden Sie aufgefordert, es einzugeben. |
LICENSE_FILE |
Der Speicherort der Lizenzdatei, auf die der „apigee“-Benutzer zugreifen kann. Speichern Sie sie beispielsweise im Verzeichnis „/tmp“ und mit „chmod 777“ für die Datei. Die Datei wird in das Edge-Installationsverzeichnis kopiert. |
USE_LDAP_REMOTE_HOST |
Wenn USE_LDAP_REMOTE_HOST n ist, installiert Edge automatisch OpenLDAP, wenn der Verwaltungsserver installiert wird. Setzen Sie USE_LDAP_REMOTE_HOST auf y, wenn Sie eine Verbindung zu einem Remote-LDAP-Server herstellen. OpenLDAP ist nicht mit dem Verwaltungsserver installiert. Wenn Sie eine Verbindung zu einem Remote-OpenLDAP-Server herstellen, verwenden Sie LDAP_HOST |
LDAP_TYPE |
LDAP_TYPE=1 für OpenLDAP ohne Replikation festgelegt. LDAP_TYPE=2 entspricht OpenLDAP mit Replikation. Wenn Ihre Edge-Topologie einen einzelnen OpenLDAP-Server verwendet, geben Sie 1 an. Wenn Ihre Edge-Installation mehrere OpenLDAP-Knoten verwendet, z. B. in einer Produktionsinstallation mit 13 Knoten, geben Sie 2 an. Wenn Sie die Replikation aktivieren, legen Sie die folgenden Attribute fest:
|
BIND_ON_ALL_INTERFACES |
Wenn „y“ festgelegt ist, bindet (überwachen) der Router/Message Processor alle Schnittstellen (IPs) ab. Wenn dieser Parameter auf „n“ gesetzt ist, bindet (überwacht) der Router/Message Processor eine bestimmte Schnittstelle an die vom Befehl „hostname -i“ zurückgegebene IP-Adresse. |
MP_POD |
Geben Sie den Namen des Message Processor- und Router-Pods an. Standardmäßig lautet der Name „Gateway“. |
REGION |
Name der Region. Konventionsgemäß haben Namen in der Regel die Form dc-#, wobei # einer Ganzzahl entspricht. Zum Beispiel dc-1, dc-2 usw. Sie können dc-1 verwenden, sofern Sie nicht in einer Umgebung mit mehreren Rechenzentren installieren. In einer Installation mit mehreren Rechenzentren lautet der Wert dc-1 oder dc-2 usw., je nachdem, welches Rechenzentrum Sie installieren. Sie sind jedoch nicht auf die Verwendung von Namen im Format dc-# beschränkt. Sie können einen beliebigen Namen für die Region verwenden. |
ZK_HOSTS |
Die IP-Adressen oder DNS-Namen der ZooKeeper-Knoten. Die IP-Adressen oder DNS-Namen müssen auf allen ZooKeeper-Knoten in derselben Reihenfolge aufgeführt werden. Listen Sie in einer Umgebung mit mehreren Rechenzentren alle ZooKeeper-Knoten aus beiden Rechenzentren auf. Geben Sie den Modifikator „:observer“ auf ZooKeeper-Knoten nur an, wenn Sie mehrere Rechenzentren erstellen, wie in einer Installation mit 12 Hosts beschrieben. In der Installation eines einzelnen Rechenzentrums können Sie diesen Modifikator weglassen. Weitere Informationen finden Sie unter Cluster-Installation mit 12 Hosts. |
ZK_CLIENT_HOSTS |
Die IP-Adressen oder DNS-Namen der ZooKeeper-Knoten, die von diesem Rechenzentrum verwendet werden. Die IP-Adressen oder DNS-Namen müssen auf allen ZooKeeper-Knoten in derselben Reihenfolge aufgelistet werden. In einer Installation eines einzelnen Rechenzentrums sind dies dieselben Knoten, die von ZK_HOSTS angegeben werden. Listen Sie in einer Umgebung mit mehreren Rechenzentren nur die ZooKeeper-Knoten in diesem Rechenzentrum auf. Weitere Informationen finden Sie unter Cluster-Installation mit 12 Hosts. |
CASS_HOSTS |
Die IP-Adressen (nicht die DNS-Namen) der Cassandra-Knoten. Die ersten beiden Knoten werden als Startserver verwendet. Die IP-Adressen müssen auf allen Cassandra-Knoten in der gleichen Reihenfolge aufgelistet werden. Cassandra-Knoten können das optionale Suffix „:dc,ra“ haben, das das Rechenzentrum und das Rack des Cassandra-Knotens angibt. Geben Sie diesen Modifikator nur an, wenn Sie mehrere Rechenzentren erstellen, wie in einer Installation mit 12 Hosts beschrieben. Bei der Installation eines einzelnen Rechenzentrums lassen Sie diesen Modifikator weg. Beispiel: 192.168.124.201:1,1 = Rechenzentrum 1 und Rack/Verfügbarkeitszone 1 und '192.168.124.204:2,1 = Rechenzentrum 2 und Rack/Verfügbarkeitszone 1. In einer Umgebung mit mehreren Rechenzentren müssen CASS_HOSTS zur Beseitigung von Firewallproblemen so angeordnet werden (wie im obigen Beispiel gezeigt), dass die Knoten des aktuellen Rechenzentrums am Anfang platziert werden. Weitere Informationen finden Sie unter Cluster-Installation mit 12 Hosts. |
CASS_AUTH CASS_PASSWORD |
Wenn Sie die Cassandra-Authentifizierung (CASS_AUTH=y) aktivieren, können Sie den Cassandra-Nutzernamen und das Passwort mithilfe dieser Attribute übergeben. |
PG_MASTER PG_STANDBY |
Legen Sie fest, dass die Postgres-Master-Standby-Replikation im folgenden Format aktiviert wird: PG_MASTER=IPorDNSofNewMaster PG_STANDBY=IPorDNSofOldMaster |
SKIP_SMTP |
Konfigurieren Sie SMTP, damit Edge E-Mails bei verlorenen Passwörtern und andere Benachrichtigungen senden kann. Wenn die SMTP-Nutzeranmeldedaten nicht erforderlich sind, lassen Sie SMTPUSER und SMTPPASSWORT weg. |
Reihenfolge der Komponenteninstallation
Die Reihenfolge der Komponenteninstallation richtet sich nach der gewünschten Topologie.
Im folgenden Beispiel wird davon ausgegangen, dass Sie Folgendes installieren:
- Mit deaktivierter Cassandra-Authentifizierung (Standardeinstellung). Weitere Informationen finden Sie unter Cassandra-Authentifizierung aktivieren.
- Mit deaktivierter Postgres-Master-Standby-Replikation (Standardeinstellung). Weitere Informationen finden Sie unter Master-Standby-Replikation für Postgres einrichten.
- Message Processor und Router auf demselben Knoten. Wenn Sie die Message Processors und Router auf verschiedenen Knoten installieren, installieren Sie zuerst alle Message Processors und dann alle Router.
Installationsprotokolldateien
Standardmäßig schreibt das Dienstprogramm „setup.sh“ Protokollinformationen über die Installation in:
/opt/apigee/var/log/apigee-setup/setup.log
Wenn der Nutzer, der das Dienstprogramm setup.sh ausführt, keinen Zugriff auf dieses Verzeichnis hat, wird das Log in das Verzeichnis /tmp als Datei namens setup_username.log geschrieben.
Wenn der Nutzer keinen Zugriff auf /tmp hat, schlägt das Dienstprogramm setup.sh fehl.
All-in-one-Installation
- Installieren Sie mit dem folgenden Befehl alle Komponenten auf einem einzelnen Knoten:
> /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile - Testen Sie die Installation wie unter Installation testen beschrieben.
- Onboarding Ihrer Organisation wie unter Organisation aufnehmen beschrieben.
Unten sehen Sie eine Konfigurationsdatei im Hintergrund dieser Topologie:
# With SMTP IP1=IPorDNSnameOfNode HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@apigee.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt MSIP=$IP1 LDAP_TYPE=1 APIGEE_LDAPPW=secret BIND_ON_ALL_INTERFACES=y MP_POD=gateway REGION=dc-1 ZK_HOSTS="$IP1" ZK_CLIENT_HOSTS="$IP1" # Must use IP addresses for CASS_HOSTS, not DNS names. CASS_HOSTS="$IP1" SKIP_SMTP=n SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com # omit for no username SMTPPASSWORD=smtppwd # omit for no password SMTPSSL=n SMTPPORT=25
Eigenständige Installation mit 2 Hosts
Eine Liste der Edge-Topologien und Knotennummern finden Sie unter Installationstopologien.
- Eigenständiges Gateway und Knoten 1 installieren
> /opt/apigee/apigee-setup/bin/setup.sh -p sa -f configFile - Installieren Sie Analytics auf Knoten 2:
> /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile - Testen Sie die Installation wie unter Installation testen beschrieben.
- Onboarding Ihrer Organisation wie unter Organisation aufnehmen beschrieben.
Unten sehen Sie eine Konfigurationsdatei im Hintergrund dieser Topologie:
# With SMTP IP1=IPorDNSnameOfNode1 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@apigee.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt MSIP=$IP1 LDAP_TYPE=1 APIGEE_LDAPPW=secret BIND_ON_ALL_INTERFACES=y MP_POD=gateway REGION=dc-1 ZK_HOSTS="$IP1" ZK_CLIENT_HOSTS="$IP1" # Must use IP addresses for CASS_HOSTS, not DNS names. CASS_HOSTS="$IP1" SKIP_SMTP=n SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com # omit for no username SMTPPASSWORD=smtppwd # omit for no password SMTPSSL=n SMTPPORT=25
Clusterinstallation mit 5 Hosts
Eine Liste der Edge-Topologien und Knotennummern finden Sie unter Installationstopologien.
- Installieren Sie den Datastore-Cluster auf den Knoten 1, 2 und 3:
> /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile - Installieren Sie Management Server auf Knoten 1:
> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile - Installieren Sie den Router und den Message Processor auf den Knoten 2 und 3:
> /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile - Installieren Sie Analytics auf Knoten 4 und 5:
> /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile - Testen Sie die Installation wie unter Installation testen beschrieben.
- Onboarding Ihrer Organisation wie unter Organisation aufnehmen beschrieben.
Unten sehen Sie eine Konfigurationsdatei im Hintergrund dieser Topologie:
# With SMTP IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP4=IPorDNSnameOfNode4 IP5=IPorDNSnameOfNode5 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@apigee.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt MSIP=$IP1 USE_LDAP_REMOTE_HOST=n LDAP_TYPE=1 APIGEE_LDAPPW=secret BIND_ON_ALL_INTERFACES=y MP_POD=gateway REGION=dc-1 ZK_HOSTS="$IP1 $IP2 $IP3" ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" # Must use IP addresses for CASS_HOSTS, not DNS names. CASS_HOSTS="$IP1 $IP2 $IP3" PG_MASTER=$IP4 PG_STANDBY=$IP5 SKIP_SMTP=n SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com # omit for no username SMTPPASSWORD=smtppwd # omit for no password SMTPSSL=n SMTPPORT=25
Geclusterte Installation mit 9 Hosts
Eine Liste der Edge-Topologien und Knotennummern finden Sie unter Installationstopologien.
- Installieren Sie den Datastore-Clusterknoten auf den Knoten 1, 2 und 3:
> /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile - Installieren Sie Apigee Management Server auf Knoten 1:
> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile - Installieren Sie Router und Message Processor auf den Knoten 4 und 5:
> /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile - Installieren Sie den Apigee Analytics Qpid Server auf Knoten 6 und 7:
> /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile - Installieren Sie den Apigee Analytics Postgres Server auf Knoten 8 und 9:
> /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile - Testen Sie die Installation wie unter Installation testen beschrieben.
- Onboarding Ihrer Organisation wie unter Organisation aufnehmen beschrieben.
Unten sehen Sie eine Konfigurationsdatei im Hintergrund dieser Topologie:
# With SMTP IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP8=IPorDNSnameOfNode8 IP9=IPorDNSnameOfNode9 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@apigee.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt MSIP=$IP1 USE_LDAP_REMOTE_HOST=n LDAP_TYPE=1 APIGEE_LDAPPW=secret BIND_ON_ALL_INTERFACES=y MP_POD=gateway REGION=dc-1 ZK_HOSTS="$IP1 $IP2 $IP3" ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" # Must use IP addresses for CASS_HOSTS, not DNS names. CASS_HOSTS="$IP1 $IP2 $IP3" SKIP_SMTP=n PG_MASTER=$IP8 PG_STANDBY=$IP9 SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com # omit for no username SMTPPASSWORD=smtppwd # omit for no password SMTPSSL=n SMTPPORT=25
Geclusterte Installation mit 13 Hosts
Eine Liste der Edge-Topologien und Knotennummern finden Sie unter Installationstopologien.
- Installieren Sie den Datastore-Clusterknoten auf den Knoten 1, 2 und 3:
> /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile - Installieren Sie OpenLDAP auf Knoten 4 und 5:
> /opt/apigee/apigee-setup/bin/setup.sh -p ld -f configFile - Installieren Sie Apigee Management Server auf Knoten 6 und 7:
> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile - Installieren Sie den Apigee Analytics Postgres Server auf Knoten 8 und 9:
> /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile - Installieren Sie den Router und den Message Processor auf den Knoten 10 und 11:
> /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile - Installieren Sie den Qpid-Server von Apigee Analytics auf den Knoten 12 und 13:
> /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile - Testen Sie die Installation wie unter Installation testen beschrieben.
- Onboarding Ihrer Organisation wie unter Organisation aufnehmen beschrieben.
Unten sehen Sie eine Konfigurationsdatei im Hintergrund dieser Topologie:
# For all components except OpenLDAP IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP4=IPorDNSnameOfNode4 IP5=IPorDNSnameOfNode5 IP6=IPorDNSnameOfNode6 IP7=IPorDNSnameOfNode7 IP8=IPorDNSnameOfNode8 IP9=IPorDNSnameOfNode9 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@apigee.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt # First Management Server on IP6 MSIP=$IP6 USE_LDAP_REMOTE_HOST=y LDAP_HOST=$IP4 LDAP_PORT=10389 # Second Management Server on IP7 # MSIP=$IP7 # USE_LDAP_REMOTE_HOST=y # LDAP_HOST=$IP5 # LDAP_PORT=10389 # Same password for both OpenLDAPs. APIGEE_LDAPPW=secret BIND_ON_ALL_INTERFACES=y MP_POD=gateway REGION=dc-1 ZK_HOSTS="$IP1 $IP2 $IP3" ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" # Must use IP addresses for CASS_HOSTS, not DNS names. CASS_HOSTS="$IP1 $IP2 $IP3" PG_MASTER=$IP8 PG_STANDBY=$IP9 SKIP_SMTP=n SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com # omit for no username SMTPPASSWORD=smtppwd # omit for no password SMTPSSL=n SMTPPORT=25 |
# For OpenLDAP on IP4 and IP5 IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP4=IPorDNSnameOfNode4 IP5=IPorDNSnameOfNode5 IP6=IPorDNSnameOfNode6 IP7=IPorDNSnameOfNode7 IP8=IPorDNSnameOfNode8 IP9=IPorDNSnameOfNode9 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@apigee.com APIGEE_ADMINPW=Secret123 # First OpenLDAP Server on IP4 MSIP=$IP6 USE_LDAP_REMOTE_HOST=n LDAP_TYPE=2 LDAP_SID=1 LDAP_PEER=$IP5 # Second OpenLDAP Server on IP5 # MSIP=$IP7 # USE_LDAP_REMOTE_HOST=n # LDAP_TYPE=2 # LDAP_SID=2 # LDAP_PEER=$IP4 # Set same password for both OpenLDAPs. APIGEE_LDAPPW=secret |
Clusterinstallation mit 12 Hosts
Bevor Sie Edge in einer Cluster-Topologie mit 12 Hosts (zwei Rechenzentren) installieren, müssen Sie wissen, wie die Properties ZooKeeper und Cassandra in der stillen Konfigurationsdatei festgelegt werden.
- ZooKeeper
Geben Sie für die ZK_HOSTS-Property für beide Rechenzentren die IP-Adressen oder DNS-Namen aller ZooKeeper-Knoten aus beiden Rechenzentren in derselben Reihenfolge an und kennzeichnen Sie alle Knoten mit dem Modifikator „:observer“. Knoten ohne den Modifikator „:observer“ werden als „voters“ bezeichnet. Ihre Konfiguration muss eine ungerade Anzahl von Abstimmen enthalten.
Bei dieser Topologie ist der ZooKeeper-Host auf Host 9 der Beobachter:
Geben Sie für die ZK_CLIENT_HOSTS-Property für jedes Rechenzentrum die IP-Adressen oder DNS-Namen der ZooKeeper-Knoten im Rechenzentrum in derselben Reihenfolge für alle ZooKeeper-Knoten im Rechenzentrum an. In der unten gezeigten Beispielkonfigurationsdatei ist Knoten 9 mit dem Modifikator „:observer“ getaggt, sodass Sie fünf Voter haben: Knoten 1, 2, 3, 7 und 8. - Cassandra
Alle Rechenzentren müssen die gleiche Anzahl von Cassandra-Knoten haben.
Achten Sie darauf, dass Sie für CASS_HOSTS für jedes Rechenzentrum alle Cassandra-IP-Adressen (nicht DNS-Namen) für beide Rechenzentren angeben. Für Rechenzentrum 1 listen Sie zuerst die Cassandra-Knoten in diesem Rechenzentrum auf. Für Rechenzentrum 2 listen Sie zuerst die Cassandra-Knoten in diesem Rechenzentrum auf. Listen Sie die Cassandra-Knoten für alle Cassandra-Knoten im Rechenzentrum in der gleichen Reihenfolge auf.
Alle Cassandra-Knoten müssen das Suffix „:<d>,<r>“ haben, z. B. „<ip>:1,1 = Rechenzentrum 1 und Rack-/Verfügbarkeitszone 1 und <ip>:2,1 = Rechenzentrum 2 und Rack-/Verfügbarkeitszone 1.
Beispiel: "192.168.124.201:1,1 192.168.124.202:1,1 192.168.124.203:1,1 192.168.124.204:2,1 192.168.12.1 192.168.12.1 192.168.12.
In diesem Bereitstellungsmodell sieht die Cassandra-Einrichtung so aus:
Eine Liste der Edge-Topologien und Knotennummern finden Sie unter Installationstopologien.
- Installieren Sie den Datastore-Clusterknoten auf den Knoten 1, 2, 3, 7, 8 und 9:
> /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile - Installieren Sie Apigee Management Server mit OpenLDAP-Replikation auf Knoten 1 und 7:
> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile - Installieren Sie Router und Message Processor auf den Knoten 2, 3, 8 und 9:
> /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile - Installieren Sie den Qpid-Server von Apigee Analytics auf den Knoten 4, 5, 10 und 11:
> /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile - Installieren Sie den Apigee Analytics Postgres Server auf Knoten 6 und 12:
> /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile - Testen Sie die Installation wie unter Installation testen beschrieben.
- Onboarding Ihrer Organisation wie unter Organisation aufnehmen beschrieben.
Unten sehen Sie eine unbeaufsichtigte Konfigurationsdatei für diese Topologie. Beachten Sie, dass diese Konfigurationsdatei:
- Konfiguriert OpenLDAP mit Replikation über zwei OpenLDAP-Knoten.
- Gibt den Modifikator „:observer“ für einen ZooKeeper-Knoten an. In der Installation eines einzelnen Rechenzentrums können Sie diesen Modifikator weglassen.
# Datacenter 1 IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP6=IPorDNSnameOfNode6 IP7=IPorDNSnameOfNode7 IP8=IPorDNSnameOfNode8 IP9=IPorDNSnameOfNode9 IP12=IPorDNSnameOfNode12 HOSTIP=$(hostname -i) MSIP=$IP1 ADMIN_EMAIL=opdk@apigee.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt USE_LDAP_REMOTE_HOST=n LDAP_TYPE=2 LDAP_SID=1 LDAP_PEER=$IP7 APIGEE_LDAPPW=secret BIND_ON_ALL_INTERFACES=y MP_POD=gateway-1 REGION=dc-1 ZK_HOSTS="$IP1 $IP2 $IP3 $IP7 $IP8 $IP9:observer" ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" # Must use IP addresses for CASS_HOSTS, not DNS names. CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1 $IP7:2,1 $IP8:2,1 $IP9:2,1" PG_MASTER=$IP6 PG_STANDBY=$IP12 SKIP_SMTP=n SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com # omit for no username SMTPPASSWORD=smtppwd # omit for no password SMTPSSL=n SMTPPORT=25 |
# Datacenter 2 IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP6=IPorDNSnameOfNode6 IP7=IPorDNSnameOfNode7 IP8=IPorDNSnameOfNode8 IP9=IPorDNSnameOfNode9 IP12=IPorDNSnameOfNode12 HOSTIP=$(hostname -i) MSIP=$IP7 ADMIN_EMAIL=opdk@apigee.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt USE_LDAP_REMOTE_HOST=n LDAP_TYPE=2 LDAP_SID=2 LDAP_PEER=$IP1 APIGEE_LDAPPW=secret BIND_ON_ALL_INTERFACES=y MP_POD=gateway-2 REGION=dc-2 ZK_HOSTS="$IP1 $IP2 $IP3 $IP7 $IP8 $IP9:observer" ZK_CLIENT_HOSTS="$IP7 $IP8 $IP9" # Must use IP addresses for CASS_HOSTS, not DNS names. CASS_HOSTS="$IP7:2,1 $IP8:2,1 $IP9:2,1 $IP1:1,1 $IP2:1,1 $IP3:1,1" PG_MASTER=$IP6 PG_STANDBY=$IP12 SKIP_SMTP=n SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com # omit for no username SMTPPASSWORD=smtppwd # omit for no password SMTPSSL=n SMTPPORT=25 |