Se usó la API de Cloud Translation para traducir esta página.

Instala componentes de Edge en un nodo

Edge para la nube privada v. 4.16.09

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 que component es el componente de Edge que se instalará y configFile es el archivo de configuración silencioso que contiene la información de instalación. El usuario de “apigee” debe poder acceder o leer el archivo de configuración. Por ejemplo, puedes crear un directorio nuevo para los archivos y colocarlos en el directorio /usr/local o /usr/local/share, o en cualquier otro lugar del nodo al que pueda acceder el usuario de “apigee”.

Por ejemplo, para instalar el servidor de administración perimetral, sigue estos pasos:

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

Consideraciones de instalación

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

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

De forma predeterminada, Edge instala todos los nodos de Postgres en el modo principal. Sin embargo, en los sistemas de producción con varios nodos de Postgres, debes configurarlos para que usen la replicación de instancia 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 la instancia principal en espera durante la instalación mediante las propiedades del archivo de configuración silencioso. O bien, puedes habilitar la replicación de la instancia principal en espera después de la instalación. Si deseas obtener más información, consulta Configura la replicación de instancia principal en espera para Postgres.

Habilita la autenticación de Cassandra

De forma predeterminada, Cassandra se instala sin habilitar la autenticación. Eso 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 mediante las propiedades del archivo de configuración silencioso. O bien, puedes habilitarla después de la instalación.

Para obtener más información, consulta Cómo habilitar la autenticación de Cassandra.

Cómo vincular el router a un puerto protegido

Si deseas vincular el router a un puerto protegido, como números de puerto inferiores a 1,024, 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 puertos con privilegios.

Para ejecutar el router como un usuario diferente, sigue estos pasos:

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 perimetral-router reinicial

Cómo especificar los componentes para instalar

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	Solo instala Cassandra.
sem	instalar solo ZooKeeper.
ds	Instala ZooKeeper y Cassandra.
ld	Solo instala OpenLDAP.
ms	Instala Edge Management Server, 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	Solo instala el router perimetral.
mp	Instala únicamente el procesador de mensajes perimetrales.
rmp	Instala el router perimetral y el procesador de mensajes.
ui	Instala la IU de Edge.
qs	Solo instala Qpid Server.
ps	Solo instala el servidor de Postgres.
saxofón	Instala los componentes de Analytics, es decir, Qpid y Postgres. Usa esta opción solo para desarrollo y pruebas, no para producción.
mes	Instala la monetización.
sa	Instala Edge de forma independiente, es decir, Cassandra, ZooKeeper, Management Server, OpenLDAP, IU de Edge, router y procesador de mensajes. Esta opción omite los componentes de Edge Analytics: Qpid y Postgres. Usa esta opción solo para desarrollo y pruebas, no para producción.
IA	Instala todos los componentes en un solo nodo. Usa esta opción solo para desarrollo y pruebas, no para 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, deberás usar diferentes archivos de configuración o modificar el archivo en los siguientes casos:

Estás instalando varios servidores de OpenLDAP y necesitas 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 completo y silencioso 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. A continuación, también se muestran 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.

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

Propiedad	Nota
Nombres de IP o 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 ser accesible el usuario de “apigee”. Por ejemplo, almacénalo en el directorio /tmp y 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 automáticamente OpenLDAP cuando instala el servidor de administración. Establece USE_LDAP_REMOTE_HOST en y si te estás conectando a un servidor LDAP remoto. OpenLDAP no está instalado con el servidor de administración. 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 replicación. Si tu topología perimetral usa un solo servidor 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: ID único para 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 - Nombre de IP o DNS del par de LDAP.
BIND_ON_ALL_INTERFACES	Si se establece en "y", el router o procesador de mensajes vinculará (escuchar) en todas las interfaces (IP). Si se configura como “n”, el router o procesador de mensajes vinculará (escuchar) en una interfaz específica, la IP que muestra el comando “nombre de host -i”).
MP_POD	Especifica el nombre del Pod de Message Processor y 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 de número entero. Por ejemplo, dc-1, dc-2, etc. Puedes usar dc-1, a menos que la instales 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 estés instalando. Sin embargo, no estás restringido a usar solo nombres con el formato dc-#. Puedes usar cualquier nombre para la región.
ZK_HOSTS	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 “:observar” en los nodos de ZooKeeper solo cuando creas varios centros de datos, como se describe en una instalación de 12 hosts. En una instalación de centro de datos único, omite ese modificador. Consulta Instalación en clústeres de 12 hosts para obtener más información.
ZK_CLIENT_HOSTS	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 única instalación de 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 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 “:dc,ra” opcional 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 centro de datos único, 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 problemas de firewall, las CASS_HOSTS deben ordenarse de una 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 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	Configura la replicación de la instancia 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 de 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 deseada.

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 (predeterminado). Consulta Habilitar la autenticación de Cassandra para obtener más información.
Con la replicación de instancia principal en espera de Postgres inhabilitada (predeterminado). Consulta Configura la replicación de la instancia principal en espera para Postgres a fin de obtener más información.
Procesador de mensajes y router en el mismo nodo. Si instalas Message Processor y Routers en diferentes nodos, primero debes instalar todos los Message Processor y, luego, todos los routers.

Archivos de registro de la instalación

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

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

Si el usuario que ejecuta la utilidad setup.sh no tiene acceso a ese directorio, escribirá 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.