Edge-Konfigurationsdatei-Referenz

Edge for Private Cloud v4.18.05

Unten sehen Sie ein Beispiel für eine vollständige, stumme Konfigurationsdatei für eine Edge-Installation mit 9 Knoten. Bearbeiten Sie diese Datei nach Bedarf für Ihre Konfiguration. Verwenden Sie die Option -f bis setup.sh, um diese Datei einzubeziehen. Im Folgenden finden Sie außerdem 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)

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

# 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/DNS names of the Cassandra hosts (previously defined)
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>"

Die folgende Tabelle enthält weitere Informationen zu diesen Properties:

Attribut Hinweis
IP-/DNS-Namen Verwenden Sie keine Hostnamenzuordnung zu 127.0.0.1 oder eine IP-Adresse von 127.0.0.1, wenn Sie die IP-Adresse eines Knotens angeben.
ENABLE_SYSTEM_CHECK

Wenn „y“ angegeben ist, prüfen Sie, ob das System die CPU- und Arbeitsspeicheranforderungen für die installierte Komponente erfüllt. Informationen zu den Anforderungen für die einzelnen Komponenten finden Sie unter Anforderungen an die Installation.

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

ENABLE_DYNAMIC_HOSTIP

Wenn ein Server mehrere Schnittstellenkarten hat, gibt der Befehl „hostname -i“ eine durch Leerzeichen getrennte Liste von IP-Adressen zurück. Standardmäßig verwendet das Edge-Installationsprogramm die erste zurückgegebene IP-Adresse, was nicht in allen Fällen korrekt ist. Alternativ können Sie die folgende Property in der Installationskonfigurationsdatei festlegen.

Wenn dieser Wert auf „y“ gesetzt ist, werden Sie vom Installationsprogramm aufgefordert, die IP-Adresse auszuwählen, die bei der Installation verwendet werden soll. Der Standardwert ist „n“.

ADMIN_EMAIL
APIGEE_ADMINPW

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

Nach Abschluss der Installation empfiehlt Apigee, das Passwort aus der Konfigurationsdatei zu entfernen.

LICENSE_FILE

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

APIGEE_LDAPPW

Gibt das OpenLDAP-Passwort an.

Nach Abschluss der Installation empfiehlt Apigee, das Passwort aus der Konfigurationsdatei zu entfernen.

USE_LDAP_REMOTE_HOST
LDAP_HOST
LDAP_PORT

Wenn USE_LDAP_REMOTE_HOST n ist, installiert Edge bei der Installation des Verwaltungsservers automatisch OpenLDAP.

Legen Sie USE_LDAP_REMOTE_HOST auf „y“ fest, 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

Legen Sie LDAP_TYPE=1 für OpenLDAP ohne Replikation fest. LDAP_TYPE=2 entspricht OpenLDAP mit Replikation.

Wenn in Ihrer Edge-Topologie ein einzelner OpenLDAP-Server verwendet wird, geben Sie „1“ an. Wenn Ihre Edge-Installation mehrere OpenLDAP-Knoten verwendet, wie 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. Für jeden LDAP-Knoten wird eine andere ID verwendet. Legen Sie beispielsweise 2 für den LDAP-Peer fest.
  • LDAP_PEER=10.0.0.1 – IP- oder DNS-Name des LDAP-Peers.
MP_POD Geben Sie den Namen des Message Processor- und des Router-Pods an. Standardmäßig lautet der Name „gateway“.
REGION

Name der Region. Konventionsgemäß haben Namen in der Regel die Form dc-#, wobei # einem Ganzzahlwert entspricht. Beispiel: dc-1, dc-2 usw. Sie können dc-1 verwenden, es sei denn, die Installation erfolgt in einer Umgebung mit mehreren Rechenzentren.

Bei einer Installation in mehreren Rechenzentren lautet der Wert je nach Rechenzentrum dc-1, dc-2 usw. 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 aufgelistet werden.

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

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

Geben Sie den Modifikator „:observer“ nur auf ZooKeeper-Knoten an, wenn Sie mehrere Rechenzentren wie in einer 12-Host-Installation beschrieben erstellen. Lassen Sie diesen Modifikator in einer einzelnen Rechenzentrumsinstallation weg. Weitere Informationen finden Sie unter Clusterinstallation mit 12 Hosts.

ZK_CLIENT_HOSTS

Die IP-Adressen oder DNS-Namen der von diesem Rechenzentrum verwendeten ZooKeeper-Knoten. Die IP-Adressen oder DNS-Namen müssen auf allen ZooKeeper-Knoten in derselben Reihenfolge aufgeführt sein.

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

Bei einer einzelnen Rechenzentrumsinstallation sind dies dieselben Knoten wie in ZK_HOSTS angegeben.

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_CLUSTERNAME Geben Sie optional den Namen des Cassandra-Clusters an. Der Standardname lautet „Apigee“.
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 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 bei einer Installation mit 12 Hosts beschrieben. Bei einer Installation in einem einzelnen Rechenzentrum muss dieser Modifikator nicht angegeben werden.

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, dass die Knoten des aktuellen Rechenzentrums am Anfang platziert werden (siehe Beispiel oben), 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 mithilfe dieser Eigenschaften übergeben.

Nach Abschluss der Installation empfiehlt Apigee, das Passwort aus der Konfigurationsdatei zu entfernen.

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 des Nutzers „apigee“ ändern. Sie können den Namen des „postgres“-Nutzers nicht ändern.

Standardmäßig sind in der PostgreSQL-Datenbank zwei Benutzer definiert: „postgres“ und „apigee“. Beide Nutzer haben das Standardpasswort „postgres“. Mit PG_PWD können Sie das Passwort bei der Installation für beide Nutzer auf einen anderen Wert festlegen.

Nach Abschluss der Installation empfiehlt Apigee, das Passwort aus der Konfigurationsdatei zu entfernen.

PG_MASTER
PG_STANDBY

Aktivieren Sie die Postgres-Master-Standby-Replikation in der Form:

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

Das Feld „SMTPMAILFROM“ darf nicht leer sein.