Référence de fichier de configuration de périphérie

Edge for Private Cloud v. 4.17.01

Vous trouverez ci-dessous un exemple de fichier de configuration silencieuse complet pour une installation Edge à neuf nœuds. Modifiez ce fichier selon vos besoins. Utilisez l'option -f pour setup.sh afin d'inclure ce fichier. Vous trouverez également ci-dessous des exemples de fichiers de configuration pour chaque topologie Edge.

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

Le tableau suivant contient des informations supplémentaires sur ces propriétés:

Propriété

Remarque

Noms IP/DNS

N'utilisez pas de mappage de nom d'hôte vers 127.0.0.1 ou d'adresse IP 127.0.0.1 lorsque vous spécifiez l'adresse IP d'un nœud.

ADMIN_EMAIL
APIGEE_ADMINPW

Le mot de passe de l'administrateur système doit comporter au moins huit caractères et inclure une lettre majuscule, une lettre minuscule, un chiffre ou un caractère spécial. Si vous omettez le mot de passe, vous serez invité à le saisir.

FILE_LICENSE

Emplacement du fichier de licence, qui doit être accessible à l'utilisateur "apigee". Par exemple, stockez-le dans le répertoire /tmp et dans chmod 777. Le fichier est copié dans le répertoire d'installation Edge.

APIGEE_LDAPPW.

Spécifie le mot de passe OpenLDAP.

USE_LDAP_REMOTE_host
LDAP_Host
LDAP_PORT

Si USE_LDAP_REMOTE_Host est n, Edge installe automatiquement OpenLDAP lors de l'installation du serveur de gestion.

Définissez USE_LDAP_REMOTE_Host sur y si vous vous connectez à un serveur LDAP distant. OpenLDAP n'est pas installé avec le serveur de gestion.

Si vous vous connectez à un serveur OpenLDAP distant, utilisez LDAP_host
et LDAP_PORT pour spécifier l'adresse IP ou le nom DNS et le numéro de port de l'hôte.

LDAP_TYPE
LDAP_SID
LDAP_PEER

Définissez LDAP_TYPE=1 pour OpenLDAP sans réplication. LDAP_TYPE=2 correspond à OpenLDAP avec réplication.

Si votre topologie Edge utilise un seul serveur OpenLDAP, indiquez 1. Si votre installation Edge utilise plusieurs nœuds OpenLDAP, par exemple dans une installation de production à 13 nœuds, spécifiez 2.

Si vous activez la réplication, définissez les propriétés suivantes:

  • LDAP_SID=1 : identifiant unique pour ce serveur LDAP. Chaque nœud LDAP utilise un ID différent. Par exemple, définissez 2 pour "Peer pair LDAP".
  • LDAP_PEER=10.0.0.1 - Nom IP ou DNS du pair LDAP.

BIND_ON_ALL_INTERFACES

S'il est défini sur "y", le routeur et le processeur de messages sont liés (sur toutes les interfaces IP). Si la valeur est "n", alors le routeur/le processeur de message est associé (sur une interface spécifique), l'adresse IP renvoyée par la commande "hostname -i"

MP_POD

Indiquez le nom du pod de traitement des messages et du routeur. Par défaut, le nom est passerelle.

RÉGION

Nom de la région. Par convention, les noms se présentent généralement sous la forme dc-#, où # correspond à une valeur entière. Par exemple, dc-1, dc-2, etc. Vous pouvez utiliser dc-1, sauf si vous l'installez dans un environnement de centres de données multiples.

Dans une installation avec plusieurs centres de données, la valeur est dc-1 ou dc-2, etc. selon le centre de données que vous installez. Cependant, vous n'êtes pas obligé de n'utiliser que des noms au format dc-#. Vous pouvez utiliser n'importe quel nom pour la région.

Hébergeurs

Adresses IP ou noms DNS des nœuds ZooKeeper. Les adresses IP ou les noms DNS doivent être répertoriés dans le même ordre sur tous les nœuds ZooKeeper.

Dans un environnement de centre de données multiple, répertoriez tous les nœuds ZooKeeper des deux centres de données.

Spécifiez le modificateur ":observer" sur les nœuds ZooKeeper uniquement lors de la création de plusieurs centres de données, comme décrit dans une installation à 12 hôtes. Dans une seule installation de centre de données, omettez ce modificateur.

Hôtes clients ZK

Adresses IP ou noms DNS des nœuds ZooKeeper utilisés par ce centre de données. Les adresses IP ou les noms DNS doivent être répertoriés dans le même ordre sur tous les nœuds ZooKeeper.

Dans une installation de centre de données unique, il s'agit des mêmes nœuds que ceux spécifiés par ZK_HostS.

Dans un environnement de centre de données multiple, répertoriez uniquement les nœuds ZooKeeper de ce centre de données.

CASS_CLUSTERNAME Vous pouvez éventuellement spécifier le nom du cluster Cassandra. Le nom par défaut est "Apigee".

HÉSITES_CASSES

Adresses IP (et non les noms DNS) des nœuds Cassandra. Les deux premiers nœuds seront utilisés comme serveurs source. Les adresses IP doivent être répertoriées dans le même ordre sur tous les nœuds Cassandra.

Les nœuds Cassandra peuvent comporter un suffixe ":dc,ra" facultatif, qui spécifie le centre de données et le rack du nœud Cassandra. Spécifiez ce modificateur uniquement lorsque vous créez plusieurs centres de données, comme décrit dans une installation à 12 hôtes. Dans une installation de centre de données unique, omettez ce modificateur.

Par exemple, "192.168.124.201:1,1 = centre de données 1 et rack/zone de disponibilité 1, et "192.168.124.204:2,1 = centre de données 2 et rack/zone de disponibilité 1".

Dans un environnement multiCentre de données, pour résoudre les problèmes de pare-feu, les fichiers CASS_hosts doivent être ordonnés (comme dans l'exemple ci-dessus) de sorte que les nœuds du centre de données actuel soient placés au début.

CASS_AUTH
CASS_USERNAME

CAS_MOT DE PASSE

Si vous activez l'authentification Cassandra, CASS_AUTH=y, vous pouvez transmettre le nom d'utilisateur et le mot de passe Cassandra à l'aide de ces propriétés.

PG_PWD

Par défaut, la base de données PostgreSQL comprend deux utilisateurs: "postgres" et "apigee". Le mot de passe par défaut des utilisateurs est "postgres". Utilisez PG_PWD pour définir une valeur différente pour le mot de passe au moment de l'installation.

PG_MASTER

PG_STANDBY

Ce paramètre est défini pour activer la réplication maître-standby au format suivant:

PG_MASTER=IPorDNSofNewMaster

PG_STANDBY=IPorDNSofOldMaster

SKIP_SMTP
SMTPHost
SMTPUSER
SMTPPASSWORD
SMTPSSL
SMTPPORT

Configurez SMTP afin qu'Edge puisse envoyer des e-mails en cas de perte de mots de passe et d'autres notifications.

Si les identifiants utilisateur SMTP ne sont pas requis, omettez les paramètres SMTPUSER (Utilisateur SMTP) et SMTPPASSWORD.