En este documento, se describe cómo agregar un centro de datos (también llamado región) a un centro de datos existente en el centro de atención.
Consideraciones antes de agregar un centro de datos
Antes de instalar un centro de datos, debes saber configurar OpenLDAP, Servidores ZooKeeper, Cassandra y Postgres en los centros de datos. Además, debes asegurarte de que el necesarios estén abiertos entre los nodos de los dos centros de datos.
- OpenLDAP
Cada centro de datos tiene su propio servidor OpenLDAP configurado con la replicación habilitada. Cuando instalar el nuevo centro de datos, debes configurar OpenLDAP para usar la replicación y volver a configurar el servidor OpenLDAP en el centro de datos existente para usar la replicación.
- ZooKeeper
En la propiedad
ZK_HOSTS
de ambos centros de datos, especificar las direcciones IP o los nombres de DNS de todos los nodos de ZooKeeper de ambos datos centros de datos en el mismo orden, y marcará los nodos con el modificador “:observer”. Los nodos que no tienen el modificador:observer
se llaman “votadores”. Debes tener un número extraño cantidad de "votantes" en tu configuración.En esta topología, el host de ZooKeeper en el host 9 es el observador:
En el ejemplo de archivo de configuración que se muestra a continuación, el nodo 9 se etiqueta con el
:observer
para que tengas cinco votantes: nodos 1, 2, 3, 7 y 8.Para
ZK_CLIENT_HOSTS
para cada centro de datos, especifica las direcciones IP o nombres de DNS solo de ZooKeeper nodos del centro de datos, en el mismo orden, para todos los nodos de ZooKeeper en el centro de atención. - Cassandra
Todos los centros de datos deben tener la misma cantidad de nodos Cassandra.
Para
CASS_HOSTS
de cada centro de datos, asegúrate de especificar todas las IP de Cassandra. (no nombres de DNS) para ambos datos locales. Para el centro de datos 1, enumera primero los nodos de Cassandra en ese centro de datos. Para centros de datos 2, enumera primero los nodos de Cassandra en ese centro de datos. Genera una lista de los nodos de Cassandra en la misma para todos los nodos de Cassandra en el centro de datos.Todos los nodos de Cassandra deben tener un sufijo ':d,r'; Por ejemplo: 'ip:1,1 = centro de datos 1 y bastidor/zona de disponibilidad 1 y 'ip:2,1 = centro de datos 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 192.168.124.205:2,1 192.168.124.206:2,1"
El primer nodo de la zona de disponibilidad o bastidor 1 de cada centro de datos se usará como origen servidor. En este modelo de implementación, la configuración de Cassandra se verá de la siguiente manera:
-
Postgres
De forma predeterminada, Edge instala todos los nodos de Postgres en el modo principal. Sin embargo, cuando tienes varios centros de datos, configurarás los nodos de Postgres para usar la replicación en espera de instancia principal, de modo que si la falla el nodo principal, el nodo en espera puede continuar con el tráfico del servidor. Por lo general, se configura el servidor Postgres principal en un centro de datos y el servidor en espera en el segundo en el centro de atención.
Si el centro de datos existente ya está configurado para ejecutar dos nodos de Postgres en modo principal/en espera; luego, como parte de este procedimiento, anula el registro del nodo en espera existente y reemplazarlo por un nodo en espera en el centro de datos nuevo.
En la siguiente tabla, se muestra la configuración de Postgres anterior y posterior para ambos, diferentes:
Antes Después Nodo principal de Postgres único en dc-1
Nodo principal de Postgres en dc-1
Nodo Postgres en espera en dc-2
Nodo principal de Postgres en dc-1
Nodo Postgres en espera en dc-1
Nodo principal de Postgres en dc-1
Nodo Postgres en espera en dc-2
Anula el registro del nodo Postgres anterior en espera en dc-1
- Requisitos de puerto
Debes asegurarte de que los puertos necesarios estén abiertos entre los nodos de los dos centros de datos. Para obtener un diagrama de puertos, consulta Requisitos de puertos.
Actualiza el centro de datos existente
Para agregar un centro de datos, debes seguir los pasos para instalar y configurar los datos nuevos del centro de datos original, sino que también debe actualizarlos en el centro de datos original. Estos son necesarias porque agregarás nuevos nodos Cassandra y ZooKeeper en los nuevos que deben ser accesibles para el centro de datos existente, y hay que OpenLDAP para usar la replicación.
Crea los archivos de configuración
A continuación, se muestran los archivos de configuración silenciosos para los dos centros de datos, donde cada dato tiene 6 nodos, como se muestra en Topologías de instalación. Observa que el archivo de configuración para dc-1 agrega parámetros de configuración adicionales para:
- Configurar OpenLDAP con replicación en dos nodos de OpenLDAP
- Agrega los nuevos nodos Cassandra y ZooKeeper de dc-2 al archivo de configuración de dc-1.
# Datacenter 1 IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP7=IPorDNSnameOfNode7 IP8=IPorDNSnameOfNode8 IP9=IPorDNSnameOfNode9 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 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" SKIP_SMTP=n SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com SMTPPASSWORD=smtppwd SMTPSSL=n SMTPPORT=25 SMTPMAILFROM="My Company <myco@company.com>" |
# Datacenter 2 IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP7=IPorDNSnameOfNode7 IP8=IPorDNSnameOfNode8 IP9=IPorDNSnameOfNode9 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 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" SKIP_SMTP=n SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com SMTPPASSWORD=smtppwd SMTPSSL=n SMTPPORT=25 SMTPMAILFROM="My Company <myco@company.com>" |
Agregar un centro de datos nuevo
Usa el siguiente procedimiento para instalar un centro de datos nuevo.
En el procedimiento, los centros de datos tienen los siguientes nombres:
- dc-1: El centro de datos existente
- dc-2: el nuevo centro de datos
Para agregar un centro de datos nuevo, sigue estos pasos:
- En dc-1, vuelve a ejecutar setup.sh en los nodos de Cassandra originales con el nuevo dc-1.
de configuración que incluye los nodos de Cassandra de dc-2:
/opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile1
- En dc-1, vuelve a ejecutar setup.sh en el nodo del servidor de administración:
/opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile1
- En dc-2, instala
apigee-setup
en todos los nodos. Consulta Instala la utilidad de Apigee-setup de Edge para obtener más información. información. - En dc-2, instala Cassandra y ZooKeeper en los nodos adecuados:
/opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile2
- En dc-2, ejecuta el comando de recompilación en todos los nodos de Cassandra y especifica la
Nombre de la región de dc-1:
/opt/apigee/apigee-cassandra/bin/nodetool [-u username -pw password] -h cassIP rebuild dc-1
Solo debes pasar tu nombre de usuario y contraseña si habilitar la autenticación JMX para Cassandra.
- En dc-2, instala el Servidor de administración en el nodo adecuado:
/opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile2
- En el nodo del servidor de administración en dc-2, instala
apigee-provision
. que instala la utilidadapigee-adminapi.sh
:/opt/apigee/apigee-service/bin/apigee-service apigee-provision install
- En dc-2, instala Routes and Message Processors en los nodos adecuados:
/opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile2
- En dc-2, instala Qpid en los nodos correspondientes:
/opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile2
- En dc-2, instala Postgres en el nodo adecuado:
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile2
- Configura la instancia principal o en espera de Postgres para los nodos de Postgres. El nodo de Postgres en dc-1 es el
y el nodo de Postgres en dc-2 es el servidor en espera.
- En el nodo principal de dc-1, edita el archivo de configuración para establecer lo siguiente:
PG_MASTER=IPorDNSofDC1Master PG_STANDBY=IPorDNSofDC2Standby
- Habilita la replicación en la instancia principal nueva:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFIle
- En el nodo en espera de dc-2, edita el archivo de configuración para establecer lo siguiente:
PG_MASTER=IPorDNSofDC1Master PG_STANDBY=IPorDNSofDC2Standby
- En el nodo en espera de dc-2, detén el servidor y, luego, borra cualquier
datos existentes de Postgres:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
rm -rf /opt/apigee/data/apigee-postgresql/
Si es necesario, puedes hacer una copia de seguridad de estos datos antes de borrarlos.
- Configura el nodo en espera en dc-2:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
- En el nodo principal de dc-1, edita el archivo de configuración para establecer lo siguiente:
- En dc-1, actualiza la configuración de análisis y configura las organizaciones.
- En el nodo del servidor de administración de dc-1, obtén el UUID de Postgres
nodo:
apigee-adminapi.sh servers list -r dc-1 -p analytics -t postgres-server \ --admin adminEmail --pwd adminPword --host localhost
El UUID aparece al final de los datos que se muestran. Guarda ese valor.
- En el nodo del servidor de administración de dc-2, obtén el UUID de Postgres como se muestra en el paso anterior. Guarda ese valor.
- En el nodo del Servidor de administración de dc-1, determina el nombre del
de Google Analytics y grupos de consumidores. Muchos de los siguientes comandos requieren esa información.
De forma predeterminada, el nombre del grupo de análisis es “axgroup-001” y el nombre del consumidor. grupo es "consumer-group-001". En el archivo de configuración silencioso de una región, puedes establecer el nombre del grupo de estadísticas con la propiedad
AXGROUP
Si no conoces los nombres de los grupos de analítica y de consumidores, usa los siguientes para mostrarlas:
apigee-adminapi.sh analytics groups list \ --admin adminEmail --pwd adminPword --host localhost
Este comando devuelve el nombre del grupo de análisis en el campo de nombre, y el grupo de consumidores en el campo consumer-groups.
- En el nodo de Management Server de dc-1, quita el Postgres existente
servidor desde el grupo de estadísticas:
- Quita el nodo de Postgres del grupo del consumidor:
apigee-adminapi.sh analytics groups consumer_groups datastores remove \ -g axgroup-001 -c consumer-group-001 -u UUID \ -Y --admin adminEmail --pwd adminPword --host localhost
Si dc-1 está configurado para tener dos nodos de Postgres en ejecución en modo principal/en espera, quita ambos:
apigee-adminapi.sh analytics groups consumer_groups datastores remove \ -g axgroup-001 -c consumer-group-001 -u "UUID_1,UUID_2" \ -Y --admin adminEmail --pwd adminPword --host localhost
- Quita el nodo de Postgres del grupo de estadísticas:
apigee-adminapi.sh analytics groups postgres_server remove \ -g axgroup-001 -u UUID -Y --admin adminEmail \ --pwd adminPword --host localhost
Si dc-1 está configurado para tener dos nodos de Postgres que se ejecutan en modo principal/en espera, quitar ambas:
apigee-adminapi.sh analytics groups postgres_server \ remove -g axgroup-001 -u UUID1,UUID2 -Y --admin adminEmail \ --pwd adminPword --host localhost
- Quita el nodo de Postgres del grupo del consumidor:
- En el nodo del servidor de administración de dc-1, agrega la nueva instancia principal o en espera.
Servidores de Postgres al grupo de estadísticas:
- Agrega ambos servidores de Postgres al grupo de estadísticas:
apigee-adminapi.sh analytics groups postgres_server \ add -g axgroup-001 -u "UUID_1,UUID_2" --admin adminEmail \ --pwd adminPword --host localhost
Ehere, UUID_1 corresponde al nodo principal de Postgres en dc-1, y UUID_2 corresponde al Postgres en espera en dc-2.
- Agrega los servidores de PG al grupo del consumidor como principal o en espera:
apigee-adminapi.sh analytics groups consumer_groups datastores \ add -g axgroup-001 -c consumer-group-001 -u "UUID_1,UUID_2" --admin adminEmail \ --pwd adminPword --host localhost
- Agrega ambos servidores de Postgres al grupo de estadísticas:
- Agrega los servidores Qpid de dc-2 al grupo de estadísticas:
- En el nodo del servidor de administración de dc-1, obtén los UUID del Qpid
Nodos en dc-2:
apigee-adminapi.sh servers list -r dc-2 -p central -t qpid-server \ --admin adminEmail --pwd adminPword --host localhost
Los UUID aparecen al final de los datos que se muestran. Guarda esos valores.
- En el nodo del servidor de administración de dc-1, agrega los nodos de Qpid al nodo
Analytics group (ejecuta ambos comandos):
apigee-adminapi.sh analytics groups qpid_server \ add -g axgroup-001 -u "UUID_1" --admin adminEmail \ --pwd adminPword --host localhost
apigee-adminapi.sh analytics groups qpid_server \ add -g axgroup-001 -u "UUID_2" --admin adminEmail \ --pwd adminPword --host localhost
- En el nodo del servidor de administración de dc-1, agrega los nodos de Qpid al nodo
consumidor (ejecuta ambos comandos):
apigee-adminapi.sh analytics groups consumer_groups consumers \ add -g axgroup-001 -c consumer-group-001 -u "UUID_1" \ --admin adminEmail --pwd adminPword --host localhost
apigee-adminapi.sh analytics groups consumer_groups consumers \ add -g axgroup-001 -c consumer-group-001 -u "UUID_2" \ --admin adminEmail --pwd adminPword --host localhost
- En el nodo del servidor de administración de dc-1, obtén los UUID del Qpid
Nodos en dc-2:
- Anula el registro y borra el servidor en espera anterior de Postgres de dc-1:
- Anula el registro del servidor en espera dc-1 de Postgres existente:
apigee-adminapi.sh servers deregister -u UUID -r dc-1 \ -p analytics -t postgres-server -Y --admin adminEmail \ --pwd adminPword --host localhost
Donde UUID es el nodo de Postgres anterior en espera en dc-1.
- Borra el servidor en espera dc-1 de Postgres existente:
apigee-adminapi.sh servers delete -u UUID \ --admin adminEmail --pwd adminPword --host localhost
- Anula el registro del servidor en espera dc-1 de Postgres existente:
- En el nodo del servidor de administración de dc-1, obtén el UUID de Postgres
nodo:
- Actualizar los espacios de claves de Cassandra con el factor de replicación correcto para los dos centros de datos Tú
solo tendrás que ejecutar este paso una vez en cualquier servidor Cassandra en cualquiera de los centros de datos:
- Inicia la utilidad
cqlsh
de Cassandra:/opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
- Ejecuta los siguientes comandos de CQL en “cqlsh>” para configurar la replicación
para los espacios de claves de Cassandra:
ALTER KEYSPACE "identityzone" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
ALTER KEYSPACE "system_traces" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
- Para ver los espacios de claves, usa el siguiente comando:
select * from system.schema_keyspaces;
- Salga de
cqlsh
:exit
- Inicia la utilidad
- Ejecuta el siguiente comando
nodetool
en todos los nodos de Cassandra en dc-1 para obtener una versión gratuita. memoria:/opt/apigee/apigee-cassandra/bin/nodetool [-u username -pw password] -h cassandraIP cleanup
Solo debes pasar tu nombre de usuario y contraseña si habilitar la autenticación JMX para Cassandra.
- Para cada organización y entorno que quieras admitir en todos los centros de datos:
- En el nodo del servidor de administración de dc-1, agrega el nuevo MP_POD al
Organización:
apigee-adminapi.sh orgs pods add -o orgName -r dc-2 -p gateway-2 \ --admin adminEmail --pwd adminPword --host localhost
Donde gateway-2 es el nombre del Pod de puerta de enlace según lo define el MP_POD en el archivo de configuración de dc-2.
- Agrega los nuevos Message Processor a la organización y al entorno:
- En el nodo del servidor de administración de dc-2, obtén los UUID del
Nodos del procesador de mensajes en dc-2:
apigee-adminapi.sh servers list -r dc-2 -p gateway-2 \ -t message-processor --admin adminEmail --pwd adminPword --host localhost
Los UUID aparecen al final de los datos que se muestran. Guarda esos valores.
- En el nodo del Servidor de administración de dc-1, para cada Procesador de mensajes
en dc-2, agrega Message Processor a un entorno para la organización:
apigee-adminapi.sh orgs envs servers add -o orgName -e envName \ -u UUID --admin adminEmail --pwd adminPword --host localhost
- En el nodo del servidor de administración de dc-2, obtén los UUID del
Nodos del procesador de mensajes en dc-2:
- En el nodo del servidor de administración de dc-1, verifica la organización:
apigee-adminapi.sh orgs apis deployments -o orgName -a apiProxyName \ --admin adminEmail --pwd adminPword --host localhost
En el ejemplo anterior, apiProxyName es el nombre de un proxy de API implementado en la organización.
- En el nodo del servidor de administración de dc-1, agrega el nuevo MP_POD al
Organización: