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 |
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 |
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 |
LDAP_TYPE |
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:
|
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_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 |
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.
Instalación todo en uno
- Instala todos los componentes en un solo nodo con el comando:
>/opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile - Prueba la instalación como se describe en Cómo probar la instalación.
- 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:
# With SMTP IP1=IPorDNSnameOfNode HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@apigee.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" 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.
- Instala la puerta de enlace independiente y el nodo 1
>/opt/apigee/apigee-setup/bin/setup.sh -p sa -f configFile - Instala Analytics en el nodo 2:
>/opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile - Prueba la instalación como se describe en Cómo probar la instalación.
- 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:
# With SMTP IP1=IPorDNSnameOfNode1 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@apigee.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" 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.
- Instala el clúster de Datastore en los nodos 1, 2 y 3:
>/opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile - Instala Management Server en el nodo 1:
>/opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile - 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 - Instala Analytics en los nodos 4 y 5:
>/opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile - Prueba la instalación como se describe en Cómo probar la instalación.
- 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:
# With SMTP IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP4=IPorDNSnameOfNode4 IP5=IPorDNSnameOfNode5 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@apigee.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" 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.
- 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 - Instala Apigee Management Server en el nodo 1:
>/opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile - 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 - Instala Apigee Analytics Qpid Server en los nodos 6 y 7:
>/opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile - Instala el servidor Postgres de Apigee Analytics en los nodos 8 y 9:
> /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile - Prueba la instalación como se describe en Cómo probar la instalación.
- 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:
# With SMTP IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP8=IPorDNSnameOfNode8 IP9=IPorDNSnameOfNode9 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@apigee.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" 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.
- 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 - Instala OpenLDAP en los nodos 4 y 5:
>/opt/apigee/apigee-setup/bin/setup.sh -p ld -f configFile - Instala Apigee Management Server en el nodo 6 y 7:
> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile - Instala el servidor Postgres de Apigee Analytics en los nodos 8 y 9:
> /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile - 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 - Instala Apigee Analytics Qpid Server en los nodos 12 y 13:
>/opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile - Prueba la instalación como se describe en Cómo probar la instalación.
- 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:
# 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@apigee.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" 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@apigee.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.
- 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 - 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 - 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 - Instala Apigee Analytics Qpid Server en los nodos 4, 5, 10 y 11:
>/opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile - Instala el servidor Postgres de Apigee Analytics en el nodo 6 y 12:
> /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile - Prueba la instalación como se describe en Cómo probar la instalación.
- 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:
- 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@apigee.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" 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@apigee.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" 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 |