Cette page a été traduite par l'API Cloud Translation.

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

Vous trouverez ci-dessous un exemple de fichier de configuration silencieuse complet pour une installation Edge à 9 nœuds. Modifiez ce fichier si nécessaire pour votre configuration. Utilisez l'option -f pour setup.sh pour inclure ce fichier. Pour obtenir des exemples de fichiers de configuration spécifiques à chaque topologie, consultez la section Installer les composants Edge.

# 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 =
    
# Set up username and password to access Qpid broker's management console

QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=pass1234

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

Propriété	Remarque
Noms IP/DNS	N'utilisez pas un nom d'hôte mappé à 127.0.0.1 ou une adresse IP de 127.0.0.1 lorsque vous spécifiez l'adresse IP d'un nœud. Notez que pour les définitions d'hôte Cassandra, n'utilisez que des adresses IP et non des noms DNS.
`ENABLE_SYSTEM_CHECK`	Si la valeur est "y", vérifiez que le système a la configuration requise en matière de processeur et de mémoire pour le composant en cours d'installation. Reportez-vous à la section Configuration requise pour connaître la configuration requise pour chaque composant. La valeur par défaut est "n" pour désactiver la vérification.
`ENABLE_DYNAMIC_HOSTIP`	Si un serveur possède plusieurs cartes d'interface, la commande "nom d'hôte -i" renvoie une liste d'adresses IP séparées par des espaces. Par défaut, le programme d'installation Edge utilise la première adresse IP renvoyée, ce qui peut ne pas être correct dans tous les cas. Vous pouvez également définir la propriété suivante dans le fichier de configuration d'installation. Lorsque la valeur est "y", le programme d'installation vous invite à sélectionner l'adresse IP à utiliser lors de l'installation. La valeur par défaut est "n". Attention:Si vous définissez `ENABLE_DYNAMIC_HOSTIP=y`, assurez-vous que votre fichier de propriétés ne définit pas `HOSTIP`.
`ADMIN_EMAIL` `APIGEE_ADMINPW`	Le mot de passe de l'administrateur système doit comporter au moins huit caractères et contenir 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. Une fois l'installation terminée, Apigee vous recommande de supprimer le mot de passe du fichier de configuration.
`LICENSE_FILE`	L'emplacement du fichier de licence, qui doit être accessible à l'utilisateur "apigee". Par exemple, stockez-le dans le répertoire /tmp et chmod 777 dans le fichier. Le fichier est copié dans le répertoire d'installation Edge.
`APIGEE_LDAPPW`	Spécifie le mot de passe OpenLDAP. Une fois l'installation terminée, Apigee vous recommande de supprimer le mot de passe du fichier de configuration.
`USE_LDAP_REMOTE_HOST LDAP_HOST LDAP_PORT`	Si `USE_LDAP_REMOTE_HOST` est défini sur n, Edge installe automatiquement OpenLDAP lorsqu'il installe le 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, spécifiez 1. Si votre installation Edge utilise plusieurs nœuds OpenLDAP, comme 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 : ID unique de ce serveur LDAP. Chaque nœud LDAP utilise un ID différent. Par exemple, définissez la valeur sur 2 pour l'appairage LDAP. `LDAP_PEER`=10.0.0.1 : nom IP ou nom DNS du pair LDAP
`MP_POD`	Spécifiez le nom du pod de routeur et de processeur de messages. Par défaut, le nom est passerelle.
`REGION`	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. (dc-1, dc-2, etc.). Vous pouvez utiliser dc-1, sauf si vous l'installez dans un environnement multicentre de données. Dans une installation avec plusieurs centres de données, la valeur est dc-1, dc-2, etc. selon le centre de données que vous installez. Toutefois, vous n'êtes pas limité à l'utilisation de noms au format dc-#. Vous pouvez utiliser n'importe quel nom pour la région.
`REGION_MAPPING`	Si vous utilisez des noms de région autres que dc-1, dc-2, etc., définissez cette propriété pour mapper le nom de la région au nom de région au format dc-x approprié. Cette propriété est requise par le serveur de gestion pour enregistrer correctement les datastores Cassandra en fonction des centres de données et des régions de Cassandra.
`ZK_HOSTS`	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. Utilisez le même format pour `HOSTIP` que pour `ZK_HOSTS`. Autrement dit, si vous spécifiez l'adresse IP pour `ZK_HOSTS`, utilisez une adresse IP pour `HOSTIP`. Si vous utilisez un DNS, utilisez un nom DNS pour les deux. Dans un environnement comportant plusieurs centres de données, répertoriez tous les nœuds ZooKeeper des deux centres de données. Spécifiez le modificateur ":observer" sur les nœuds ZooKeeper uniquement lorsque vous créez plusieurs centres de données, comme décrit dans une installation avec 12 hôtes. Dans une installation de centre de données unique, omettez ce modificateur. Pour plus d'informations, consultez la section Installation en cluster à 12 hôtes.
`ZK_CLIENT_HOSTS`	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. Utilisez le même format pour `HOSTIP` que pour `ZK_CLIENT_HOSTS`. Autrement dit, si vous spécifiez l'adresse IP pour `ZK_CLIENT_HOSTS`, utilisez une adresse IP pour `HOSTIP`. Si vous utilisez un DNS, utilisez un nom DNS pour les deux. Dans une installation de centre de données unique, il s'agit des mêmes nœuds que spécifié par `ZK_HOSTS`. Dans un environnement comportant plusieurs centres de données, ne répertoriez que les nœuds ZooKeeper de ce centre de données. Pour plus d'informations, consultez la section Installation en cluster à 12 hôtes.
`CASS_CLUSTERNAME`	Indiquez éventuellement le nom du cluster Cassandra. Le nom par défaut est "Apigee".
`CASS_HOSTS`	Spécifie une liste d'adresses IP d'hôtes (et non de noms DNS) séparées par des virgules des nœuds Cassandra, et éventuellement leur numéro de centre de données et le rack auquel ils appartiennent. Pour les topologies de production, cette liste doit contenir au moins trois nœuds. Les deux premiers nœuds sont utilisés en tant que "serveurs sources". Par conséquent, les adresses IP doivent être répertoriées dans le même ordre sur tous les nœuds Cassandra. La syntaxe de chaque entrée de la liste est la suivante: `IP_address`[:`data_center_number`,`rack_number`] Les nœuds Cassandra peuvent éventuellement spécifier le centre de données et le rack du nœud Cassandra. Spécifiez le modificateur `data_center_number` uniquement lorsque vous créez plusieurs centres de données, comme décrit dans une installation avec 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 zone de rack/disponibilité 1", et "192.168.124.204:2,1 = centre de données 2 et zone de rack/disponibilité 1". Dans un environnement multicentre de données, pour résoudre les problèmes de pare-feu, `CASS_HOSTS` doit être ordonné de manière à ce que les nœuds du centre de données actuel soient placés au début (comme illustré dans l'exemple ci-dessus). Pour plus d'informations, consultez la section Installation en cluster à 12 hôtes. Pour plus d'informations sur la spécification du `rack_number` pour un hôte Cassandra, consultez la section Ajouter la prise en charge du rack Cassandra.
`CASS_AUTH` `CASS_USERNAME` `CASS_PASSWORD`	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. Une fois l'installation terminée, Apigee vous recommande de supprimer le mot de passe du fichier de configuration.
`CONFIG_DELTA_LOG`	`CONFIG_DELTA_LOG` contrôle la manière dont les modifications apportées aux fichiers de configuration sont consignées. Si vous définissez `CONFIG_DELTA_LOG=y`, les modifications de configuration d'un composant ne sont pas consignées.
`PG_USER` `PG_PWD`	Par défaut, la base de données PostgreSQL a deux utilisateurs définis: "postgres" et "apigee". `PG_USER` vous permet de modifier le nom de l'utilisateur "apigee". Vous ne pouvez pas modifier le nom de l'utilisateur "postgres". Par défaut, la base de données PostgreSQL a deux utilisateurs définis: "postgres" et "apigee". Le mot de passe par défaut de ces deux utilisateurs est "postgres". Utilisez `PG_PWD` pour définir le mot de passe sur une valeur différente pour les deux utilisateurs au moment de l'installation. Une fois l'installation terminée, Apigee vous recommande de supprimer le mot de passe du fichier de configuration.
`PG_MASTER` `PG_STANDBY`	Configurez-le pour activer la réplication en attente principale Postgres, sous la forme: PG_MASTER=`IPorDNSofNewMaster` PG_STANDBY=`IPorDNSofOldMaster` REMARQUE:Apigee vous recommande vivement d'utiliser des adresses IP plutôt que des noms d'hôte pour les propriétés `PG_MASTER` et `PG_STANDBY` dans votre fichier de configuration silencieuse. De plus, vous devez être cohérent sur les deux nœuds. Si vous utilisez des noms d'hôte plutôt que des adresses IP, vous devez vous assurer que les noms d'hôte sont correctement résolus à l'aide du DNS.
`SKIP_SMTP` `SMTPHOST` `SMTPUSER` `SMTPPASSWORD` `SMTPSSL` `SMTPPORT` `SMTPMAILFROM`	Configurez SMTP pour que 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 `SMTPUSER` et `SMTPPASSWORD`. Le champ "`SMTPMAILFROM`" est obligatoire.
`CASS_JMX_USERNAME`	Nom d'utilisateur Cassandra JMX. Obligatoire si vous avez activé l'authentification JMX Cassandra.
`CASS_JMX_PASSWORD`	Mot de passe JMX Cassandra. Obligatoire si vous avez activé l'authentification JMX Cassandra.
`CASS_JMX_TRUSTSTORE`	Nom d'utilisateur du magasin de confiance SSL Cassandra JMX, si vous avez activé JMX basé sur SSL dans Cassandra. Le fichier JMX Truststore doit être lisible par l'utilisateur Apigee.
`CASS_JMX_TRUSTSTORE_PASS`	Mot de passe du magasin de confiance SSL Cassandra JMX, si vous avez activé JMX basé sur SSL dans Cassandra.
`QPID_MGMT_USERNAME` `QPID_MGMT_PASSWORD`	Ces identifiants permettent d'accéder à la console de gestion Web Qpid du courtier Qpid. Web Management Console fournit une interface simple et intuitive pour la gestion et le contrôle du courtier Qpid.

En plus des propriétés listées ici, il existe des propriétés permettant de configurer Apigee mTLS. Pour en savoir plus, consultez la page Configurer mTLS Apigee.