Edge-Konfigurationsdatei-Referenz

Unten sehen Sie ein Beispiel für eine vollständige Konfigurationsdatei für einen Edge-Edge mit 9 Knoten im Hintergrund. Installation. Bearbeiten Sie diese Datei nach Bedarf für Ihre Konfiguration. Option -f verwenden an setup.sh, um diese Datei aufzunehmen. Beispiele für Konfigurationsdateien, die spezifisch für jede Topologie, finden Sie Edge-Komponenten installieren

# IP address or DNS name of nodes.
IP1=192.168.1.1  # Management Server, OpenLDAP, UI, ZooKeeper, Cassandra (IP address only; do not use a DNS name)
IP2=192.168.1.2  # ZooKeeper, Cassandra (IP address only; do not use a DNS name)
IP3=192.168.1.3  # ZooKeeper, Cassandra (IP address only; do not use a DNS name)
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)

# Specify "y" to check that the system meets the CPU and memory requirements
# for the component being installed. See Installation Requirements for requirements
# for each component. The default value is "n" to disable check.
ENABLE_SYSTEM_CHECK=n

# When "hostname -i" returns multiple IP addresses,
# set to "y", to have the installer prompt you to select the IP address to use.
ENABLE_DYNAMIC_HOSTIP=n

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

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

# If you are using region names other than dc-1, dc-2 etc, set this property to map your region
# name to the appropriate dc-x format region name. This property is required by Management server
# to appropriately register Cassandra data stores based on Cassandra's data centers and regions.
REGION_MAPPING="<custom-region-1>:dc-1 <custom-region-2>:dc-2 ... <custom-region-x>:dc-x"

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

# Space-separated IP addresses of the Cassandra hosts (previously defined; do not use DNS names)
# Syntax is: IP_address:host_number,rack_number
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=''

# Postgres username and password as set when you installed Edge.
# Default is apigee:postgres.
PG_USER=apigee
PG_PWD=postgres

# 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.
SMTPMAILFROM="My Company <myco@company.com>"

# The following four properties are only effective for Management server:
# Cassandra JMX uname/pword required if you enabled Cassandra JMX authentication.
# CASS_JMX_USERNAME =
# CASS_JMX_PASSWORD =

# Cassandra JMX SSL truststore details if you have enabled SSL based JMX in Cassandra.
# JMX Truststore file should be readable by Apigee user
# CASS_JMX_TRUSTSTORE =
# CASS_JMX_TRUSTSTORE_PASS =

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 eine IP-Adresse von 127.0.0.1, wenn und gibt die IP-Adresse eines Knotens an.

Beachten Sie, dass für Cassandra-Hostdefinitionen nur IP-Adressen verwendet werden. DNS nicht verwenden Namen.

ENABLE_SYSTEM_CHECK

Wenn der Wert auf „y“ gesetzt ist, überprüfen Sie, ob das System die CPU- und Speicheranforderungen für die Komponente erfüllt. installiert wird. Siehe Installation Anforderungen für die einzelnen Komponenten.

Der Standardwert ist „n“. um die Prüfung zu deaktivieren.

ENABLE_DYNAMIC_HOSTIP

Wenn ein Server mehrere Schnittstellenkarten hat, gibt der „hostname -i“ gibt den Befehl einer durch Leerzeichen getrennten Liste von IP-Adressen. Standardmäßig verwendet das Edge-Installationsprogramm die erste IP-Adresse Adresse zurückgegeben, die möglicherweise nicht in allen Fällen korrekt ist. Als Alternative können Sie können Sie die folgende Eigenschaft in der Konfigurationsdatei für die Installation festlegen.

Wenn „y“ festgelegt ist, werden Sie vom Installationsprogramm aufgefordert, die IP-Adresse auszuwählen, die im installieren. Der Standardwert ist „n“.

ADMIN_EMAIL
APIGEE_ADMINPW

Das Passwort des Systemadministrators muss mindestens 8 Zeichen lang sein und ein Passwort enthalten. Großbuchstabe, ein Kleinbuchstaben, eine Ziffer oder ein Sonderzeichen. Wenn Sie das Passwort eingeben, werden Sie dazu aufgefordert.

Nach Abschluss der Installation empfiehlt Apigee, das Passwort von der Konfigurationsdatei.

LICENSE_FILE

Der Speicherort der Lizenzdatei, auf den der „apigee“ zugreifen muss Nutzer. Speichern Sie ihn beispielsweise im Verzeichnis „/tmp“ und in der Datei „chmod 777“. Die Datei wird kopiert in das Edge-Installationsverzeichnis.

APIGEE_LDAPPW

Gibt das OpenLDAP-Passwort an.

Nach Abschluss der Installation empfiehlt Apigee, das Passwort von der Konfigurationsdatei.

USE_LDAP_REMOTE_HOST
LDAP_HOST
LDAP_PORT

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

Setzen Sie USE_LDAP_REMOTE_HOST gegebenenfalls auf „Y“. Verbindung zu einem Remote-LDAP-Server herstellen OpenLDAP ist nicht zusammen mit dem Management-Tool installiert. Server.

Wenn Sie eine Verbindung zu einem Remote-OpenLDAP-Server herstellen, verwenden Sie LDAP_HOST und LDAP_PORT zum Angeben der IP-Adresse oder DNS-Name und Portnummer des Hosts.

LDAP_TYPE
LDAP_SID
LDAP_PEER

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

Wenn Ihre Edge-Topologie einen einzelnen OpenLDAP-Server verwendet, geben Sie 1 an. Wenn Ihr Edge die Installation mehrere OpenLDAP-Knoten verwendet, wie z. B. bei einer Produktionsinstallation mit 13 Knoten, Geben Sie eine 2 an.

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

  • LDAP_SID=1 – Eindeutig ID für diesen LDAP-Server. Jeder LDAP-Knoten verwendet eine andere ID. Legen Sie beispielsweise für LDAP-Peer.
  • LDAP_PEER=10.0.0.1 – IP- oder DNS-Name des LDAP-Peers.
MP_POD Geben Sie den Namen des Nachrichtenprozessors und des Router-Pods an. Standardmäßig lautet der Name Gateway
REGION

Name der Region. Konventionsgemäß haben Namen in der Regel das Format "dc-#", wobei # entspricht in einen ganzzahligen Wert. Zum Beispiel dc-1, dc-2 usw. Sie können dc-1 verwenden, sofern die Installation in in einer Umgebung mit mehreren Rechenzentren.

In einer Installation mit mehreren Rechenzentren ist der Wert dc-1 oder dc-2 usw. welches Rechenzentrum Sie installieren. Sie können jedoch nicht nur Namen verwenden. im Format dc-#. Sie können einen beliebigen Namen für die Region verwenden.

REGION_MAPPING

Wenn Sie andere Regionsnamen als dc-1, dc-2 usw. verwenden, legen Sie diese Eigenschaft auf „map“ fest. in den entsprechenden Regionsnamen im dc-x-Format umwandeln. Diese Eigenschaft ist vom Verwaltungsserver erforderlich, um Cassandra-Daten richtig zu registrieren basierend auf den Rechenzentren und Regionen von Cassandra.

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 aufgelistet werden.

Verwenden Sie für HOSTIP dasselbe Format wie für ZK_HOSTS. Wenn Sie also Geben Sie die IP-Adresse für ZK_HOSTS an. Verwenden Sie eine IP-Adresse für HOSTIP. Wenn Sie ein DNS verwenden, verwenden Sie für beide einen DNS-Namen.

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

„:observer“ angeben für ZooKeeper-Knoten nur dann verwenden, wenn Erstellung mehrerer Rechenzentren wie bei einer Installation mit 12 Hosts beschrieben. In einem einzelnen Datenelement in der Mitte platzieren, lassen Sie diesen Modifikator weg. Weitere Informationen finden Sie unter Cluster mit 12 Hosts.

ZK_CLIENT_HOSTS

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

Verwenden Sie für HOSTIP dasselbe Format wie für ZK_CLIENT_HOSTS. Das heißt: Wenn Sie die IP-Adresse für ZK_CLIENT_HOSTS angeben, verwenden Sie eine IP-Adresse Adresse für HOSTIP. Wenn ein DNS und dann für beide einen DNS-Namen.

In einer einzelnen Rechenzentrumsinstallation sind dies dieselben Knoten, ZK_HOSTS

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

CASS_CLUSTERNAME Geben Sie optional den Namen des Cassandra-Clusters an. Der Standardname lautet „Apigee“.
CASS_HOSTS

Gibt eine durch Kommas getrennte Liste von Cassandra-Knoten an Host-IP-Adressen (keine DNS-Namen), und optional die Nummer des Rechenzentrums Rack, zu dem sie gehören.

Für Produktionstopologien muss diese Liste mindestens drei Knoten enthalten. Die erste Zwei Knoten werden als „Startserver“ verwendet. Daher müssen die IP-Adressen im in derselben Reihenfolge auf allen Cassandra-Knoten.

Die Syntax für jeden Eintrag in der Liste lautet wie folgt:

IP_address[:data_center_number,rack_number]

Cassandra-Knoten können optional das Rechenzentrum und das Rack des Cassandra-Knotens angeben. Geben Sie den data_center_number-Modifikator nur beim Erstellen an mehrere Rechenzentren, wie in einer Installation mit 12 Hosts beschrieben. In einem einzigen Rechenzentrum Installation, dann 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 Multi-Rechenzentrums-Umgebung werden Firewallprobleme behoben, CASS_HOSTS müssen (wie im obigen Beispiel gezeigt) so angeordnet werden, dass die Knoten der aktuellen dass die Rechenzentren am Anfang stehen. Weitere Informationen finden Sie unter Cluster mit 12 Hosts.

Informationen zum Angeben der rack_number für einen Cassandra-Host finden Sie unter Cassandra-Rack-Unterstützung hinzufügen.

CASS_AUTH
CASS_USERNAME
CASS_PASSWORD

Wenn Sie die Cassandra-Authentifizierung aktivieren (CASS_AUTH=y), können Sie den Cassandra-Nutzer übergeben. mit diesen Eigenschaften erstellen.

Nach Abschluss der Installation empfiehlt Apigee, das Passwort von der Konfigurationsdatei.

CONFIG_DELTA_LOG

CONFIG_DELTA_LOG steuert, wie Änderungen an Konfigurationsdateien werden protokolliert. Wenn Sie CONFIG_DELTA_LOG=y festlegen, Konfigurationsänderungen für eine Komponente werden nicht protokolliert.

PG_USER
PG_PWD

Standardmäßig sind in der PostgreSQL-Datenbank zwei Nutzer definiert: „postgres“ und „Apigee“.

Mit PG_USER können Sie den Nutzernamen von „apigee“ ändern Nutzer. Sie können nicht den Namen von „postgres“ ändern Nutzer.

Standardmäßig sind in der PostgreSQL-Datenbank zwei Nutzer definiert: „postgres“ und „Apigee“. Beide Nutzer haben das Standardpasswort „postgres“. Mit PG_PWD legen Sie Folgendes fest: das Passwort bei der Installation jeweils auf einen anderen Wert festzulegen.

Nach Abschluss der Installation empfiehlt Apigee, das Passwort von der Konfigurationsdatei.

PG_MASTER
PG_STANDBY

Legen Sie diese Option so fest, dass die Postgres-Master-Standby-Replikation in folgendem Format aktiviert wird:

PG_MASTER=IPorDNSofNewMaster
PG_STANDBY=IPorDNSofOldMaster
SKIP_SMTP
SMTPHOST
SMTPUSER
SMTPPASSWORD
SMTPSSL
SMTPPORT
SMTPMAILFROM

Konfigurieren Sie SMTP, damit Edge E-Mails für verloren gegangene Passwörter und andere Benachrichtigungen senden kann.

Wenn keine SMTP-Nutzeranmeldedaten erforderlich sind, lassen Sie SMTPUSER und SMTPPASSWORD.

Das Feld „SMTPMAILFROM“ darf nicht leer sein.

CASS_JMX_USERNAME Cassandra-JMX-Nutzername. Erforderlich, wenn Sie die Cassandra JMX-Authentifizierung aktiviert haben.
CASS_JMX_PASSWORD Cassandra-JMX-Passwort. Erforderlich, wenn Sie die Cassandra JMX-Authentifizierung aktiviert haben.
CASS_JMX_TRUSTSTORE Cassandra JMX SSL-Truststore-Nutzername, wenn Sie SSL-basiertes JMX in Cassandra aktiviert haben. Die JMX Truststore-Datei sollte für Apigee-Nutzer lesbar sein.
CASS_JMX_TRUSTSTORE_PASS Cassandra JMX SSL-Truststore-Passwort, wenn Sie SSL-basiertes JMX in Cassandra aktiviert haben.

Zusätzlich zu den hier aufgeführten Attributen gibt es Attribute zum Konfigurieren von Apigee mTLS. Weitere Informationen finden Sie unter Apigee mTLS konfigurieren.