Edge-Komponenten auf einem Knoten installieren

Edge for Private Cloud Version 4.16.09

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

Das Dienstprogramm apigee-setup verwendet einen Befehl im folgenden Format:

> /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

Dabei ist component die zu installierende Edge-Komponente und configFile die stille Konfigurationsdatei, die die Installationsinformationen enthält. Die Konfigurationsdatei muss für den „apigee“-Benutzer zugänglich oder lesbar sein. Sie können beispielsweise ein neues Verzeichnis für die Dateien erstellen, sie im Verzeichnis /usr/local oder /usr/local/share oder an einer anderen Stelle auf dem Knoten ablegen, auf die der Nutzer „apigee“ zugreifen kann.

So installieren Sie beispielsweise den Edge-Verwaltungsserver:

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

Hinweise zur Installation

Berücksichtigen Sie beim Schreiben der Konfigurationsdatei die folgenden Optionen.

Postgres-Master-Standby-Replikation einrichten

Standardmäßig installiert Edge alle Postgres-Knoten im Mastermodus. In Produktionssystemen mit mehreren Postgres-Knoten müssen Sie diese jedoch für die Verwendung der Master-Standby-Replikation konfigurieren, damit der Standby-Knoten weiterhin Traffic bereitstellen kann, wenn der Master-Knoten ausfällt.

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

Cassandra-Authentifizierung aktivieren

Standardmäßig wird Cassandra ohne aktivierte Authentifizierung installiert. Das bedeutet, dass jeder auf Cassandra zugreifen kann. Sie können die Authentifizierung nach der Installation von Edge oder als Teil des Installationsvorgangs aktivieren.

Sie können die Cassandra-Authentifizierung als Installationszeit mithilfe von Attributen in der unbeaufsichtigten Konfigurationsdatei aktivieren. Alternativ können Sie sie nach der Installation aktivieren.

Weitere Informationen finden Sie unter Cassandra-Authentifizierung aktivieren.

Router an einen geschützten Port binden

Wenn Sie den Router an einen geschützten Port binden möchten, z. B. Portnummern unter 1024, müssen Sie ihn so konfigurieren, dass er als Nutzer mit Zugriff auf diese Ports ausgeführt wird. Standardmäßig wird der Router als Nutzer „apigee“ ausgeführt, der keinen Zugriff auf privilegierte Ports hat.

So führen Sie den Router als ein anderer Nutzer aus:

  1. Erstellen Sie als Root die Datei /opt/apigee/etc/edge-router.d/RUN_USER.sh.
  2. Fügen Sie der Datei den folgenden Eintrag hinzu:
    RUN_USER=root
    Wenn Sie den Router nicht als Root ausführen möchten, geben Sie einen Nutzer mit Zugriff auf den Port an.
  3. Speichere die Datei.
  4. Wenn Sie einen anderen Benutzer als Root angegeben haben, ändern Sie den Eigentümer der Datei in diesen Benutzer:
    > Geben Sie NUTZER:NUTZER /opt/apigee/etc/edge-router.d/RUN_USER.sh an:
  5. Router neu starten:
    > /opt/apigee/apigee-service/bin/apigee-service-Edge-Router-Neustart

Zu installierende Komponenten angeben

In der folgenden Tabelle sind die Optionen aufgeführt, die Sie an die Option -p des Dienstprogramms Apigee-Dienst übergeben, um anzugeben, welche Komponenten auf dem Knoten installiert werden sollen:

Komponente

Beschreibung

c

Installieren Sie nur Cassandra.

ZK nur ZooKeeper installieren.

ds

Installieren Sie ZooKeeper und Cassandra.

ld

Installieren Sie nur OpenLDAP.

ms

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

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

r

Installieren Sie nur Edge Router.

mp

Installieren Sie nur den Edge Message Processor.

RPM

Installieren Sie Edge Router und Message Processor.

ui

Installieren Sie die Edge-Benutzeroberfläche.

qs

Installieren Sie nur den Qpid-Server.

ps

Installieren Sie nur den Postgres-Server.

Saxofon

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

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

Monat

Monetarisierung installieren.

sa

Installieren Sie eigenständige Edge-Geräte, d. h. Cassandra, ZooKeeper, Management Server, OpenLDAP, Edge-UI, Router und Message Processor. Bei dieser Option werden die Edge-Analysekomponenten weggelassen: Qpid und Postgres.

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

Aio

Installieren Sie alle Komponenten auf einem einzelnen Knoten.

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

Konfigurationsdatei erstellen

Die Konfigurationsdatei enthält alle Informationen, die zum Installieren von Edge erforderlich sind. Häufig können Sie dieselbe Konfigurationsdatei verwenden, um alle Komponenten in einer Edge-Installation zu installieren.

Sie müssen jedoch andere Konfigurationsdateien verwenden oder die Konfigurationsdatei ändern, wenn:

  • Sie installieren mehrere OpenLDAP-Server und müssen die Replikation im Rahmen einer Installation mit 13 Knoten konfigurieren. Jede Datei erfordert unterschiedliche Werte für LDAP_SID und LDAP_PEER.
  • Sie erstellen mehrere Rechenzentren im Rahmen einer Installation mit 12 Knoten. Jedes Rechenzentrum benötigt unterschiedliche Einstellungen für Properties wie ZK_CLIENT_HOSTS und CASS_HOSTS.

Beispiel: Konfigurationsdatei

Unten sehen Sie ein Beispiel für eine vollständige Konfigurationsdatei im Hintergrund für eine Edge-Installation mit neun Knoten. Bearbeiten Sie diese Datei nach Bedarf für Ihre Konfiguration. Verwenden Sie die Option -f, um diese Datei in setup.sh aufzunehmen. Unten finden Sie außerdem Konfigurationsdateien für jede Edge-Topologie.

# IP address or DNS name of nodes.
IP1=192.168.1.1  # Management Server, OpenLDAP, UI, ZooKeeper, Cassandra
IP2=192.168.1.2  # ZooKeeper, Cassandra
IP3=192.168.1.3  # ZooKeeper, Cassandra
IP4=192.168.1.4  # Router, Message Processor
IP5=192.168.1.5  # Router, Message Processor
IP6=192.168.1.6  # Qpid
IP7=192.168.1.7  # Qpid
IP8=192.168.1.8  # Postgres
IP9=192.168.1.9  # Postgres

# Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost.
HOSTIP=$(hostname -i)

# Set Edge sys admin credentials.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=yourPassword    # If omitted, you are prompted for it.

# Location of Edge license file.
LICENSE_FILE=/tmp/license.txt

# Management Server information.
MSIP=$IP1    # IP or DNS name of Management Server node. 
# Specify the port the Management Server listens on for API calls.
# APIGEE_PORT_HTTP_MS=8080    # Default is 8080.

#
# OpenLDAP information.
#
# Set to y if you are connecting to a remote LDAP server. 
# If n, Edge installs OpenLDAP when it installs the Management Server.
USE_LDAP_REMOTE_HOST=n 

# If connecting to remote OpenLDAP server, specify the IP/DNS name and port.
# LDAP_HOST=$IP1    # IP or DNS name of OpenLDAP node.
# LDAP_PORT=10389   # Default is 10389.
APIGEE_LDAPPW=yourLdapPassword

# Specify OpenLDAP without replication, 1, or with replication, 2.
LDAP_TYPE=1 

# Set only if using replication.
# LDAP_SID=1    # Unique ID for this LDAP server. 
# LDAP_PEER=    # IP or DNS name of LDAP peer.

BIND_ON_ALL_INTERFACES=y 

# The Message Processor and Router pod.
MP_POD=gateway 

# The name of the region, corresponding to the data center name.
REGION=dc-1 # Use dc-1 unless installing in a 
            # multi-data center environment. 

# ZooKeeper information.
# See table below if installing in a multi-data center environment.
ZK_HOSTS="$IP1 $IP2 $IP3"         # IP/DNS names of all ZooKeeper nodes. 
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"  # IP/DNS names of all ZooKeeper nodes.

# Cassandra information.
CASS_CLUSTERNAME=Apigee    # Default name is Apigee.

# IP addresses of the Cassandra hosts separated by spaces.
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1"

# Set to enable Cassandra authentication.
# CASS_AUTH=y    # The default value is n.
# Cassandra uname/pword required if you enabled Cassandra authentication.
# CASS_USERNAME=
# CASS_PASSWORD=

# Use to enable Postgres master-standby replication
# when you have multiple Postgres nodes. 
# PG_MASTER=IPorDNSofNewMaster
# PG_STANDBY=IPorDNSofOldMaster

# SMTP information.
SKIP_SMTP=n       # Skip now and configure later by specifying "y".
SMTPHOST=smtp.gmail.com
SMTPUSER=your@email.com
SMTPPASSWORD=yourEmailPassword
SMTPSSL=y
SMTPPORT=465      # If no SSL, use a different port, such as 25.

Die folgende Tabelle enthält zusätzliche Informationen zu diesen Eigenschaften:

Attribut

Hinweis

IP-/DNS-Namen

Verwenden Sie keine Hostnamenzuordnung zu 127.0.0.1 oder die IP-Adresse 127.0.0.1, wenn Sie die IP-Adresse eines Knotens angeben.

ADMIN_EMAIL
APIGEE_ADMINPW

Das Passwort des Systemadministrators muss mindestens 8 Zeichen lang sein und einen Großbuchstaben, einen Kleinbuchstaben, eine Ziffer oder ein Sonderzeichen enthalten. Wenn Sie das Passwort weglassen, werden Sie aufgefordert, es einzugeben.

LICENSE_FILE

Der Speicherort der Lizenzdatei, auf die der „apigee“-Benutzer zugreifen kann. Speichern Sie sie beispielsweise im Verzeichnis „/tmp“ und mit „chmod 777“ für die Datei. Die Datei wird in das Edge-Installationsverzeichnis kopiert.

USE_LDAP_REMOTE_HOST
LDAP_HOST
LDAP_PORT

Wenn USE_LDAP_REMOTE_HOST n ist, installiert Edge automatisch OpenLDAP, wenn der Verwaltungsserver installiert wird.

Setzen Sie USE_LDAP_REMOTE_HOST auf y, wenn Sie eine Verbindung zu einem Remote-LDAP-Server herstellen. OpenLDAP ist nicht mit dem Verwaltungsserver installiert.

Wenn Sie eine Verbindung zu einem Remote-OpenLDAP-Server herstellen, verwenden Sie LDAP_HOST
und LDAP_PORT, um die IP-Adresse oder den DNS-Namen und die Portnummer des Hosts anzugeben.

LDAP_TYPE
LDAP_SID
LDAP_PEER

LDAP_TYPE=1 für OpenLDAP ohne Replikation festgelegt. LDAP_TYPE=2 entspricht OpenLDAP mit Replikation.

Wenn Ihre Edge-Topologie einen einzelnen OpenLDAP-Server verwendet, geben Sie 1 an. Wenn Ihre Edge-Installation mehrere OpenLDAP-Knoten verwendet, z. B. in einer Produktionsinstallation mit 13 Knoten, geben Sie 2 an.

Wenn Sie die Replikation aktivieren, legen Sie die folgenden Attribute fest:

  • LDAP_SID=1 – Eindeutige ID für diesen LDAP-Server. Jeder LDAP-Knoten verwendet eine andere ID. Legen Sie beispielsweise für LDAP-Peer auf 2 fest.
  • LDAP_PEER=10.0.0.1 – IP- oder DNS-Name des LDAP-Peers.

BIND_ON_ALL_INTERFACES

Wenn „y“ festgelegt ist, bindet (überwachen) der Router/Message Processor alle Schnittstellen (IPs) ab. Wenn dieser Parameter auf „n“ gesetzt ist, bindet (überwacht) der Router/Message Processor eine bestimmte Schnittstelle an die vom Befehl „hostname -i“ zurückgegebene IP-Adresse.

MP_POD

Geben Sie den Namen des Message Processor- und Router-Pods an. Standardmäßig lautet der Name „Gateway“.

REGION

Name der Region. Konventionsgemäß haben Namen in der Regel die Form dc-#, wobei # einer Ganzzahl entspricht. Zum Beispiel dc-1, dc-2 usw. Sie können dc-1 verwenden, sofern Sie nicht in einer Umgebung mit mehreren Rechenzentren installieren.

In einer Installation mit mehreren Rechenzentren lautet der Wert dc-1 oder dc-2 usw., je nachdem, welches Rechenzentrum Sie installieren. Sie sind jedoch nicht auf die Verwendung von Namen im Format dc-# beschränkt. Sie können einen beliebigen Namen für die Region verwenden.

ZK_HOSTS

Die IP-Adressen oder DNS-Namen der ZooKeeper-Knoten. Die IP-Adressen oder DNS-Namen müssen auf allen ZooKeeper-Knoten in derselben Reihenfolge aufgeführt werden.

Listen Sie in einer Umgebung mit mehreren Rechenzentren alle ZooKeeper-Knoten aus beiden Rechenzentren auf.

Geben Sie den Modifikator „:observer“ auf ZooKeeper-Knoten nur an, wenn Sie mehrere Rechenzentren erstellen, wie in einer Installation mit 12 Hosts beschrieben. In der Installation eines einzelnen Rechenzentrums können Sie diesen Modifikator weglassen. Weitere Informationen finden Sie unter Cluster-Installation mit 12 Hosts.

ZK_CLIENT_HOSTS

Die IP-Adressen oder DNS-Namen der ZooKeeper-Knoten, die von diesem Rechenzentrum verwendet werden. Die IP-Adressen oder DNS-Namen müssen auf allen ZooKeeper-Knoten in derselben Reihenfolge aufgelistet werden.

In einer Installation eines einzelnen Rechenzentrums sind dies dieselben Knoten, die von ZK_HOSTS angegeben werden.

Listen Sie in einer Umgebung mit mehreren Rechenzentren nur die ZooKeeper-Knoten in diesem Rechenzentrum auf. Weitere Informationen finden Sie unter Cluster-Installation mit 12 Hosts.

CASS_HOSTS

Die IP-Adressen (nicht die DNS-Namen) der Cassandra-Knoten. Die ersten beiden Knoten werden als Startserver verwendet. Die IP-Adressen müssen auf allen Cassandra-Knoten in der gleichen Reihenfolge aufgelistet werden.

Cassandra-Knoten können das optionale Suffix „:dc,ra“ haben, das das Rechenzentrum und das Rack des Cassandra-Knotens angibt. Geben Sie diesen Modifikator nur an, wenn Sie mehrere Rechenzentren erstellen, wie in einer Installation mit 12 Hosts beschrieben. Bei der Installation eines einzelnen Rechenzentrums lassen Sie diesen Modifikator weg.

Beispiel: 192.168.124.201:1,1 = Rechenzentrum 1 und Rack/Verfügbarkeitszone 1 und '192.168.124.204:2,1 = Rechenzentrum 2 und Rack/Verfügbarkeitszone 1.

In einer Umgebung mit mehreren Rechenzentren müssen CASS_HOSTS zur Beseitigung von Firewallproblemen so angeordnet werden (wie im obigen Beispiel gezeigt), dass die Knoten des aktuellen Rechenzentrums am Anfang platziert werden. Weitere Informationen finden Sie unter Cluster-Installation mit 12 Hosts.

CASS_AUTH
CASS_NUTZERNAME

CASS_PASSWORD

Wenn Sie die Cassandra-Authentifizierung (CASS_AUTH=y) aktivieren, können Sie den Cassandra-Nutzernamen und das Passwort mithilfe dieser Attribute übergeben.

PG_MASTER

PG_STANDBY

Legen Sie fest, dass die Postgres-Master-Standby-Replikation im folgenden Format aktiviert wird:

PG_MASTER=IPorDNSofNewMaster

PG_STANDBY=IPorDNSofOldMaster

SKIP_SMTP
SMTPHOST
SMTPUSER
SMTPPASSWORT
SMTPSSL
SMTPPORT

Konfigurieren Sie SMTP, damit Edge E-Mails bei verlorenen Passwörtern und andere Benachrichtigungen senden kann.

Wenn die SMTP-Nutzeranmeldedaten nicht erforderlich sind, lassen Sie SMTPUSER und SMTPPASSWORT weg.

Reihenfolge der Komponenteninstallation

Die Reihenfolge der Komponenteninstallation richtet sich nach der gewünschten Topologie.

Im folgenden Beispiel wird davon ausgegangen, dass Sie Folgendes installieren:

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

Installationsprotokolldateien

Standardmäßig schreibt das Dienstprogramm „setup.sh“ Protokollinformationen über die Installation in:

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

Wenn der Nutzer, der das Dienstprogramm setup.sh ausführt, keinen Zugriff auf dieses Verzeichnis hat, wird das Log in das Verzeichnis /tmp als Datei namens setup_username.log geschrieben.

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

All-in-one-Installation

  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. Testen Sie die Installation wie unter Installation testen beschrieben.
  3. Onboarding Ihrer Organisation wie unter Organisation aufnehmen beschrieben.

Unten sehen Sie eine Konfigurationsdatei im Hintergrund dieser Topologie:

# With SMTP
IP1=IPorDNSnameOfNode
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
LDAP_TYPE=1
APIGEE_LDAPPW=secret
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway
REGION=dc-1
ZK_HOSTS="$IP1"
ZK_CLIENT_HOSTS="$IP1"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1"
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd    
# omit for no password
SMTPSSL=n
SMTPPORT=25

Eigenständige Installation mit 2 Hosts

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

  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. Testen Sie die Installation wie unter Installation testen beschrieben.
  4. Onboarding Ihrer Organisation wie unter Organisation aufnehmen beschrieben.

Unten sehen Sie eine Konfigurationsdatei im Hintergrund dieser Topologie:

# With SMTP
IP1=IPorDNSnameOfNode1
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
LDAP_TYPE=1
APIGEE_LDAPPW=secret
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway
REGION=dc-1
ZK_HOSTS="$IP1"
ZK_CLIENT_HOSTS="$IP1"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1"
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd    
# omit for no password
SMTPSSL=n
SMTPPORT=25

Clusterinstallation mit 5 Hosts

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

  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 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 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. Testen Sie die Installation wie unter Installation testen beschrieben.
  6. Onboarding Ihrer Organisation wie unter Organisation aufnehmen beschrieben.

Unten sehen Sie eine Konfigurationsdatei im Hintergrund dieser Topologie:

# With SMTP
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP4=IPorDNSnameOfNode4
IP5=IPorDNSnameOfNode5
 HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com 
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt 
MSIP=$IP1 
USE_LDAP_REMOTE_HOST=n 
LDAP_TYPE=1
APIGEE_LDAPPW=secret 
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway
REGION=dc-1 
ZK_HOSTS="$IP1 $IP2 $IP3" 
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" 
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1 $IP2 $IP3" 
PG_MASTER=$IP4
PG_STANDBY=$IP5
SKIP_SMTP=n
SMTPHOST=smtp.example.com 
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd       
# omit for no password 
SMTPSSL=n
SMTPPORT=25

Geclusterte Installation mit 9 Hosts

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

  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 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. Testen Sie die Installation wie unter Installation testen beschrieben.
  7. Onboarding Ihrer Organisation wie unter Organisation aufnehmen beschrieben.

Unten sehen Sie eine Konfigurationsdatei im Hintergrund dieser Topologie:

# With SMTP
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com 
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt 
MSIP=$IP1 
USE_LDAP_REMOTE_HOST=n 
LDAP_TYPE=1
APIGEE_LDAPPW=secret 
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway
REGION=dc-1 
ZK_HOSTS="$IP1 $IP2 $IP3" 
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" 
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1 $IP2 $IP3" 
SKIP_SMTP=n
PG_MASTER=$IP8
PG_STANDBY=$IP9
SMTPHOST=smtp.example.com 
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd       
# omit for no password
SMTPSSL=n
SMTPPORT=25

Geclusterte Installation mit 13 Hosts

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

  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 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 den Knoten 12 und 13:
    > /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  7. Testen Sie die Installation wie unter Installation testen beschrieben.
  8. Onboarding Ihrer Organisation wie unter Organisation aufnehmen beschrieben.

Unten sehen Sie eine Konfigurationsdatei im Hintergrund dieser Topologie:

# For all components except OpenLDAP
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP4=IPorDNSnameOfNode4
IP5=IPorDNSnameOfNode5
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com 
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt 
# First Management Server on IP6
MSIP=$IP6 
USE_LDAP_REMOTE_HOST=y
LDAP_HOST=$IP4
LDAP_PORT=10389
# Second Management Server on IP7
# MSIP=$IP7
# USE_LDAP_REMOTE_HOST=y
# LDAP_HOST=$IP5
# LDAP_PORT=10389
# Same password for both OpenLDAPs.
APIGEE_LDAPPW=secret 
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway
REGION=dc-1 
ZK_HOSTS="$IP1 $IP2 $IP3" 
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" 
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1 $IP2 $IP3" 
PG_MASTER=$IP8
PG_STANDBY=$IP9
SKIP_SMTP=n
SMTPHOST=smtp.example.com 
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd       
# omit for no password
SMTPSSL=n
SMTPPORT=25
# For OpenLDAP on IP4 and IP5
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP4=IPorDNSnameOfNode4
IP5=IPorDNSnameOfNode5
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com 
APIGEE_ADMINPW=Secret123
# First OpenLDAP Server on IP4
MSIP=$IP6 
USE_LDAP_REMOTE_HOST=n 
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP5
# Second OpenLDAP Server on IP5
# MSIP=$IP7 
# USE_LDAP_REMOTE_HOST=n 
# LDAP_TYPE=2
# LDAP_SID=2
# LDAP_PEER=$IP4
# Set same password for both OpenLDAPs.
APIGEE_LDAPPW=secret 

Clusterinstallation mit 12 Hosts

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

  • ZooKeeper

    Geben Sie für die ZK_HOSTS-Property für beide Rechenzentren die IP-Adressen oder DNS-Namen aller ZooKeeper-Knoten aus beiden Rechenzentren in derselben Reihenfolge an und kennzeichnen Sie alle Knoten mit dem Modifikator „:observer“. Knoten ohne den Modifikator „:observer“ werden als „voters“ bezeichnet. Ihre Konfiguration muss eine ungerade Anzahl von Abstimmen enthalten.

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

    Geben Sie für die ZK_CLIENT_HOSTS-Property für jedes Rechenzentrum die IP-Adressen oder DNS-Namen der ZooKeeper-Knoten im Rechenzentrum in derselben Reihenfolge für alle ZooKeeper-Knoten im Rechenzentrum an. In der unten gezeigten Beispielkonfigurationsdatei ist Knoten 9 mit dem Modifikator „:observer“ getaggt, sodass Sie fünf Voter haben: Knoten 1, 2, 3, 7 und 8.
  • Cassandra
    Alle Rechenzentren müssen die gleiche Anzahl von Cassandra-Knoten haben.

    Achten Sie darauf, dass Sie für CASS_HOSTS für jedes Rechenzentrum alle Cassandra-IP-Adressen (nicht DNS-Namen) für beide Rechenzentren angeben. Für Rechenzentrum 1 listen Sie zuerst die Cassandra-Knoten in diesem Rechenzentrum auf. Für Rechenzentrum 2 listen Sie zuerst die Cassandra-Knoten in diesem Rechenzentrum auf. Listen Sie die Cassandra-Knoten für alle Cassandra-Knoten im Rechenzentrum in der gleichen Reihenfolge auf.

    Alle Cassandra-Knoten müssen das Suffix „:<d>,<r>“ haben, z. B. „<ip>:1,1 = Rechenzentrum 1 und Rack-/Verfügbarkeitszone 1 und <ip>:2,1 = Rechenzentrum 2 und Rack-/Verfügbarkeitszone 1.
    Beispiel: "192.168.124.201:1,1 192.168.124.202:1,1 192.168.124.203:1,1 192.168.124.204:2,1 192.168.12.1 192.168.12.1 192.168.12.



    In diesem Bereitstellungsmodell sieht die Cassandra-Einrichtung so aus:

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

  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 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 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. 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. Beachten Sie, dass diese Konfigurationsdatei:

  • Konfiguriert OpenLDAP mit Replikation über zwei OpenLDAP-Knoten.
  • Gibt den Modifikator „:observer“ für einen ZooKeeper-Knoten an. In der Installation eines einzelnen Rechenzentrums können Sie diesen Modifikator weglassen.
# Datacenter 1
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9 
IP12=IPorDNSnameOfNode12
HOSTIP=$(hostname -i)
MSIP=$IP1
ADMIN_EMAIL=opdk@apigee.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP7
APIGEE_LDAPPW=secret
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway-1
REGION=dc-1
ZK_HOSTS="$IP1 $IP2 $IP3 $IP7 $IP8 $IP9:observer"
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1 $IP7:2,1 $IP8:2,1 $IP9:2,1"
PG_MASTER=$IP6
PG_STANDBY=$IP12
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com 
# omit for no username
SMTPPASSWORD=smtppwd   
# omit for no password
SMTPSSL=n
SMTPPORT=25
# Datacenter 2
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9 
IP12=IPorDNSnameOfNode12
HOSTIP=$(hostname -i)
MSIP=$IP7
ADMIN_EMAIL=opdk@apigee.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=2
LDAP_PEER=$IP1
APIGEE_LDAPPW=secret
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway-2
REGION=dc-2
ZK_HOSTS="$IP1 $IP2 $IP3 $IP7 $IP8 $IP9:observer"
ZK_CLIENT_HOSTS="$IP7 $IP8 $IP9"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP7:2,1 $IP8:2,1 $IP9:2,1 $IP1:1,1 $IP2:1,1 $IP3:1,1"
PG_MASTER=$IP6
PG_STANDBY=$IP12
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com 
# omit for no username
SMTPPASSWORD=smtppwd   
# omit for no password
SMTPSSL=n
SMTPPORT=25