Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Instala componentes de Edge en un nodo

Edge para nube privada v. 4.16.05

Después de instalar la utilidad apigee-setup de Edge en un nodo, usa la utilidad apigee-setup para instalar uno o más componentes de Edge en el nodo.

La utilidad apigee-setup usa un comando con el siguiente formato:

> /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

En el ejemplo anterior, component es el componente de Edge que se instalará y configFile es el archivo de configuración silenciosa que contiene la información de instalación. El usuario "apigee" debe poder acceder al archivo de configuración o leerlo. Por ejemplo, coloca el archivo en el directorio /tmp del nodo.

Por ejemplo, para instalar el servidor de administración de Edge, haz lo siguiente:

> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f /tmp/myConfig

Consideraciones de instalación

Cuando escribas tu archivo de configuración, ten en cuenta las siguientes opciones.

Configura la replicación de principal-en espera de Postgres

De forma predeterminada, Edge instala todos los nodos de Postgres en modo principal. Sin embargo, en los sistemas de producción con varios nodos de Postgres, debes configurarlos para que usen la replicación de principal-en espera, de modo que, si el nodo principal falla, el nodo en espera pueda seguir entregando tráfico.

Puedes habilitar y configurar la replicación de principal en espera en el momento de la instalación con las propiedades del archivo de configuración silenciosa. También puedes habilitar la replicación principal-en espera después de la instalación. Para obtener más información, consulta Configura la replicación principal-en espera para Postgres.

Habilita la autenticación de Cassandra

De forma predeterminada, Cassandra se instala sin la autenticación habilitada. Esto significa que cualquier persona puede acceder a Cassandra. Puedes habilitar la autenticación después de instalar Edge o como parte del proceso de instalación.

Puedes habilitar la autenticación de Cassandra como tiempo de instalación con las propiedades del archivo de configuración silencioso. También puedes habilitarla después de la instalación.

Para obtener más información, consulta Habilita la autenticación de Cassandra.

Vincula el router a un puerto protegido

Si deseas vincular el router a un puerto protegido, como los números de puerto inferiores a 1024, debes configurar el router para que se ejecute como un usuario con acceso a esos puertos. De forma predeterminada, el Router se ejecuta como el usuario "apigee", que no tiene acceso a los puertos con privilegios.

Para ejecutar el router como un usuario diferente, haz lo siguiente:

Como raíz, crea el archivo /opt/apigee/etc/edge-router.d/RUN_USER.sh.
Agrega la siguiente entrada al archivo:
RUN_USER=root
Si no deseas ejecutar el router como raíz, especifica un usuario con acceso al puerto.
Guarda el archivo.
Si especificaste un usuario que no sea raíz, cambia el propietario del archivo a ese usuario:
> chown USER:USER /opt/apigee/etc/edge-router.d/RUN_USER.sh
Reinicia el router:
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart

Especifica los componentes que se instalarán

En la siguiente tabla, se enumeran las opciones que pasas a la opción -p de la utilidad apigee-service para especificar qué componentes instalar en el nodo:

Componente	Descripción
c	Instala solo Cassandra.
zk	instalar solo ZooKeeper.
ds	Instala ZooKeeper y Cassandra.
ld	Instala solo OpenLDAP.
ms	Instala el servidor de administración de Edge, que también instala la IU de Edge y OpenLDAP. Si configuras USE_LDAP_REMOTE_HOST=y en el archivo de configuración, se omite la instalación de OpenLDAP y el servidor de administración usa OpenLDAP instalado en un nodo diferente.
r	Instala solo el router perimetral.
mp	Instala solo el Message Processor de Edge.
rmp	Instala el router y el Message Processor de Edge.
ui	Instala la IU de Edge.
qs	Instala solo el servidor de Qpid.
ps	Instala solo el servidor de Postgres.
sax	Instala los componentes de estadísticas, es decir, Qpid y Postgres. Usa esta opción solo para el desarrollo y las pruebas, no para la producción.
mes	Instala Monetization.
sa	Instala Edge de forma independiente, es decir, Cassandra, ZooKeeper, Management Server, OpenLDAP, IU de Edge, Router y Message Processor. Esta opción omite los componentes de estadísticas de Edge: Qpid y Postgres. Usa esta opción solo para el desarrollo y las pruebas, no para la producción.
aio	Instala todos los componentes en un solo nodo. Usa esta opción solo para el desarrollo y las pruebas, no para la producción.

Crea un archivo de configuración

El archivo de configuración contiene toda la información necesaria para instalar Edge. A menudo, puedes usar el mismo archivo de configuración para instalar todos los componentes en una instalación de Edge.

Sin embargo, tendrás que usar archivos de configuración diferentes o modificar tu archivo de configuración en los siguientes casos:

Instalarás varios servidores de OpenLDAP y deberás configurar la replicación como parte de una instalación de 13 nodos. Cada archivo requiere valores diferentes para LDAP_SID y LDAP_PEER.
Estás creando varios centros de datos como parte de una instalación de 12 nodos. Cada centro de datos requiere una configuración diferente para propiedades como ZK_CLIENT_HOSTS y CASS_HOSTS.

Archivo de configuración de ejemplo

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. También se muestran a continuación ejemplos de archivos de configuración 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 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=

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

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.
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.
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.
USE_LDAP_REMOTE_HOST LDAP_HOST LDAP_PORT	Si USE_LDAP_REMOTE_HOST es n, Edge instala OpenLDAP de forma automática cuando instala el servidor de administración. 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 LDAP. LDAP_PEER=10.0.0.1: Es la IP o el nombre de DNS del par de LDAP.
BIND_ON_ALL_INTERFACES	Si se establece en "y", el router o el Message Processor se vinculan (escuchan) en todas las interfaces (IP). Si se establece en “n”, el router o el Message Processor se vinculan (escuchan) en una interfaz específica, la IP que muestra el comando “hostname -i”).
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. 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. Consulta Instalación agrupada en clústeres de 12 hosts para obtener más información.
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 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. Consulta Instalación agrupada en clústeres de 12 hosts para obtener más información.
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. Consulta Instalación agrupada en clústeres de 12 hosts para obtener más información.
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.
PG_MASTER PG_STANDBY	Se configura para habilitar la replicación principal-en espera de Postgres, con el siguiente formato: PG_MASTER=*IPorDNSofNewMaster* PG_STANDBY=*IPorDNSofOldMaster*
SKIP_SMTP SMTPHOST SMTPUSER SMTPPASSWORD SMTPSSL SMTPPORT	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.

Orden de instalación de los componentes

El orden de instalación de los componentes se basa en la topología que desees.

En todos los ejemplos de instalación que se muestran a continuación, se supone que estás instalando lo siguiente:

Con la autenticación de Cassandra inhabilitada (predeterminada) Consulta Habilita la autenticación de Cassandra para obtener más información.
Con la replicación principal-en espera de Postgres inhabilitada (predeterminada). Consulta Configura la replicación principal en espera para Postgres para obtener más información.
Message Processor y Router en el mismo nodo. Si instalas los Message Processors y los routers en nodos diferentes, instala primero todos los Message Processors y, luego, todos los routers.

Archivos de registro de instalación

De forma predeterminada, la utilidad setup.sh escribe información de registro sobre la instalación en:

/opt/apigee/var/log/apigee-setup/setup.log

Si el usuario que ejecuta la utilidad setup.sh no tiene acceso a ese directorio, escribe el registro en el directorio /tmp como un archivo llamado setup_username.log.

Si el usuario no tiene acceso a /tmp, la utilidad setup.sh falla.