Referencia del archivo de configuración perimetral

A continuación, se muestra un ejemplo de un archivo de configuración silencioso completo para un perímetro de 9 nodos instalación. Edita este archivo según sea necesario para tu configuración. Usa la opción -f a setup.sh para incluir este archivo. Para ver ejemplos de archivos de configuración que se específicas 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 (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=":dc-1 :dc-2 ... :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=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>"

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

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 especificando la dirección IP de un nodo.

Ten en cuenta que para las definiciones de host de Cassandra, usa solo direcciones IP. No usar DNS y nombres de usuario.

ENABLE_SYSTEM_CHECK

Si la respuesta es "y", verifica que el sistema cumpla con los requisitos de CPU y memoria del componente. que se está instalando. Consulta Instalación Requisitos para 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 “nombre de host -i” el comando devuelve un una lista de direcciones IP separadas por espacios. De forma predeterminada, el instalador de Edge usa la primera IP del proveedor, lo que podría no ser correcto en todas las situaciones. Como alternativa, puede establecer la siguiente propiedad en el archivo de configuración de la instalación.

Cuando se establece en "y", el instalador te pide que selecciones la dirección IP que deseas utilizar en la instalar. El valor predeterminado es "n".

ADMIN_EMAIL
APIGEE_ADMINPW

La contraseña del administrador del sistema debe tener al menos 8 caracteres y debe incluir uno una letra mayúscula, una letra minúscula, un dígito o un carácter especial. Si omites contraseña, se te solicitará que la ingreses.

Una vez finalizada la instalación, Apigee recomienda quitar la contraseña de el archivo de configuración.

LICENSE_FILE

La ubicación del archivo de licencia, a la que debe poder acceder el servicio de Apigee usuario. Por ejemplo, almacénalo en el directorio /tmp y chmod 777 en el archivo. Se copió el archivo al directorio de instalación de Edge.

APIGEE_LDAPPW

Especifica la contraseña de OpenLDAP.

Una vez finalizada la instalación, Apigee recomienda quitar la contraseña de el archivo de configuración.

USE_LDAP_REMOTE_HOST
LDAP_HOST
LDAP_PORT

Si USE_LDAP_REMOTE_HOST es n, borde instala OpenLDAP automáticamente cuando instala el servidor de administración.

Establece USE_LDAP_REMOTE_HOST en "y" si eres que se conecta a un servidor LDAP remoto. OpenLDAP no está instalado con el administrador Servidor.

Si te conectas a un servidor 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

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

Si tu topología perimetral usa un solo servidor OpenLDAP, especifica 1. Si tu Edge utiliza múltiples nodos OpenLDAP, como en una instalación de producción de 13 nodos, especificar 2.

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

  • LDAP_SID=1 - Único Es el ID de este servidor LDAP. Cada nodo de LDAP usa un ID diferente. Por ejemplo, configúralo en 2 para intercambio de tráfico de LDAP.
  • LDAP_PEER=10.0.0.1 - Nombre de IP o DNS del par de LDAP.
MP_POD Especifica el nombre del Message Processor y el Pod del router. De forma predeterminada, el nombre es de enlace NAT.
REGION

Nombre de la región. Por convención, los nombres suelen tener el formato dc-#, en el que # corresponde en un valor entero. Por ejemplo, dc-1, dc-2, etc. Puedes usar dc-1 a menos que instales 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 qué centro de datos estás instalando. Sin embargo, no estás limitado a usar solo nombres en el formato dc-#. Puedes usar cualquier nombre para la región.

REGION_MAPPING

Si usas nombres de regiones distintos de dc-1, dc-2, etc., configura esta propiedad para que se asigne. el nombre de la región por el nombre de región adecuado con formato dc-x. El servidor de administración requiere esta propiedad para registrar correctamente los datos de Cassandra tiendas basadas en regiones y centros de datos de Cassandra.

ZK_HOSTS

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

Usa el mismo formato que usas para HOSTIP ZK_HOSTS Es decir, si especifica la dirección IP para ZK_HOSTS, usa una dirección IP para HOSTIP Si usas un DNS, y, luego, usar un nombre de DNS para ambas.

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

Especifica el “:observer” en los nodos de ZooKeeper solo cuando creando varios centros de datos, como se describe en una instalación de 12 hosts. En un conjunto de datos único puedes omitir ese modificador. Para obtener más información, consulta Instalación 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. La IP las direcciones o los nombres de DNS deben estar enumerados en el mismo orden en todos los nodos de ZooKeeper.

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

En una única instalación de centro de datos, estos son los mismos nodos especificados por ZK_HOSTS

En un entorno de varios centros de datos, enumera solo los nodos de ZooKeeper en este centro de datos. Para obtener más información, consulta Instalación 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

Especifica una lista separada por comas de nodos de Cassandra direcciones IP de host (no nombres de DNS), y, opcionalmente, su número de centro de datos y el rack al que pertenecen.

Para topologías de producción, debe haber al menos tres nodos en esta lista. La primera dos nodos se usan como “servidores de origen”. En consecuencia, las direcciones IP deben aparecer en el el mismo orden en todos los nodos de Cassandra.

La sintaxis de cada entrada de la lista es la siguiente:

IP_address[:data_center_number,rack_number]

De manera opcional, los nodos de Cassandra pueden especificar el centro de datos y el bastidor del nodo de Cassandra. Especifica el modificador data_center_number solo cuando crees varios centros de datos, como se describe en una instalación de 12 hosts. En un solo centro de datos o la instalación, omite ese modificador.

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

En un entorno de varios centros de datos, para superar los problemas del firewall, CASS_HOSTS deben estar ordenados de manera tal que los nodos de la centro de datos se sitúan al principio. Para obtener más información, consulta Instalación en clústeres de 12 hosts.

Si quieres obtener información sobre cómo especificar rack_number para un host de Cassandra, consulta Agrega compatibilidad con el bastidor Cassandra.

CASS_AUTH
CASS_USERNAME
CASS_PASSWORD

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

Una vez finalizada la instalación, Apigee recomienda quitar la contraseña de el archivo de configuración.

CONFIG_DELTA_LOG

CONFIG_DELTA_LOG controla cómo los cambios en de configuración de Terraform. Si configuras CONFIG_DELTA_LOG=y, los cambios de configuración de un componente no se registran.

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 de Apigee usuario. No puedes cambiar el nombre del “postgres” usuario.

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 para establecer la contraseña a un valor diferente para ambos usuarios en el momento de la instalación.

Una vez finalizada la instalación, Apigee recomienda quitar la contraseña de el archivo de configuración.

PG_MASTER
PG_STANDBY

Configurado para habilitar la replicación en espera de instancia principal de Postgres de la siguiente forma:

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

Configurar SMTP para que Edge pueda enviar correos electrónicos sobre contraseñas perdidas y otras notificaciones

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

Campo obligatorio: SMTPMAILFROM

CASS_JMX_USERNAME Nombre de usuario de Cassandra JMX. Obligatorio si habilitaste la autenticación Cassandra JMX.
CASS_JMX_PASSWORD Contraseña de Cassandra JMX. Obligatorio si habilitaste la autenticación Cassandra JMX.
CASS_JMX_TRUSTSTORE Nombre de usuario del almacén de confianza SSL de Cassandra JMX si habilitaste JMX basado en SSL en Cassandra. El usuario de Apigee debe poder leer el archivo JMX Truststore.
CASS_JMX_TRUSTSTORE_PASS Contraseña del almacén de confianza SSL de Cassandra JMX si habilitaste JMX basado en SSL en Cassandra

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