Referencia del archivo de configuración perimetral

Edge para nube privada v4.19.01

A continuación, se muestra un ejemplo de un archivo de configuración silenciosa 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 para incluir este archivo. Para ver ejemplos de archivos de configuración específicos de cada topología, consulta Instala componentes 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)

# 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=IPofNewMaster
# PG_STANDBY=IPofOldMaster

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

En la siguiente tabla, se incluye 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 ni una dirección IP de 127.0.0.1 cuando especifiques la dirección IP de un nodo.
ENABLE_SYSTEM_CHECK

Si es "y", verifica que el sistema cumpla con los requisitos de CPU y memoria para el componente que se está instalando. Consulta los requisitos de instalación para conocer los requisitos de cada componente.

El valor predeterminado es "n" para inhabilitar la verificación.

ENABLE_DYNAMIC_HOSTIP

Si un servidor tiene varias tarjetas de interfaz, el comando "hostname -i" devuelve una lista de direcciones IP separadas por espacios. De forma predeterminada, el instalador de Edge usa la primera dirección IP que se muestra, que puede no ser correcta en todas las situaciones. Como alternativa, puedes establecer la siguiente propiedad en el archivo de configuración de la instalación.

Cuando se establece en "y", el instalador te solicita que selecciones la dirección IP que se usará en la instalación. El valor predeterminado es "n".

ADMIN_EMAIL
APIGEE_ADMINPW

La contraseña del administrador del sistema debe tener al menos 8 caracteres y 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á que la ingreses.

Una vez que se complete la instalación, Apigee recomienda que quites la contraseña del archivo de configuración.

LICENSE_FILE

La ubicación del archivo de licencia, al que debe poder acceder el usuario "apigee". Por ejemplo, almacénalo en el directorio /tmp y ejecuta 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.

Una vez que se complete la instalación, Apigee recomienda que quites la contraseña del archivo de configuración.

USE_LDAP_REMOTE_HOST
LDAP_HOST
LDAP_PORT

Si USE_LDAP_REMOTE_HOST es n, Edge instala OpenLDAP de forma automática cuando instala Management Server.

Establece USE_LDAP_REMOTE_HOST en y si te conectas a un servidor LDAP remoto. OpenLDAP no se instala con el servidor de administración.

Si te conectas a un servidor de OpenLDAP remoto, 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

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

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

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

  • LDAP_SID=1: Es el ID único de este servidor LDAP. Cada nodo LDAP usa un ID diferente. Por ejemplo, configúralo en 2 para el par de LDAP.
  • LDAP_PEER=10.0.0.1: Es la IP o el nombre de DNS del par de LDAP.
MP_POD Especifica el nombre del pod del Message Processor y del router. De forma predeterminada, el nombre es gateway.
REGION

Es el nombre de la región. Por convención, los nombres suelen tener el formato dc-#, en el que # corresponde a un valor entero. Por ejemplo, dc-1, dc-2, etc. Puedes usar dc-1, a menos que realices la instalación en un entorno de varios centros de datos.

En una instalación de varios centros de datos, el valor es dc-1 o dc-2, etc., según el centro de datos que instales. Sin embargo, no estás restringido a usar solo nombres con 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.

Usa el mismo formato para HOSTIP que el que usas para ZK_HOSTS. Es decir, si especificas la dirección IP para ZK_HOSTS, usa una dirección IP para HOSTIP. Si usas un DNS, usa un nombre de DNS para ambos.

En un 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 crees varios centros de datos, como se describe en una instalación de 12 hosts. En una instalación de un solo centro de datos, omite ese modificador. Para obtener más información, consulta Instalación agrupada en clústeres de 12 hosts.

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.

Usa el mismo formato para HOSTIP que el que usas para ZK_CLIENT_HOSTS. Es decir, si especificas la dirección IP para ZK_CLIENT_HOSTS, usa una dirección IP para HOSTIP. Si usas un DNS, usa un nombre de DNS para ambos.

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

En un entorno de varios centros de datos, enumera solo los nodos de ZooKeeper de este centro de datos. Para obtener más información, consulta Instalación agrupada en clústeres de 12 hosts.

CASS_CLUSTERNAME De manera opcional, especifica el nombre del clúster de Cassandra. El nombre predeterminado es "Apigee".
CASS_HOSTS

Son 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 opcional ":dc,ra" que especifica 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 una instalación de un solo centro de datos, omite ese modificador.

Por ejemplo, "192.168.124.201:1,1" = centro de datos 1 y bastidor/zona de disponibilidad 1, y "192.168.124.204:2,1" = centro de datos 2 y bastidor/zona de disponibilidad 1.

En un entorno de varios centros de datos, para superar los problemas de firewall, los CASS_HOSTS deben ordenarse de manera (como se muestra en el ejemplo anterior) de modo que los nodos del centro de datos actual se coloquen al principio. Para obtener más información, consulta Instalación agrupada en clústeres de 12 hosts.

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 con estas propiedades.

Una vez que se complete la instalación, Apigee recomienda que quites la contraseña del archivo de configuración.

PG_USER
PG_PWD

De forma predeterminada, la base de datos de PostgreSQL tiene dos usuarios definidos: "postgres" y "apigee".

PG_USER te permite cambiar el nombre de usuario del usuario "apigee". No puedes cambiar el nombre del usuario "postgres".

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

Una vez que se complete la instalación, Apigee recomienda que quites la contraseña del archivo de configuración.

PG_MASTER
PG_STANDBY

Se configura para habilitar la replicación principal-en espera de Postgres, con el siguiente formato:

PG_MASTER=IPofNewMaster
PG_STANDBY=IPofOldMaster
SKIP_SMTP
SMTPHOST
SMTPUSER
SMTPPASSWORD
SMTPSSL
SMTPPORT
SMTPMAILFROM

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

Si no se requieren credenciales de usuario de SMTP, omite SMTPUSER y SMTPPASSWORD.

Campo obligatorio: SMTPMAILFROM

Además de las propiedades que se indican aquí, hay propiedades para configurar mTLS de Apigee. Para obtener más información, consulta Configura mTLS de Apigee.