Edge-Komponenten auf einem Knoten installieren

Nachdem Sie das Edge-apigee-setup-Dienstprogramm auf einem Knoten installiert haben, installieren Sie mit dem apigee-setup-Dienstprogramm eine oder mehrere Edge-Komponenten auf dem Knoten.

Das Dienstprogramm apigee-setup verwendet einen Befehl in der folgenden Form:

/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 „apigee“-Benutzer zugreifen kann.

So installieren Sie beispielsweise den Edge-Management-Server:

/opt/apigee/apigee-setup/bin/setup.sh -p ms -f /usr/local/myConfig

Informationen zum Installieren von Edge apigee-setup finden Sie unter Edge-Dienstprogramm 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 bei einem Ausfall des Master-Knotens weiterhin den Server-Traffic weiterleiten kann.

Sie können die Master-Stand-by-Replikation bei der Installation mithilfe von Attributen in der Silent Config-Datei aktivieren und konfigurieren. Alternativ können Sie die Master-Stand-by-Replikation nach der Installation aktivieren. Weitere Informationen finden Sie unter Master-Stand-by-Replikation für Postgres einrichten.

Cassandra-Authentifizierung aktivieren

Cassandra wird standardmäßig 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 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.

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

Neue Anforderungen durch apigee-qpidd-4.52.01-X.X.X

Ab Version 4.52.01 wurden während der Installation neue Anforderungen eingeführt. Dazu müssen während der Installation die Attribute QPID_MGMT_USERNAME und QPID_MGMT_PASSWORD angegeben werden. Fügen Sie diese Attribute mit den entsprechenden Werten in die Konfigurationsdatei ein, um eine erfolgreiche Installation zu ermöglichen.

Installieren Sie die neue Edge-Benutzeroberfläche

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

Beachten Sie, dass Sie für die Edge-Benutzeroberfläche die Basisauthentifizierung deaktivieren und einen IdP wie SAML oder LDAP verwenden müssen.

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 Installieren Sie nur ZooKeeper.

ds

Installieren Sie ZooKeeper und Cassandra.

ld

Installieren Sie nur OpenLDAP.

mt

Installieren Sie den Edge-Management-Server, 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-Management-Server, der auch die Edge-UI 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 den 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 Qpid Server.

ps

Nur Postgres-Server installieren.
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 Edge eigenständig, d. h. Cassandra, ZooKeeper, Management Server, OpenLDAP, Edge-UI, Router und Message Processor. Bei dieser Option werden die Edge-Analysekomponenten ausgelassen: Qpid und Postgres.

Verwenden Sie diese Option nur für Entwicklung und Tests, nicht für die Produktion.

aio

Alle Komponenten auf einem einzigen Knoten installieren

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

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

Systemanforderungen ohne Ausführung einer Installation testen

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

Sie können jetzt das Flag „-t“ verwenden, um diese Prüfung ohne Installation durchzuführen. 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.

In allen unten gezeigten Installationsbeispielen 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-Stand-by-Replikation für Postgres einrichten.
  • Message Processor und Router auf demselben Knoten. Wenn Sie die Nachrichtenprozessoren und Router auf verschiedenen Knoten installieren, installieren Sie zuerst alle Nachrichtenprozessoren und dann alle Router.

Voraussetzungen

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

  • Prüfen Sie die Installationsanforderungen, um die Voraussetzungen und eine Liste der erforderlichen Dateien zu erhalten, bevor Sie mit der Installation fortfahren. Lesen Sie die Anforderungen, bevor Sie mit der Installation beginnen.
  • Deaktivieren Sie SELinux oder stellen Sie den Modus auf den mäßigen Modus ein. Weitere Informationen finden Sie unter Edge-Dienstprogramm apigee-setup installieren.

Komplettinstallation

  1. Installieren Sie mit dem folgenden Befehl alle Komponenten auf einem einzelnen Knoten: 
    /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
  2. Starten Sie die klassische UI-Komponente 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 einrichten 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 unter 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>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=pass1234

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. Analytics auf Knoten 2 installieren: 
    /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 einrichten beschrieben.

Unten sehen Sie eine unbeaufsichtigte Konfigurationsdatei für diese Topologie. Eine vollständige Referenz zur Konfigurationsdatei finden Sie unter 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>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=pass1234

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. Verwaltungsserver auf Knoten 1 installieren: 
    /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 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 einrichten beschrieben.

Unten sehen Sie eine unbeaufsichtigte Konfigurationsdatei für diese Topologie. Eine vollständige Referenz zur Konfigurationsdatei finden Sie unter 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>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=pass1234

Clusterinstallation mit 9 Knoten

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

  1. Datastore-Clusterknoten auf Knoten 1, 2 und 3 installieren: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Apigee Management Server auf Knoten 1 installieren: 
    /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 Postgres Server von Apigee Analytics auf 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 einrichten beschrieben.

Unten sehen Sie eine unbeaufsichtigte Konfigurationsdatei für diese Topologie. Eine vollständige Referenz zur Konfigurationsdatei finden Sie unter 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>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=pass1234

Clusterinstallation mit 13 Knoten

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

Bei einem Cluster mit 13 Knoten wird die Installation in folgender Reihenfolge ausgeführt:

  1. Datastore-Clusterknoten auf Knoten 1, 2 und 3 installieren: 
    /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 Postgres Server von Apigee Analytics auf 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 Qpid-Server von Apigee Analytics auf Knoten 12 und 13: 
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  7. Starten Sie die klassische UI-Komponente 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 einrichten beschrieben.

Unten sehen Sie ein Beispiel für eine stille Konfigurationsdatei für diese Topologie. Eine vollständige Referenz zur Konfigurationsdatei finden Sie unter 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>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=pass1234
 
# 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 Attribute ZooKeeper und Cassandra in der stillen Konfigurationsdatei festgelegt werden.

  • ZooKeeper

    Geben Sie im Attribut ZK_HOSTS 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 :observer-Modifikator werden als "Voter" bezeichnet. Die Konfiguration muss eine ungerade Anzahl von Stimmen enthalten.

    Bei dieser Topologie ist der ZooKeeper-Host auf Host 9 der Beobachter:

    Geben Sie für die Eigenschaft 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 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 bei CASS_HOSTS für jedes Rechenzentrum darauf, dass Sie 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 die Cassandra-Knoten in diesem Rechenzentrum zuerst auf. Listen Sie die Cassandra-Knoten in der gleichen Reihenfolge für alle Cassandra-Knoten im Rechenzentrum 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.124.192.168.124.192.168.124.192.168.124.192.168.124.1

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

    In diesem Bereitstellungsmodell sieht die Cassandra-Einrichtung so 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 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 klassische UI-Komponente 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 einrichten beschrieben.

Unten sehen Sie eine unbeaufsichtigte Konfigurationsdatei für diese Topologie. Eine vollständige Referenz zur Konfigurationsdatei finden Sie unter 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 lassen Sie diesen Modifikator weg.
# 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>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=pass1234
 
# 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>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=pass1234