Referencia del archivo de configuración perimetral

Edge para la nube privada v. 4.17.01

A continuación, se muestra un ejemplo de un archivo de configuración silencioso completo para una instalación de Edge de 9 nodos. Edita este archivo según sea necesario para tu configuración. Usa la opción -f para setup.sh a fin de incluir este archivo. También se muestran a continuación archivos de configuración de ejemplo para cada topología de 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.

La siguiente tabla contiene información adicional sobre estas propiedades:

Propiedad

Nota

Nombres de IP/DNS

No uses una asignación de nombre de host a 127.0.0.1 o una dirección IP de 127.0.0.1 cuando especifiques la dirección IP de un nodo.

ADMIN_EMAIL
APIGEE_ADMINPW

La contraseña del administrador del sistema debe tener 8 caracteres como mínimo y, a su vez, contener una letra mayúscula, una letra minúscula, un dígito o un carácter especial. Si omites la contraseña, se te solicitará.

LICENCIA_ARCHIVO

Es la ubicación del archivo de licencia, que debe ser accesible para el usuario “apigee”. Por ejemplo, almacénelo en el directorio /tmp y chmod 777 en el archivo. El archivo se copia en el directorio de instalación de Edge.

APIGEE_LDAPPW

Especifica la contraseña de OpenLDAP.

USE_LDAP_REMOTE_HOST
LDAP_HOST
LDAP_PORT

Si USE_LDAP_REMOTE_HOST es n, Edge instalará automáticamente OpenLDAP cuando instale el servidor de administración.

Configura USE_LDAP_REMOTE_HOST como y si te conectas a un servidor LDAP remoto. OpenLDAP no está instalado con el servidor de administración.

Si te conectas a un servidor remoto de OpenLDAP, usa LDAP_HOST
y LDAP_PORT para especificar la dirección IP o el nombre de DNS y el número de puerto del host.

LDAP_TYPE
LDAP_SID
LDAP_PEER

Configura LDAP_TYPE=1 para OpenLDAP sin replicación. LDAP_TYPE=2 corresponde a OpenLDAP con replicación.

Si su topología de Edge usa un único servidor de OpenLDAP, especifique 1. Si tu instalación perimetral usa varios nodos de OpenLDAP, como en una instalación de producción de 13 nodos, especifica 2.

Si habilitas la replicación, configura las siguientes propiedades:

  • LDAP_SID=1: ID único para este servidor LDAP. Cada nodo de LDAP utiliza un ID diferente. Por ejemplo, establecer en 2 para el intercambio de tráfico de LDAP.
  • LDAP_PEER=10.0.0.1: IP o nombre de DNS del par LDAP.

BIND_ON_ALL_INTERFACES

Si se configura como "y", el router o el procesador de mensajes se vincula (escucha) en todas las interfaces (IP). Si se configura como “n”, el router o el procesador de mensajes se vincula (escucha) en una interfaz específica, la IP que muestra el comando “hostname -i”.

MP_POD

Especifique el nombre del Message Processor y el Pod del router. De forma predeterminada, el nombre es puerta de enlace.

REGIÓN

Nombre de la región. Por convención, los nombres suelen tener el formato dc-#, donde # corresponde a un valor entero. Por ejemplo, dc-1, dc-2, etc. Puedes usar dc-1, a menos que la instalación se realice en un entorno de centro de datos múltiple.

En la instalación de varios centros de datos, el valor es dc-1, dc-2, etc., según el centro de datos que instales. Sin embargo, no estás restringido a usar solo nombres en el formato dc-#. Puedes usar cualquier nombre para la región.

ZK_HOSTS

Son las direcciones IP o los nombres de DNS de los nodos de ZooKeeper. Las direcciones IP o los nombres de DNS deben aparecer en el mismo orden en todos los nodos de ZooKeeper.

En el entorno de varios centros de datos, enumera todos los nodos de ZooKeeper de ambos centros de datos.

Especifica el modificador “:observer” en los nodos de ZooKeeper solo cuando se creen varios centros de datos, como se describe en una instalación de 12 hosts. En la instalación de un solo centro de datos, omite ese modificador.

ZK_CLIENT_HOSTS

Son las direcciones IP o los nombres de DNS de los nodos de ZooKeeper que usa este centro de datos. Las direcciones IP o los nombres de DNS deben aparecer en el mismo orden en todos los nodos de ZooKeeper.

En una instalación única de centro de datos, estos son los mismos nodos que especifica ZK_HOSTS.

En el entorno de varios centros de datos, enumera solo los nodos de ZooKeeper en este centro de datos.

CASS_CLUSTERNAME De manera opcional, indica el nombre del clúster de Cassandra. El nombre predeterminado es “Apigee”.

ANUNCIOSCASS

Las direcciones IP (no los nombres de DNS) de los nodos de Cassandra. Los primeros dos nodos se usarán como servidores de origen. Las direcciones IP deben aparecer en el mismo orden en todos los nodos de Cassandra.

Los nodos de Cassandra pueden tener un sufijo “:dc,ra” opcional que especifique el centro de datos y el bastidor del nodo de Cassandra. Especifica este modificador solo cuando crees varios centros de datos, como se describe en una instalación de 12 hosts. En la instalación de un solo centro de datos, omite ese modificador.

Por ejemplo, “192.168.124.201:1,1 = centro de datos 1 y zona de rack/disponibilidad 1”, y “192.168.124.204:2,1 = centro de datos 2 y zona de rack/disponibilidad 1.

En un entorno de varios centros de datos, para superar los problemas de firewall, CASS_HOSTS debe ordenarse de manera manera (como se muestra en el ejemplo anterior) de modo que los nodos del centro de datos actual se coloquen al principio.

CASS_AUTH
CASS_USERNAME

CASS_PASSWORD

Si habilitas la autenticación de Cassandra, CASS_AUTH=y, puedes pasar el nombre de usuario y la contraseña de Cassandra mediante estas propiedades.

PG_PWD

De forma predeterminada, la base de datos de PostgreSQL tiene dos usuarios definidos: “postgres” y “apigee”. Ambos usuarios tienen la contraseña predeterminada “postgres”. Usa PG_PWD a fin de establecer un valor diferente para la contraseña de ambos usuarios en el momento de la instalación.

PG_MASTER

PG_STANDBY;

Configura para habilitar la replicación en espera maestra de Postgres de la siguiente forma:

PG_MASTER=IPorDNSofNewMaster

PG_STANDBY=IPorDNSofOldMaster

SKIP_SMTP
SMTPHOST
SMSM
SMPASSWORD
SMSM
SMTP

Configura SMTP para que Edge pueda enviar correos electrónicos de contraseñas perdidas y otras notificaciones.

Si las credenciales de usuario de SMTP no son obligatorias, omite SMTPUSER y SMTPPASSWORD.