Edge-Komponenten auf einem Knoten installieren

Nachdem Sie das Edge-apigee-setup-Dienstprogramm auf einem Knoten installiert haben, verwenden Sie es 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 Konfigurationsdatei für die unbeaufsichtigte Installation mit den Installationsinformationen. Die Konfigurationsdatei muss für den Nutzer „apigee“ 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 Management Server:

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

Informationen zur Installation des Edge-apigee-setup finden Sie unter Edge-Dienstprogramm „apigee-setup“ installieren.

Überlegungen 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 Master-Modus. In Produktionssystemen mit mehreren Postgres-Knoten müssen Sie sie jedoch so konfigurieren, dass sie die Master-Standby-Replikation verwenden. Wenn der Masterknoten ausfällt, kann der Standby-Knoten weiterhin Traffic verarbeiten.

Sie können die Master-Standby-Replikation bei der Installation mithilfe von Attributen in der Konfigurationsdatei für die unbeaufsichtigte Installation aktivieren und konfigurieren. Sie können die Master-Standby-Replikation auch nach der Installation aktivieren. Weitere Informationen finden Sie unter Master-Standby-Replikation für Postgres einrichten.

SymasLDAP 2.6.10 installieren

Für die lokale Installation ist SymasLDAP 2.6.10 erforderlich, das im apigee-thirdparty-opdk-Repository enthalten ist. Entfernen Sie vor der Installation die Bibliothek symasldap-compat.

Bei Installationen mit 13 Hosts und Installationen mit 12 Hosts mit zwei Rechenzentren ist die SymasLDAP-Replikation erforderlich, da mehrere Knoten SymasLDAP hosten.

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 im Rahmen 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 bindet, z. B. Portnummern unter 1.000, 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 Routers für den Zugriff auf Ports unter 1000 finden Sie unter Virtuellen Host einrichten.

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

Ab Version 4.52.01 gelten neue Anforderungen für die Installation. Dazu müssen die Properties QPID_MGMT_USERNAME und QPID_MGMT_PASSWORD während der Installation angegeben werden. Achten Sie darauf, dass diese Attribute mit den entsprechenden Werten in der Konfigurationsdatei hinzugefügt werden, um eine erfolgreiche Installation zu ermöglichen.

Neue Edge-Benutzeroberfläche konfigurieren

Die neue Edge-Benutzeroberfläche (Komponenten edge-management-ui und edge-management-ui-static) wird standardmäßig bei der Edge-Installation installiert. Standardmäßig wird in der New Edge-Benutzeroberfläche die einfache Authentifizierung verwendet. Sie kann aber auch für die Verwendung von Apigee SSO oder einem externen IDP wie SAML oder OIDC konfiguriert werden.

Weitere Informationen zum Konfigurieren der neuen Edge-Benutzeroberfläche finden Sie unter Neue Edge-Benutzeroberfläche konfigurieren.

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

ZooKeeper und Cassandra installieren

ld

Installieren Sie nur SymasLDAP.

mt

Installieren Sie den Edge Management Server. Dadurch wird auch SymasLDAP installiert.

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

ms

Installieren Sie den Edge Management Server. Dadurch werden auch die neue Edge-Benutzeroberfläche und SymasLDAP installiert.

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

r

Nur Edge-Router installieren.

mp

Installieren Sie nur den Edge Message Processor.

rmp

Installieren Sie Edge Router und Message Processor.

ue

Installieren Sie die neue Edge-Benutzeroberfläche (edge-management-ui und edge-management-ui-static).

qs

Installieren Sie nur den Qpid-Server.

ps

Installieren Sie nur den Postgres-Server.
pdb Nur Postgres-Datenbank installieren – wird nur bei der Installation des Apigee Developer Services-Portals (oder einfach des Portals) verwendet. Portal installieren

sax

Installieren Sie die Analysekomponenten, also Qpid und Postgres.

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

mo

Monetarisierung installieren

sa

Installieren Sie Edge eigenständig, d. h. Cassandra, ZooKeeper, Management Server, SymasLDAP, neue Edge-Benutzeroberfläche, Router und Message Processor. Bei dieser Option werden die Edge-Analysekomponenten Qpid und Postgres ausgelassen.

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

aio

Installieren Sie alle Komponenten auf einem einzelnen Knoten.

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

Installieren Sie das Portal.

Konfigurationsdatei erstellen

Die Konfigurationsdatei enthält alle Informationen, die für die Installation von Edge erforderlich sind. Sie können oft dieselbe Konfigurationsdatei verwenden, um alle Komponenten in einer Edge-Installation zu installieren.

In den folgenden Fällen müssen Sie jedoch andere Konfigurationsdateien verwenden oder Ihre Konfigurationsdatei ändern:

  • Sie installieren mehrere SymasLDAP-Server und müssen die Replikation im Rahmen einer Installation mit 13 Knoten konfigurieren. Für jede Datei sind unterschiedliche Werte für LDAP_SID und LDAP_PEER erforderlich.
  • Sie erstellen mehrere Rechenzentren im Rahmen einer Installation mit 12 Knoten. Für jedes Rechenzentrum sind unterschiedliche Einstellungen für Attribute wie ZK_CLIENT_HOSTS und CASS_HOSTS erforderlich.

Für jede der unten beschriebenen Installationstopologien wird eine Beispielkonfigurationsdatei gezeigt. Eine vollständige Referenz zur Konfigurationsdatei finden Sie unter Referenz zur Edge-Konfigurationsdatei.

Systemanforderungen testen, ohne eine Installation auszuführen

Edge for Private Cloud unterstützt das Attribut ENABLE_SYSTEM_CHECK=y, um im Rahmen einer Installation die CPU- und Arbeitsspeicheranforderungen auf einem Computer zu prüfen. In früheren Versionen von Edge mussten Sie die Installation jedoch tatsächlich durchführen, um diese Prüfung zu bestehen.

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

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

Mit diesem Befehl werden alle Fehler in Bezug auf die Systemanforderungen auf dem Bildschirm angezeigt.

Eine Liste der Systemanforderungen für alle Edge-Komponenten finden Sie unter Installationsanforderungen.

Installationsprotokolldateien

Standardmäßig schreibt das Dienstprogramm „setup.sh“ Log-Informationen zur 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 aufgeführten Installationsbeispielen wird davon ausgegangen, dass Sie Folgendes installieren:

  • Mit deaktivierter Cassandra-Authentifizierung (Standardeinstellung). Weitere Informationen finden Sie unter Cassandra-Authentifizierung aktivieren.
  • Die Master-Standby-Replikation von Postgres ist deaktiviert (Standard). 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.

Vorbereitung

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

  • Prüfen Sie die Installationsanforderungen auf Voraussetzungen und eine Liste der erforderlichen Dateien, die Sie vor der Installation benötigen. Überprüfen Sie die Anforderungen, bevor Sie mit der Installation beginnen.
  • Deaktivieren Sie SELinux oder stellen Sie es auf den permissiven Modus ein. Weitere Informationen finden Sie unter Edge-Dienstprogramm „apigee-setup“ installieren.

All-in-one-Installation

  1. Installieren Sie alle Komponenten auf einem einzelnen Knoten mit dem folgenden Befehl: 
    /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
  2. Starten Sie die New Edge-UI-Komponente nach Abschluss der Installation neu: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
  3. Testen Sie die Installation wie unter Installation testen beschrieben.
  4. Nehmen Sie Ihre Organisation auf, wie unter Organisation aufnehmen beschrieben.

Hier finden Sie ein Video zur Installation von Edge All-in-One.

Unten sehen Sie eine Konfigurationsdatei für die automatische Konfiguration für diese Topologie. Eine vollständige Referenz zur Konfigurationsdatei finden Sie unter Edge Configuration File Reference.

# 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=QPIDPass1234

Eigenständige Installation mit zwei 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 New Edge-UI-Komponente auf Knoten 1 neu: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
  4. Testen Sie die Installation wie unter Installation testen beschrieben.
  5. Nehmen Sie Ihre Organisation auf, wie unter Organisation aufnehmen beschrieben.

Unten sehen Sie eine Konfigurationsdatei für die automatische Konfiguration für diese Topologie. Eine vollständige Referenz zur Konfigurationsdatei finden Sie unter Edge Configuration File Reference.

# 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=QPIDPass1234

Installation mit 5 Knoten

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

  1. Installieren Sie den Datastore-Cluster auf den Knoten 1, 2 und 3: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Installieren Sie den Management Server auf Knoten 1: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. Installieren Sie Router und 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 New Edge-UI-Komponente auf Knoten 1 neu: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
  6. Testen Sie die Installation wie unter Installation testen beschrieben.
  7. Führen Sie das Onboarding Ihrer Organisation wie unter Organisation einrichten beschrieben durch.

Unten sehen Sie eine Konfigurationsdatei für die unbeaufsichtigte Installation für diese Topologie. Eine vollständige Referenz zur Konfigurationsdatei finden Sie unter Edge Configuration File Reference.

# 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=QPIDPass1234

Installation mit 9 Knoten im Cluster

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

  1. Installieren Sie den Datastore-Clusterknoten auf Knoten 1, 2 und 3: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Installieren Sie den Apigee Management Server auf Knoten 1: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. Installieren Sie Router und Message Processor auf den Knoten 4 und 5: 
    /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. Installieren Sie den Apigee Analytics Qpid-Server 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 Knoten 8 und 9: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. Starten Sie die New Edge-UI-Komponente auf Knoten 1 neu: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
  7. Testen Sie die Installation wie unter Installation testen beschrieben.
  8. Führen Sie das Onboarding Ihrer Organisation wie unter Organisation einrichten beschrieben durch.

Unten sehen Sie eine Konfigurationsdatei für die unbeaufsichtigte Installation 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=QPIDPass1234

Clusterinstallation mit 13 Knoten

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

Die Installationsreihenfolge für einen Cluster mit 13 Knoten sieht so aus:

  1. Installieren Sie den Datastore-Clusterknoten auf Knoten 1, 2 und 3: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Installieren Sie SymasLDAP auf den Knoten 4 und 5: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ld -f configFile
  3. Installieren Sie den Apigee Management Server auf den Knoten 6 und 7: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  4. Installieren Sie den Apigee Analytics Postgres-Server 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 Apigee Analytics Qpid-Server auf Knoten 12 und 13: 
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  7. Starten Sie die New Edge-UI-Komponente auf den Knoten 6 und 7 neu: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
  8. Testen Sie die Installation wie unter Installation testen beschrieben.
  9. Führen Sie das Onboarding Ihrer Organisation wie unter Organisation einrichten beschrieben durch.

Unten sehen Sie eine Beispielkonfigurationsdatei für die unbeaufsichtigte Installation 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 SymasLDAP 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 SymasLDAP 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=QPIDPass1234
 
# For SymasLDAP 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 SymasLDAP Server on IP4 only
MSIP=$IP6
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP5

# For the SymasLDAP 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 SymasLDAPs.
APIGEE_LDAPPW=LDAP_PASSWORD

Installation mit 12 Knoten

Bevor Sie Edge in einer Cluster-Topologie mit 12 Knoten (zwei Rechenzentren) installieren, müssen Sie wissen, wie Sie die ZooKeeper- und Cassandra-Attribute in der Konfigurationsdatei für die unbeaufsichtigte Installation festlegen.

  • 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 markieren Sie alle Knoten mit dem Modifikator :observer. Knoten ohne den Modifikator :observer werden als „Voter“ bezeichnet. Sie müssen eine ungerade Anzahl von „Wählern“ in Ihrer Konfiguration haben.

    In dieser Topologie ist der ZooKeeper-Host auf Host 9 der Observer:

    Geben Sie für das Attribut ZK_CLIENT_HOSTS für jedes Rechenzentrum die IP-Adressen oder DNS-Namen nur 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 gekennzeichnet, sodass Sie fünf Wähler haben: Knoten 1, 2, 3, 7 und 8.

  • Cassandra

    Alle Rechenzentren müssen dieselbe Anzahl von Cassandra-Knoten haben.

    Geben Sie für CASS_HOSTS für jedes Rechenzentrum alle Cassandra-IP-Adressen (nicht DNS-Namen) für beide Rechenzentren an. Listen Sie für Rechenzentrum 1 zuerst die Cassandra-Knoten in diesem Rechenzentrum auf. Listen Sie für Rechenzentrum 2 zuerst die Cassandra-Knoten in diesem Rechenzentrum auf. Listen Sie die Cassandra-Knoten in derselben 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; 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.205:2,1 192.168.124.206:2,1“

    Der erste Knoten in Rack/Verfügbarkeitszone 1 jedes Rechenzentrums wird als Seed-Server 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 den Apigee Management Server mit SymasLDAP-Replikation auf Knoten 1 und 7: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. 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
  4. Installieren Sie den Apigee Analytics Qpid-Server 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 den Knoten 6 und 12: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. Starten Sie die New Edge-UI-Komponente auf den Knoten 1 und 7 neu: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
  7. Testen Sie die Installation wie unter Installation testen beschrieben.
  8. Nehmen Sie Ihre Organisation auf, wie unter Organisation aufnehmen beschrieben.

Unten sehen Sie eine Konfigurationsdatei für die automatische Konfiguration für diese Topologie. Eine vollständige Referenz zur Konfigurationsdatei finden Sie unter Referenz zur Edge-Konfigurationsdatei.

  • Konfiguriert SymasLDAP mit Replikation über zwei SymasLDAP-Knoten hinweg.
  • Gibt den Modifikator :observer für einen ZooKeeper-Knoten an. Lassen Sie diesen Modifikator bei einer Installation in einem einzelnen Rechenzentrum 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=QPIDPass1234
 
# 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=QPIDPass1234