Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Edge-Komponenten auf einem Knoten installieren

Edge for Private Cloud v. 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 Konfigurationsdatei für die unbeaufsichtigte Installation, die die Installationsinformationen enthält. 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

Ü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 Master-Knoten ausfällt, kann der Standby-Knoten dann 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.

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.

Sie können die Cassandra-Authentifizierung während der Installation aktivieren, indem Sie Attribute in der Konfigurationsdatei für die unbeaufsichtigte Installation verwenden. Alternativ kannst du es auch 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 kleiner als 1024, 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.

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

Erstellen Sie als Root die Datei /opt/apigee/etc/edge-router.d/RUN_USER.sh.
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.
Speichern Sie die Datei.
Wenn Sie einen anderen Nutzer als „root“ angegeben haben, ändern Sie den Inhaber der Datei in diesen Nutzer:
> chown USER:USER /opt/apigee/etc/edge-router.d/RUN_USER.sh
Starten Sie den Router neu:
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart

Zu installierende Komponenten angeben

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

Komponente	Beschreibung
c	Installieren Sie nur Cassandra.
zk	nur ZooKeeper installieren.
ds	ZooKeeper und Cassandra installieren
ld	Installieren Sie nur OpenLDAP.
ms	Installieren Sie den Edge Management Server, 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 Management Server verwendet OpenLDAP, das auf einem anderen Knoten installiert ist.
r	Installieren Sie nur Edge Router.
mp	Installieren Sie nur den Edge Message Processor.
rmp	Installieren Sie Edge Router und Message Processor.
ui	Installieren Sie die Edge-Benutzeroberfläche.
qs	Installieren Sie nur den Qpid-Server.
ps	Installieren Sie nur den Postgres-Server.
sax	Installieren Sie die Analysekomponenten, d. h. Qpid und Postgres. Verwenden Sie diese Option nur für die Entwicklung und für Tests, nicht für die Produktion.
Monat	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 Qpid und Postgres weggelassen. Verwenden Sie diese Option nur für die Entwicklung und für Tests, 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.

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 den folgenden Fällen müssen Sie jedoch andere 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 Installation mit 12 Knoten. Für jedes Rechenzentrum sind unterschiedliche Einstellungen für Attribute wie ZK_CLIENT_HOSTS und CASS_HOSTS erforderlich.

Beispiel: Konfigurationsdatei

Im Folgenden finden Sie ein Beispiel für eine vollständige Konfigurationsdatei für die unbeaufsichtigte Installation einer Edge-Installation mit 9 Knoten. Bearbeiten Sie diese Datei nach Bedarf für Ihre Konfiguration. Verwenden Sie die Option -f für setup.sh, um diese Datei einzubinden. Unten finden Sie auch Beispielkonfigurationsdateien 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 Attributen:

Attribut	Hinweis
IP-/DNS-Namen	Verwenden Sie bei der Angabe der IP-Adresse eines Knotens keinen Hostnamen, der 127.0.0.1 zugeordnet ist, oder die IP-Adresse 127.0.0.1.
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 dazu aufgefordert.
LICENSE_FILE	Der Speicherort der Lizenzdatei, auf die der „apigee“-Nutzer zugreifen können muss. Speichern Sie sie beispielsweise im Verzeichnis „/tmp“ und führen Sie „chmod 777“ für die Datei aus. 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 OpenLDAP automatisch, wenn der Management Server installiert wird. Legen Sie USE_LDAP_REMOTE_HOST auf y fest, wenn Sie eine Verbindung zu einem Remote-LDAP-Server herstellen. OpenLDAP wird nicht mit dem Management Server 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	Legen Sie LDAP_TYPE=1 für OpenLDAP ohne Replikation fest. 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 „2“ für den LDAP-Peer fest. LDAP_PEER=10.0.0.1 – IP-Adresse oder DNS-Name des LDAP-Peers.
BIND_ON_ALL_INTERFACES	Wenn „y“ festgelegt ist, binden (lauschen) Router/Message Processor an alle Schnittstellen (IPs). Wenn der Wert auf „n“ gesetzt ist, wird der Router/Message Processor an eine bestimmte Schnittstelle gebunden (hört auf diese), 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 # einem ganzzahligen Wert entspricht. Beispiel: dc-1, dc-2 usw. Sie können dc-1 verwenden, es sei denn, Sie installieren in einer Umgebung mit mehreren Rechenzentren. In einer Installation mit mehreren Rechenzentren ist der Wert dc-1 oder dc-2 usw., je nachdem, welches Rechenzentrum Sie installieren. Sie sind jedoch nicht darauf beschränkt, nur Namen im Format dc-# zu verwenden. 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 sein. Listen Sie in einer Umgebung mit mehreren Rechenzentren alle ZooKeeper-Knoten aus beiden Rechenzentren auf. Geben Sie den Modifikator „:observer“ nur dann für ZooKeeper-Knoten an, wenn Sie mehrere Rechenzentren erstellen, wie in einer Installation mit 12 Hosts beschrieben. Lassen Sie diesen Modifikator bei einer Installation in einem einzelnen Rechenzentrum weg. Weitere Informationen finden Sie unter Clusterinstallation 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 aufgeführt sein. In einer Installation mit einem einzelnen Rechenzentrum 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 Clusterinstallation mit 12 Hosts.
CASS_HOSTS	Die IP-Adressen (nicht DNS-Namen) der Cassandra-Knoten. Die ersten beiden Knoten werden als Seed-Server verwendet. Die IP-Adressen müssen auf allen Cassandra-Knoten in derselben Reihenfolge aufgeführt sein. Cassandra-Knoten können ein optionales 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. Lassen Sie diesen Modifikator bei einer Installation in einem einzelnen Rechenzentrum 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 so angeordnet werden (wie im obigen Beispiel gezeigt), dass die Knoten des aktuellen Rechenzentrums am Anfang platziert werden, um Firewallprobleme zu beheben. Weitere Informationen finden Sie unter Clusterinstallation mit 12 Hosts.
CASS_AUTH CASS_USERNAME CASS_PASSWORD	Wenn Sie die Cassandra-Authentifizierung aktivieren (CASS_AUTH=y), können Sie den Cassandra-Nutzernamen und das Passwort mit diesen Attributen übergeben.
PG_MASTER PG_STANDBY	Legen Sie die Postgres-Master-Standby-Replikation im folgenden Format fest: PG_MASTER=*IPorDNSofNewMaster* PG_STANDBY=*IPorDNSofOldMaster*
SKIP_SMTP SMTPHOST SMTPUSER SMTPPASSWORD SMTPSSL SMTPPORT	Konfigurieren Sie SMTP, damit Edge E-Mails für verlorene Passwörter und andere Benachrichtigungen senden kann. Wenn keine SMTP-Nutzeranmeldedaten erforderlich sind, lassen Sie SMTPUSER und SMTPPASSWORD weg.

Reihenfolge der Komponenteninstallation

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.
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“ Loginformationen 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 Dienstprogramm setup.sh fehl.