Edge-Komponenten auf einem Knoten installieren

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

Informationen zum Installieren des Edge-apigee-setup finden Sie unter Edge-Dienstprogramm für Apigee-Setup installieren.

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 Stand-by-Knoten den Servertraffic bei einem Ausfall des Masterknotens fortsetzen kann.

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.

Weitere Informationen finden Sie unter Cassandra-Authentifizierung aktivieren.

Geschützten Port beim Erstellen eines virtuellen Hosts verwenden

Wenn Sie einen virtuellen Host erstellen möchten, der den Router an einen geschützten Port (z. B. Portnummern unter 1.000) bindet, müssen Sie den Router 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.

Informationen zum Konfigurieren eines virtuellen Hosts und eines Routers für den Zugriff auf Ports unter 1.000 finden Sie unter Virtuellen Host einrichten.

Installieren Sie die neue Edge-Benutzeroberfläche

Nach Abschluss der Erstinstallation empfiehlt Apigee, dass Sie die neue Edge-Benutzeroberfläche installieren. Dabei handelt es sich um eine verbesserte Benutzeroberfläche für Entwickler und Administratoren von Apigee Edge für Private Cloud. Die klassische Benutzeroberfläche wird standardmäßig installiert.

Beachten Sie, dass für die Edge-Benutzeroberfläche die Basisauthentifizierung deaktiviert und ein IdP wie SAML oder LDAP verwendet werden muss.

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

Zu installierende Komponenten angeben

In der folgenden Tabelle sind die Optionen aufgeführt, die Sie an die Option -p des Dienstprogramms apigee-service ü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.

mt

Installieren Sie den Edge-Verwaltungsserver, der auch OpenLDAP installiert.

Wenn Sie USE_LDAP_REMOTE_HOST=y in der Konfigurationsdatei festlegen, wird die OpenLDAP-Installation übersprungen und der Verwaltungsserver verwendet OpenLDAP, das auf einem anderen Knoten installiert ist.

ms

Installieren Sie den Edge-Verwaltungsserver, der auch die Edge-Benutzeroberfläche und OpenLDAP installiert.

Wenn Sie USE_LDAP_REMOTE_HOST=y in der Konfigurationsdatei 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.

rmp

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.
pdb Installieren Sie nur die Postgres-Datenbank – wird nur bei der Installation des Apigee Developer Services-Portals (oder einfach des Portals) verwendet. Siehe Portal installieren.

sax

Installieren Sie die Analysekomponenten, d. h. Qpid und Postgres.

Verwenden Sie diese Option nur für Entwicklung und Tests, nicht für die Produktion.
sso Installieren Sie das Apigee SSO-Modul.

mo

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

Installieren Sie das Portal.

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. Für jedes Rechenzentrum sind unterschiedliche Einstellungen für Properties wie ZK_CLIENT_HOSTS und CASS_HOSTS erforderlich.

Jede unten beschriebene Installationstopologie enthält eine beispielhafte Konfigurationsdatei für diese Topologie. Eine vollständige Referenz zur Konfigurationsdatei finden Sie in der Referenz zur Edge-Konfigurationsdatei.

Systemanforderungen ohne Installation testen

Edge für die Private Cloud unterstützt das Attribut ENABLE_SYSTEM_CHECK=y, um CPU- und Arbeitsspeicheranforderungen auf einem Computer im Rahmen einer Installation zu prüfen. In früheren Edge-Releases musste für diese Überprüfung jedoch die Installation tatsächlich durchgeführt werden.

Sie können jetzt das Flag „-t“ verwenden, um diese Prüfung durchzuführen, ohne eine Installation durchführen zu müssen. Wenn Sie beispielsweise die Systemanforderungen für eine "aio"-Installation prüfen möchten, ohne die Installation tatsächlich durchzuführen, verwenden Sie den folgenden Befehl:

/opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile -t

Mit diesem Befehl werden alle Fehler im Zusammenhang mit den Systemanforderungen auf dem Bildschirm angezeigt.

Unter Installationsanforderungen finden Sie eine Liste der Systemanforderungen für alle Edge-Komponenten.

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 mit dem Namen setup_username.log geschrieben.

Wenn der Nutzer keinen Zugriff auf /tmp hat, schlägt das setup.sh-Dienstprogramm fehl.

Edge-Komponenten installieren

In diesem Abschnitt wird beschrieben, wie Sie Edge-Komponenten für die verschiedenen Topologien installieren. 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.

Voraussetzungen

Bevor Sie Edge-Komponenten installieren können, müssen Sie:

Installation in einem Gerät

  1. Verwenden Sie folgenden Befehl, um alle Komponenten auf einem einzelnen Knoten zu installieren: 
    /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
  2. Starten Sie die Komponente der klassischen UI nach Abschluss der Installation neu: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    Dies gilt für die klassische Benutzeroberfläche, nicht für die neue Edge-Benutzeroberfläche, deren Komponentenname edge-management-ui ist.

  3. Testen Sie die Installation wie unter Installation testen beschrieben.
  4. Onboarding Ihrer Organisation wie unter Organisation aufnehmen beschrieben.

Ein Video einer Edge-All-in-one-Installation finden Sie hier.

Unten sehen Sie eine unbeaufsichtigte Konfigurationsdatei für diese Topologie. Eine vollständige Referenz zur Konfigurationsdatei finden Sie in der Referenz zur Edge-Konfigurationsdatei.

# With SMTP
IP1=IP_or_DNS_name_of_Node_1
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
# Admin password must be at least 8 characters long and contain one uppercase
# letter, one lowercase letter, and one digit or special character
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
LDAP_TYPE=1
APIGEE_LDAPPW=LDAP_PASSWORD
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"
# Default is postgres
PG_PWD=postgres
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"

Eigenständige Installation mit 2 Knoten

Eine Liste der Edge-Topologien und Knotennummern finden Sie unter Installationstopologien.

  1. Eigenständiges Gateway und Knoten 1 installieren 
    /opt/apigee/apigee-setup/bin/setup.sh -p sa -f configFile
  2. Installieren Sie Analytics auf Knoten 2: 
    /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
  3. Starten Sie die Komponente der klassischen UI auf Knoten 1 neu: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    Dies gilt für die klassische Benutzeroberfläche, nicht für die neue Edge-Benutzeroberfläche, deren Komponentenname edge-management-ui ist.

  4. Testen Sie die Installation wie unter Installation testen beschrieben.
  5. Onboarding Ihrer Organisation wie unter Organisation aufnehmen beschrieben.

Unten sehen Sie eine unbeaufsichtigte Konfigurationsdatei für diese Topologie. Eine vollständige Referenz zur Konfigurationsdatei finden Sie in der Referenz zur Edge-Konfigurationsdatei.

# With SMTP
IP1=IP_of_Node_1
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
LDAP_TYPE=1
APIGEE_LDAPPW=LDAP_PASSWORD
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"
# Default is postgres
PG_PWD=postgres
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"

Installation mit 5 Knoten

Eine Liste der Edge-Topologien und Knotennummern finden Sie unter Installationstopologien.

  1. Datastore-Cluster auf den Knoten 1, 2 und 3 installieren: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Installieren Sie den Verwaltungsserver auf Knoten 1: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. 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
  4. Installieren Sie Analytics auf den Knoten 4 und 5: 
    /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
  5. Starten Sie die Komponente der klassischen UI auf Knoten 1 neu: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    Dies gilt für die klassische Benutzeroberfläche, nicht für die neue Edge-Benutzeroberfläche, deren Komponentenname edge-management-ui ist.

  6. Testen Sie die Installation wie unter Installation testen beschrieben.
  7. Onboarding Ihrer Organisation wie unter Organisation aufnehmen beschrieben.

Unten sehen Sie eine unbeaufsichtigte Konfigurationsdatei für diese Topologie. Eine vollständige Referenz zur Konfigurationsdatei finden Sie in der Referenz zur Edge-Konfigurationsdatei.

# With SMTP
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP4=IP_of_Node_4
IP5=IP_of_Node_5
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=1
APIGEE_LDAPPW=LDAP_PASSWORD
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"
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP4
PG_STANDBY=$IP5
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"

Clusterinstallation mit 9 Knoten

Eine Liste der Edge-Topologien und Knotennummern finden Sie unter Installationstopologien.

  1. Installieren Sie den Datastore-Clusterknoten auf den Knoten 1, 2 und 3: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Installieren Sie Apigee Management Server auf Knoten 1: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. Installieren Sie den Router und den Message Processor auf den Knoten 4 und 5: 
    /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. Installieren Sie den Qpid-Server von Apigee Analytics auf Knoten 6 und 7: 
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. Installieren Sie den Apigee Analytics Postgres Server auf den Knoten 8 und 9: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. Starten Sie die Komponente der klassischen UI auf Knoten 1 neu: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    Dies gilt für die klassische Benutzeroberfläche, nicht für die neue Edge-Benutzeroberfläche, deren Komponentenname edge-management-ui ist.

  7. Testen Sie die Installation wie unter Installation testen beschrieben.
  8. Onboarding Ihrer Organisation wie unter Organisation aufnehmen beschrieben.

Unten sehen Sie eine unbeaufsichtigte Konfigurationsdatei für diese Topologie. Eine vollständige Referenz zur Konfigurationsdatei finden Sie in der Referenz zur Edge-Konfigurationsdatei.

# With SMTP
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP8=IP_of_Node_8
IP9=IP_of_Node_9
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt 
MSIP=$IP1 
USE_LDAP_REMOTE_HOST=n 
LDAP_TYPE=1
APIGEE_LDAPPW=LDAP_PASSWORD
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.
# Optionally use Cassandra racks
CASS_HOSTS="$IP1 $IP2 $IP3" 
# Default is postgres
PG_PWD=postgres
SKIP_SMTP=n
PG_MASTER=$IP8
PG_STANDBY=$IP9
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"

Clusterinstallation mit 13 Knoten

In diesem Abschnitt wird die Reihenfolge der Installation für einen Cluster mit 13 Knoten beschrieben. Eine Liste der Edge-Topologien und Knotennummern finden Sie unter Installationstopologien.

Bei einem Cluster mit 13 Knoten wird die Installation so durchgeführt:

  1. Installieren Sie den Datastore-Clusterknoten auf den Knoten 1, 2 und 3: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Installieren Sie OpenLDAP auf Knoten 4 und 5: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ld -f configFile
  3. Installieren Sie Apigee Management Server auf Knoten 6 und 7: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  4. Installieren Sie den Apigee Analytics Postgres Server auf den Knoten 8 und 9: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  5. 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
  6. Installieren Sie den Apigee Analytics Qpid Server auf den Knoten 12 und 13: 
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  7. Starten Sie die Komponente der klassischen UI auf den Knoten 6 und 7 neu: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    Dies gilt für die klassische Benutzeroberfläche, nicht für die neue Edge-Benutzeroberfläche, deren Komponentenname edge-management-ui ist.

  8. Testen Sie die Installation wie unter Installation testen beschrieben.
  9. Onboarding Ihrer Organisation wie unter Organisation aufnehmen beschrieben.

Unten sehen Sie ein Beispiel für eine stille Konfigurationsdatei für diese Topologie. Eine vollständige Referenz zur Konfigurationsdatei finden Sie in der Referenz zur Edge-Konfigurationsdatei.

# For all nodes except IP4 and IP5
# (which are the OpenLDAP nodes)
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP4=IP_of_Node_4
IP5=IP_of_Node_5
IP6=IP_of_Node_6
IP7=IP_of_Node_7
IP8=IP_of_Node_8
IP9=IP_of_Node_9
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
# Management Server on IP6 only
MSIP=$IP6
USE_LDAP_REMOTE_HOST=y
LDAP_HOST=$IP4
LDAP_PORT=10389
# Management Server on IP7 only
# MSIP=$IP7
# USE_LDAP_REMOTE_HOST=y
# LDAP_HOST=$IP5
# LDAP_PORT=10389
# Use the same password for both OpenLDAP nodes
APIGEE_LDAPPW=LDAP_PASSWORD 
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.
# Optionally use Cassandra racks
CASS_HOSTS="$IP1 $IP2 $IP3"
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP8
PG_STANDBY=$IP9
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
 
# For OpenLDAP nodes only (IP4 and IP5)
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP4=IP_of_Node_4
IP5=IP_of_Node_5
IP6=IP_of_Node_6
IP7=IP_of_Node_7
IP8=IP_of_Node_8
IP9=IP_of_Node_9
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD

# For the OpenLDAP Server on IP4 only
MSIP=$IP6
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP5

# For the OpenLDAP Server on IP5 only
# MSIP=$IP7
# USE_LDAP_REMOTE_HOST=n
# LDAP_TYPE=2
# LDAP_SID=2
# LDAP_PEER=$IP4
# Set same password for both OpenLDAPs.
APIGEE_LDAPPW=LDAP_PASSWORD

Clusterinstallation mit 12 Knoten

Bevor Sie Edge in einer Clustertopologie mit 12 Knoten (zwei Rechenzentren) installieren, müssen Sie wissen, wie die Properties ZooKeeper und Cassandra in der stillen Konfigurationsdatei festgelegt werden.

  • ZooKeeper

    Geben Sie für das Attribut ZK_HOSTS für beide Rechenzentren die IP-Adressen oder DNS-Namen aller ZooKeeper-Knoten aus beiden Rechenzentren in derselben Reihenfolge an und markieren Sie alle Knoten mit dem Modifikator :observer. Knoten ohne den :observer-Modifikator werden als „Voter“ 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 Property ZK_CLIENT_HOSTS 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 :observer-Modifikator getaggt, sodass Sie fünf Voter haben: die 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. Beispiel: 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.122,160.122.160.122.168.122.168.124.168.124.168.124.168.124.124.124.

    Der erste Knoten in Rack-/Verfügbarkeitszone 1 jedes Rechenzentrums wird als Startserver verwendet.

    In diesem Bereitstellungsmodell sieht die Cassandra-Einrichtung wie folgt aus:

Eine Liste der Edge-Topologien und Knotennummern finden Sie unter Installationstopologien.

  1. 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
  2. Installieren Sie Apigee Management Server mit OpenLDAP-Replikation auf Knoten 1 und 7: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. Installieren Sie den Router und den Message Processor auf den Knoten 2, 3, 8 und 9: 
    /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. 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
  5. Installieren Sie den Apigee Analytics Postgres Server auf Knoten 6 und 12: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. Starten Sie die Komponente der klassischen UI auf den Knoten 1 und 7 neu: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    Dies gilt für die klassische Benutzeroberfläche, nicht für die neue Edge-Benutzeroberfläche, deren Komponentenname edge-management-ui ist.

  7. Testen Sie die Installation wie unter Installation testen beschrieben.
  8. Onboarding Ihrer Organisation wie unter Organisation aufnehmen beschrieben.

Unten sehen Sie eine unbeaufsichtigte Konfigurationsdatei für diese Topologie. Eine vollständige Referenz zur Konfigurationsdatei finden Sie in der Referenz zur Edge-Konfigurationsdatei.

  • Konfiguriert OpenLDAP mit Replikation über zwei OpenLDAP-Knoten.
  • Gibt den :observer-Modifikator für einen ZooKeeper-Knoten an. In der Installation eines einzelnen Rechenzentrums können Sie diesen Modifikator weglassen.
# Datacenter 1
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP6=IP_of_Node_6
IP7=IP_of_Node_7
IP8=IP_of_Node_8
IP9=IP_of_Node_9
IP12=IP_of_Node_12
HOSTIP=$(hostname -i)
MSIP=$IP1
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP7
APIGEE_LDAPPW=LDAP_PASSWORD
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.
# Optionally use Cassandra racks
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1 $IP7:2,1 $IP8:2,1 $IP9:2,1"
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP6
PG_STANDBY=$IP12
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
 
# Datacenter 2
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP6=IP_of_Node_6
IP7=IP_of_Node_7
IP8=IP_of_Node_8
IP9=IP_of_Node_9
IP12=IP_of_Node_12
HOSTIP=$(hostname -i)
MSIP=$IP7
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=2
LDAP_PEER=$IP1
APIGEE_LDAPPW=LDAP_PASSWORD
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.
# Optionally use Cassandra racks
CASS_HOSTS="$IP7:2,1 $IP8:2,1 $IP9:2,1 $IP1:1,1 $IP2:1,1 $IP3:1,1"
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP6
PG_STANDBY=$IP12
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"