Instala componentes de Edge en un nodo

Edge para la nube privada v. 4.17.01

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.

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

Usa un puerto protegido cuando se crea un host virtual

Si deseas crear un host virtual que vincule el router a un puerto protegido, como números de puerto inferiores a 1,000, 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.

Si deseas obtener información a fin de configurar un host virtual y un router para acceder a puertos inferiores a 1,000, consulta Configura un host virtual.

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.

PDB Instala la base de datos Postgres únicamente; se usa solo cuando se instala el portal de servicios para desarrolladores. Consulta Instalación del portal de servicios para desarrolladores.

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.

dp

Instalar el portal de servicios para desarrolladores

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.

Cada topología de instalación que se describe a continuación muestra un archivo de configuración de ejemplo para esa topología. Para obtener una referencia completa sobre el archivo de configuración, consulta Referencia del archivo de configuración de Edge.

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.

Instala componentes de Edge

En esta sección, se describe cómo instalar los componentes de Edge para las diferentes topologías. 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:

Instalación todo en uno

  1. Instala todos los componentes en un solo nodo con el comando:
    >/opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
  2. Prueba la instalación como se describe en Cómo probar la instalación.
  3. Integra tu organización como se describe en Integra una organización.

A continuación, se muestra un archivo de configuración silencioso para esta topología. Para obtener una referencia completa sobre el archivo de configuración, consulta Referencia del archivo de configuración de Edge.

# With SMTP
IP1=IPorDNSnameOfNode
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
LDAP_TYPE=1
APIGEE_LDAPPW=secret
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway
REGION=dc-1
ZK_HOSTS="$IP1"
ZK_CLIENT_HOSTS="$IP1"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1"
# Default is postgres
PG_PWD=postgres
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd    
# omit for no password
SMTPSSL=n
SMTPPORT=25

Instalación independiente de 2 hosts

Consulta Topologías de instalación para ver la lista de topologías de Edge y números de nodos.

  1. Instala la puerta de enlace independiente y el nodo 1
    >/opt/apigee/apigee-setup/bin/setup.sh -p sa -f configFile
  2. Instala Analytics en el nodo 2:
    >/opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
  3. Prueba la instalación como se describe en Cómo probar la instalación.
  4. Integra tu organización como se describe en Integra una organización.

A continuación, se muestra un archivo de configuración silencioso para esta topología. Para obtener una referencia completa sobre el archivo de configuración, consulta Referencia del archivo de configuración de Edge.

# With SMTP
IP1=IPorDNSnameOfNode1
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
LDAP_TYPE=1
APIGEE_LDAPPW=secret
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway
REGION=dc-1
ZK_HOSTS="$IP1"
ZK_CLIENT_HOSTS="$IP1"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1"
# Default is postgres
PG_PWD=postgres
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd    
# omit for no password
SMTPSSL=n
SMTPPORT=25

Instalación agrupada en clústeres de 5 hosts

Consulta Topologías de instalación para ver la lista de topologías de Edge y números de nodos.

  1. Instala el clúster de Datastore en los nodos 1, 2 y 3:
    >/opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Instala Management Server en el nodo 1:
    >/opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. Instala el router y el procesador de mensajes en los nodos 2 y 3:
    >/opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. Instala Analytics en los nodos 4 y 5:
    >/opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
  5. Prueba la instalación como se describe en Cómo probar la instalación.
  6. Integra tu organización como se describe en Integra una organización.

A continuación, se muestra un archivo de configuración silencioso para esta topología. Para obtener una referencia completa sobre el archivo de configuración, consulta Referencia del archivo de configuración de Edge.

# With SMTP
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP4=IPorDNSnameOfNode4
IP5=IPorDNSnameOfNode5
 HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@google.com 
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt 
MSIP=$IP1 
USE_LDAP_REMOTE_HOST=n 
LDAP_TYPE=1
APIGEE_LDAPPW=secret 
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway
REGION=dc-1 
ZK_HOSTS="$IP1 $IP2 $IP3" 
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" 
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1 $IP2 $IP3" 
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP4
PG_STANDBY=$IP5
SKIP_SMTP=n
SMTPHOST=smtp.example.com 
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd       
# omit for no password 
SMTPSSL=n
SMTPPORT=25

Instalación agrupada en clústeres de 9 hosts

Consulta Topologías de instalación para ver la lista de topologías de Edge y números de nodos.

  1. Instala el nodo del clúster de Datastore en los nodos 1, 2 y 3:
    >/opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Instala Apigee Management Server en el nodo 1:
    >/opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. Instala el router y el procesador de mensajes en los nodos 4 y 5:
    >/opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. Instala Apigee Analytics Qpid Server en los nodos 6 y 7:
    >/opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. Instala el servidor Postgres de Apigee Analytics en los nodos 8 y 9:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. Prueba la instalación como se describe en Cómo probar la instalación.
  7. Integra tu organización como se describe en Integra una organización.

A continuación, se muestra un archivo de configuración silencioso para esta topología. Para obtener una referencia completa sobre el archivo de configuración, consulta Referencia del archivo de configuración de Edge.

# With SMTP
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@google.com 
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt 
MSIP=$IP1 
USE_LDAP_REMOTE_HOST=n 
LDAP_TYPE=1
APIGEE_LDAPPW=secret 
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway
REGION=dc-1 
ZK_HOSTS="$IP1 $IP2 $IP3" 
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" 
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1 $IP2 $IP3" 
# Default is postgres
PG_PWD=postgres
SKIP_SMTP=n
PG_MASTER=$IP8
PG_STANDBY=$IP9
SMTPHOST=smtp.example.com 
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd       
# omit for no password
SMTPSSL=n
SMTPPORT=25

Instalación agrupada en clústeres de 13 hosts

Consulta Topologías de instalación para ver la lista de topologías de Edge y números de nodos.

  1. Instala el nodo del clúster de Datastore en los nodos 1, 2 y 3:
    >/opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Instala OpenLDAP en los nodos 4 y 5:
    >/opt/apigee/apigee-setup/bin/setup.sh -p ld -f configFile
  3. Instala Apigee Management Server en el nodo 6 y 7:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  4. Instala el servidor Postgres de Apigee Analytics en los nodos 8 y 9:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  5. Instala el router y el procesador de mensajes en los nodos 10 y 11:
    > /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  6. Instala Apigee Analytics Qpid Server en los nodos 12 y 13:
    >/opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  7. Prueba la instalación como se describe en Cómo probar la instalación.
  8. Integra tu organización como se describe en Integra una organización.

A continuación, se muestra un archivo de configuración silencioso para esta topología. Para obtener una referencia completa sobre el archivo de configuración, consulta Referencia del archivo de configuración de Edge.

# For all components except OpenLDAP
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP4=IPorDNSnameOfNode4
IP5=IPorDNSnameOfNode5
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@google.com 
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt 
# First Management Server on IP6
MSIP=$IP6 
USE_LDAP_REMOTE_HOST=y
LDAP_HOST=$IP4
LDAP_PORT=10389
# Second Management Server on IP7
# MSIP=$IP7
# USE_LDAP_REMOTE_HOST=y
# LDAP_HOST=$IP5
# LDAP_PORT=10389
# Same password for both OpenLDAPs.
APIGEE_LDAPPW=secret 
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway
REGION=dc-1 
ZK_HOSTS="$IP1 $IP2 $IP3" 
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" 
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1 $IP2 $IP3" 
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP8
PG_STANDBY=$IP9
SKIP_SMTP=n
SMTPHOST=smtp.example.com 
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd       
# omit for no password
SMTPSSL=n
SMTPPORT=25
# For OpenLDAP on IP4 and IP5
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP4=IPorDNSnameOfNode4
IP5=IPorDNSnameOfNode5
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@google.com 
APIGEE_ADMINPW=Secret123
# First OpenLDAP Server on IP4
MSIP=$IP6 
USE_LDAP_REMOTE_HOST=n 
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP5
# Second OpenLDAP Server on IP5
# MSIP=$IP7 
# USE_LDAP_REMOTE_HOST=n 
# LDAP_TYPE=2
# LDAP_SID=2
# LDAP_PEER=$IP4
# Set same password for both OpenLDAPs.
APIGEE_LDAPPW=secret 

Instalación agrupada en clústeres de 12 hosts

Antes de instalar Edge en la topología agrupada en clústeres de host a12 (dos centros de datos), debes comprender cómo configurar las propiedades de ZooKeeper y Cassandra en el archivo de configuración silencioso.

  • ZooKeeper

    Para la propiedad ZK_HOSTS de ambos centros de datos, especifica las direcciones IP o los nombres de DNS de todos los nodos de ZooKeeper de ambos centros de datos, en el mismo orden, y marca cualquier nodo con el modificador “:observar”. Los nodos sin el modificador “:observar” se denominan “votantes”. Debes tener un número impar de "votantes" en tu configuración.

    En esta topología, el host de ZooKeeper en el host 9 es el observador:

    En la propiedad ZK_CLIENT_HOSTS de cada centro de datos, especifica las direcciones IP o los nombres de DNS solo de los nodos de ZooKeeper en el centro de datos, en el mismo orden, para todos los nodos de ZooKeeper en el centro de datos. En el archivo de configuración de ejemplo que se muestra a continuación, el nodo 9 está etiquetado con el modificador ":observar" para que tengas cinco votantes: Nodos 1, 2, 3, 7 y 8.
  • Cassandra
    Todos los centros de datos deben tener la misma cantidad de nodos de Cassandra.

    En el caso de CASS_HOSTS para cada centro de datos, asegúrate de especificar todas las direcciones IP de Cassandra (no nombres de DNS) para ambos. Para el centro de datos 1, primero enumera los nodos de Cassandra en ese centro de datos. Para el centro de datos 2, primero enumera los nodos de Cassandra en ese centro de datos. Enumera los nodos de Cassandra en el mismo orden para todos los nodos de Cassandra del centro de datos.

    Todos los nodos de Cassandra deben tener un sufijo “:<d>,<r>”, por ejemplo “<ip>:1,1 = datacenter 1 y bastidor/zona de disponibilidad 1 y “<ip>:2,1 = datacenter 2 y bastidor/zona de disponibilidad 1”.
    Por ejemplo, “192.168.124.201:1,1 192.168.124.202:1,1 192.168.124.203:1,1 192.168.124.204:2,1 nodo 192.168.12.121.2



    En este modelo de implementación, la configuración de Cassandra se verá de la siguiente manera:

Consulta Topologías de instalación para ver la lista de topologías de Edge y números de nodos.

  1. Instala el nodo del clúster de Datastore en los nodos 1, 2, 3, 7, 8 y 9:
    >/opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Instala Apigee Management Server con replicación de OpenLDAP en los nodos 1 y 7:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. Instala el router y el procesador de mensajes en los nodos 2, 3, 8 y 9:
    > /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. Instala Apigee Analytics Qpid Server en los nodos 4, 5, 10 y 11:
    >/opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. Instala el servidor Postgres de Apigee Analytics en el nodo 6 y 12:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. Prueba la instalación como se describe en Cómo probar la instalación.
  7. Integra tu organización como se describe en Integra una organización.

A continuación, se muestra un archivo de configuración silencioso para esta topología. Observa este archivo de configuración. Para obtener una referencia completa sobre el archivo de configuración, consulta Referencia del archivo de configuración de Edge.

  • Configura OpenLDAP con replicación en dos nodos de OpenLDAP.
  • Especifica el modificador “:observar” en un nodo de ZooKeeper. En una instalación de centro de datos único, omite ese modificador.
# Datacenter 1
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9 
IP12=IPorDNSnameOfNode12
HOSTIP=$(hostname -i)
MSIP=$IP1
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP7
APIGEE_LDAPPW=secret
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway-1
REGION=dc-1
ZK_HOSTS="$IP1 $IP2 $IP3 $IP7 $IP8 $IP9:observer"
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1 $IP7:2,1 $IP8:2,1 $IP9:2,1"
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP6
PG_STANDBY=$IP12
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com 
# omit for no username
SMTPPASSWORD=smtppwd   
# omit for no password
SMTPSSL=n
SMTPPORT=25
# Datacenter 2
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9 
IP12=IPorDNSnameOfNode12
HOSTIP=$(hostname -i)
MSIP=$IP7
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=2
LDAP_PEER=$IP1
APIGEE_LDAPPW=secret
BIND_ON_ALL_INTERFACES=y
MP_POD=gateway-2
REGION=dc-2
ZK_HOSTS="$IP1 $IP2 $IP3 $IP7 $IP8 $IP9:observer"
ZK_CLIENT_HOSTS="$IP7 $IP8 $IP9"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP7:2,1 $IP8:2,1 $IP9:2,1 $IP1:1,1 $IP2:1,1 $IP3:1,1"
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP6
PG_STANDBY=$IP12
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com 
# omit for no username
SMTPPASSWORD=smtppwd   
# omit for no password
SMTPSSL=n
SMTPPORT=25