Edge-Komponenten auf einem Knoten installieren

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

Das apigee-setup-Dienstprogramm 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 Silent-Konfigurationsdatei mit den Installationsinformationen. 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 und sie im Verzeichnis „/usr/local“ oder „/usr/local/share“ oder an einem anderen Ort auf dem Knoten ablegen, auf den 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 zum Installieren von Edge apigee-setup finden Sie unter Installieren Sie das Hilfsprogramm für das Edge-Apigee-Setup.

Hinweise zur Installation

Berücksichtigen Sie beim Erstellen 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 sie jedoch so konfigurieren, dass die Master-Standby-Replikation verwendet wird. Andernfalls kann der Standby-Knoten bei einem Ausfall des Masterknotens nicht fortfahren und den Serververkehr verarbeiten.

Sie können die Master-Standby-Replikation bei der Installation mithilfe von Eigenschaften in der Silent-Konfigurationsdatei 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.

openldap 2.4 unter RHEL 9.X/Rocky 9.X/Oracle 9.X

Für die Installation vor Ort ist OpenLDAP 2.4 erforderlich. Dieses ist im apigee-thirdparty-opdk-Repository enthalten. Entferne die openldap-compat-Bibliothek, um die Installation zu vereinfachen.

Bei Installationen mit 13 Hosts und 12 Hosts mit zwei Rechenzentren ist eine OpenLDAP-Replikation erforderlich, da es mehrere Knoten gibt, die OpenLDAP 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 der Installation aktivieren.

Weitere Informationen finden Sie unter Cassandra-Authentifizierung aktivieren.

Einen 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. an 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 1.000 finden Sie unter Virtuellen Host einrichten.

Neue Anforderungen, die durch apigee-qpidd-4.52.01-X.X.X eingeführt wurden

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

Neue Edge-Benutzeroberfläche installieren

Nachdem Sie die Erstinstallation abgeschlossen haben, empfiehlt Apigee die Installation der neuen Edge-Benutzeroberfläche. Diese ist eine verbesserte Benutzeroberfläche für Entwickler und Administratoren von Apigee Edge für Private Cloud. Die klassische Benutzeroberfläche ist 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 nur ZooKeeper.

ds

Installieren Sie ZooKeeper und Cassandra.

ld

Installieren Sie nur OpenLDAP.

mt

Installieren Sie Edge Management Server, um auch OpenLDAP zu installieren.

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.

ms

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

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.

rmp

Installieren Sie den Edge-Router und den Message Processor.

ui

Installieren Sie die Edge-Benutzeroberfläche.

qs

Installieren Sie nur den Qpid-Server.

ps

Installieren Sie nur den Postgres-Server.
pdb Nur Postgres-Datenbank installieren – nur bei der Installation des Apigee Developer Services-Portals (oder einfach des Portals) verwenden. Weitere Informationen finden Sie unter Portal installieren.

sax

Installieren Sie die Analysekomponenten, also Qpid und Postgres.

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

mo

Installieren Sie die Monetarisierung.

sa

Installieren Sie Edge als eigenständigen Dienst, d. h. Cassandra, ZooKeeper, Management Server, OpenLDAP, Edge-Benutzeroberfläche, Router und Message Processor. Bei dieser Option werden die Edge-Analysekomponenten Qpid und Postgres nicht berücksichtigt.

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

aio

Installieren Sie alle Komponenten auf einem einzigen Knoten.

Verwenden Sie diese Option nur für die Entwicklung und 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 häufig dieselbe Konfigurationsdatei verwenden, um alle Komponenten in einer Edge-Installation zu installieren.

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

  • Sie installieren mehrere OpenLDAP-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 12-Knoten-Installation. Jedes Rechenzentrum erfordert andere Einstellungen für Attribute wie ZK_CLIENT_HOSTS und CASS_HOSTS.

Für jede unten beschriebene Installationstopologie wird eine Beispielkonfigurationsdatei für diese Topologie angezeigt. Eine vollständige Referenz zur Konfigurationsdatei finden Sie unter Edge-Konfigurationsdateireferenz.

Systemanforderungen testen, ohne eine Installation auszuführen

Edge für die Private Cloud unterstützt das Attribut ENABLE_SYSTEM_CHECK=y, um die CPU- und Arbeitsspeicheranforderungen auf einer Maschine im Rahmen einer Installation zu prüfen. Bei früheren Versionen von Edge musste die Installation jedoch durchgeführt werden, um diese Prüfung durchzuführen.

Sie können diese Prüfung jetzt mit dem Flag „-t“ durchführen, ohne eine Installation ausführen zu müssen. Wenn Sie beispielsweise die Systemanforderungen für eine „aio“-Installation prüfen möchten, ohne die Installation 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 im Zusammenhang mit den 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“ Protokollinformationen zur Installation an folgende Stelle:

/opt/apigee/var/log/apigee-setup/setup.log

Wenn der Nutzer, der das setup.sh-Dienstprogramm ausführt, keinen Zugriff auf dieses Verzeichnis hat, wird das Protokoll 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 folgenden Installationsbeispielen wird davon ausgegangen, dass Sie Folgendes installieren:

  • Mit deaktivierter Cassandra-Authentifizierung (Standardeinstellung). Weitere Informationen finden Sie unter Cassandra-Authentifizierung aktivieren.
  • Die Postgres-Master-Standby-Replikation ist deaktiviert (Standard). Weitere Informationen finden Sie unter Master-Standby-Replikation für Postgres einrichten.
  • Message Processor und Router befinden sich auf demselben Knoten. Wenn Sie die Message Processor und Router auf verschiedenen Knoten installieren, installieren Sie zuerst alle Message Processor und dann alle Router.

Vorbereitung

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

  • In den Installationsanforderungen finden Sie Informationen zu den Voraussetzungen und eine Liste der erforderlichen Dateien, die Sie herunterladen müssen, bevor Sie mit der Installation fortfahren können. Lesen Sie sich die Anforderungen durch, bevor Sie mit der Installation beginnen.
  • Deaktivieren Sie SELinux oder stellen Sie es auf den permissiven Modus. Weitere Informationen finden Sie unter Installieren Sie das Hilfsprogramm für das Edge-Apigee-Setup.

Komplette Installation

  1. Alle Komponenten mit dem Befehl auf einem einzelnen Knoten installieren: 
    /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. Richten Sie Ihre Organisation wie unter An Bord einer Organisation beschrieben ein.

In diesem Video sehen Sie eine All-in-One-Installation von Edge.

Unten sehen Sie eine Datei für eine stille Konfiguration 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=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 Komponente der klassischen Benutzeroberfläche 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. Richten Sie Ihre Organisation wie unter An Bord einer Organisation beschrieben ein.

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

# 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. 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. Router und Message Processor auf Knoten 2 und 3 installieren: 
    /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 Benutzeroberfläche 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. Richten Sie Ihre Organisation wie unter An Bord einer Organisation beschrieben ein.

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

# 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

Clusterinstallation mit 9 Knoten

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-Verwaltungsserver auf Knoten 1: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. Router und Message Processor auf Knoten 4 und 5 installieren: 
    /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 klassische UI-Komponente 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. Richten Sie Ihre Organisation wie unter An Bord einer Organisation beschrieben ein.

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

# 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 ist so:

  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 OpenLDAP auf Knoten 4 und 5: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ld -f configFile
  3. Installieren Sie den Apigee-Verwaltungsserver 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 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 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. Nehmen Sie Ihre Organisation wie unter Organisation einrichten beschrieben auf.

Unten sehen Sie eine Datei für eine stille Konfiguration als Beispiel für diese Topologie. Eine vollständige Referenz zur Konfigurationsdatei finden Sie unter Edge-Konfigurationsdateireferenz.

# 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=QPIDPass1234
 
# 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 Sie die ZooKeeper- und Cassandra-Eigenschaften in der Silent-Konfigurationsdatei festlegen.

  • ZooKeeper

    Geben Sie für die Eigenschaft 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 „with:observer“. Knoten ohne den :observer-Modifikator werden als „Wähler“ bezeichnet. In Ihrer Konfiguration muss eine ungerade Anzahl von „Wählern“ vorhanden sein.

    In 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 aller ZooKeeper-Knoten im Rechenzentrum in derselben Reihenfolge an. In der Beispielkonfigurationsdatei unten ist Knoten 9 mit dem Modifikator :observer getaggt, sodass es fünf Stimmen gibt: 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 (keine 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 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.160.122.192.160.122.192.160.122.12.160.122.1

    Der erste Knoten im Rack/in der 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 den Apigee-Verwaltungsserver 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 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 Knoten 6 und 12: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. Starten Sie die Komponente der klassischen Benutzeroberfläche 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. Richten Sie Ihre Organisation wie unter An Bord einer Organisation beschrieben ein.

Unten sehen Sie eine Silent-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. Bei einer Installation in einem einzelnen Rechenzentrum ist dieser Modifikator nicht erforderlich.
# 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