Edge-Konfigurationsdatei-Referenz

Edge for Private Cloud v. 4.17.01

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 (not DNS names) 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=

# Set Postgres password. Default is postgres.
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.

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.

APIGEE_LDAPPW

Gibt das OpenLDAP-Passwort an.

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.

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.

CASS_CLUSTERNAME Gibt optional den Namen des Cassandra-Clusters an. Der Standardname ist „Apigee“.

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.

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_PWD

Standardmäßig sind in der PostgreSQL-Datenbank zwei Nutzer definiert: „postgres“ und „apigee“. Beide Nutzer haben das Standardpasswort „postgres“. Verwenden Sie PG_PWD, um das Passwort für beide Nutzer bei der Installation auf einen anderen Wert festzulegen.

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.