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

Cómo agregar un centro de datos

Edge para la nube privada v4.18.01

En este documento, se describe cómo agregar un centro de datos (también llamado región) a un centro de datos existente.

Consideraciones antes de agregar un centro de datos

Antes de instalar un centro de datos, debes comprender cómo configurar los servidores OpenLDAP, ZooKeeper, Cassandra y Postgres en todos los centros de datos. También debes asegurarte de que los puertos 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 instales el nuevo centro de datos, debes configurar OpenLDAP para usar la replicación y debes volver a configurar el servidor OpenLDAP en el centro de datos existente para usar la replicación.
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 los nodos con el modificador “:observer”. Los nodos sin el modificador “:observer” se denominan “votantes”. Debes tener una cantidad impar de "votantes" en tu configuración.

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

En el archivo de configuración de ejemplo que se muestra a continuación, el nodo 9 se etiqueta con el modificador “:observer” para que tengas cinco votantes: nodos 1, 2, 3, 7 y 8.

Para 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.
Cassandra
Todos los centros de datos deben tener la misma cantidad de nodos de Cassandra.

Para CASS_HOSTS de cada centro de datos, asegúrate de especificar todas las direcciones IP de Cassandra (no los nombres de DNS) para ambos centros de datos. 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. Muestra los nodos de Cassandra en el mismo orden 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 en el bastidor o la zona de disponibilidad 1 de cada centro de datos se usará como servidor de origen. 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, configuras los nodos de Postgres para que usen la replicación en espera de instancia principal, de modo que, si falla el nodo principal, el nodo en espera pueda continuar con el tráfico del servidor. Por lo general, debes configurar el servidor principal de Postgres en un centro de datos y el servidor en espera en el segundo.

Si el centro de datos existente ya está configurado para tener dos nodos de Postgres en ejecución en modo principal/en espera, como parte de este procedimiento, anula el registro del nodo en espera existente y reemplázalo por un nodo en espera en el centro de datos nuevo.

En la siguiente tabla, se muestra la configuración de Postgres antes y después para ambas situaciones:

Antes	Después
Nodo principal de Postgres único en dc-1	Nodo principal de Postgres en dc-1 Nodo de Postgres en espera en dc-2
Nodo principal de Postgres en dc-1 Nodo de Postgres en espera en dc-1	Nodo principal de Postgres en dc-1 Nodo de Postgres en espera en dc-2 Anula el registro del nodo Postgres anterior en espera en dc-1

Antes

Después

Nodo principal de Postgres único en dc-1

Nodo principal de Postgres en dc-1

Nodo de Postgres en espera en dc-2

Nodo principal de Postgres en dc-1

Nodo de Postgres en espera en dc-1

Nodo principal de Postgres en dc-1

Nodo de Postgres en espera en dc-2

Anula el registro del nodo Postgres anterior en espera en dc-1

Requisitos de puertos
Debes asegurarte de que los puertos necesarios estén abiertos entre los nodos de los dos centros de datos. Para ver un diagrama de puertos, consulta Requisitos de instalación.

Actualiza el centro de datos existente

Para agregar un centro de datos, debes seguir los pasos para instalar y configurar los nodos nuevos del centro de datos, pero también debes actualizar los nodos del centro de datos original. Estas modificaciones son necesarias porque estás agregando nuevos nodos Cassandra y ZooKeeper en el centro de datos nuevo, que deben ser accesibles para el centro de datos existente, y debes volver a configurar OpenLDAP para usar la replicación.

Crea los archivos de configuración

A continuación, se muestran los archivos de configuración silenciosos de los dos centros de datos, en los que cada centro de datos tiene 6 nodos, como se muestra en Topologías de instalación. Ten en cuenta que el archivo de configuración de dc-1 agrega parámetros de configuración adicionales a los siguientes elementos:

Configura OpenLDAP con replicación en dos nodos de OpenLDAP.
Agrega los nuevos nodos de 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>"

Procedimiento para agregar un nuevo centro de datos

En este procedimiento, los centros de datos se denominan de la siguiente manera:

dc-1: Es el centro de datos existente.
dc-2: Es el nuevo centro de datos.

En dc-1, vuelve a ejecutar setup.sh en los nodos de Cassandra originales con el nuevo archivo de configuración dc-1 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 Cómo instalar la utilidad apigee-setup de Edge para obtener más 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 reconstrucción en todos los nodos de Cassandra y especifica el nombre de la región de dc-1:
> /opt/apigee/apigee-cassandra/bin/nodetool -h cassIP rebuild dc-1
En dc-2, instala el servidor de administración en el nodo apropiado:
> /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 utilidad apigee-adminapi.sh:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
En dc-2, instala las rutas y los procesadores de mensajes 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 apropiado:
> /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 principal, y el nodo de Postgres en dc-2 es el servidor de resguardo.

Nota: Si dc-1 ya está configurado para tener dos nodos de Postgres en ejecución en modo principal/en espera, como parte de este procedimiento, usa el nodo principal existente de Postgres en dc-1 como el principal y el nodo de Postgres en dc-2 como el servidor en espera. Más adelante en este procedimiento, cancelarás el registro del servidor en espera de Postgres existente en dc-1.
1. En el nodo principal de dc-1, edita el archivo de configuración para establecer lo siguiente:
  PG_MASTER=IPorDNSofDC1Master
  PG_STANDBY=IPorDNSofDC2Standby
2. Habilita la replicación en el nuevo maestro:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFIle
3. En el nodo de espera de dc-2, edita el archivo de configuración para establecer lo siguiente:
  PG_MASTER=IPorDNSofDC1Master
  PG_STANDBY=IPorDNSofDC2Standby
4. En el nodo de reserva en dc-2, detén el servidor y, luego, borra los datos existentes de Postgres:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
  > rm -rf /opt/apigee/data/apigee-postgresql/
  Nota: Si es necesario, puedes crear una copia de seguridad de estos datos antes de borrarlos.
5. Configura el nodo en espera en dc-2:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-waitby -f configFile
En dc-1, actualiza la configuración de Analytics y configura las organizaciones.
1. En el nodo del servidor de administración de dc-1, obtén el UUID del nodo de Postgres:
  > 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.
  
  Nota: Si dc-1 está configurado para tener dos nodos de Postgres que se ejecutan en modo principal/en espera, verás dos direcciones IP y un UUID en el resultado. Guarda ambos UUID. A partir de las IP, deberías poder determinar qué UUID es para el nodo principal y cuál es para el nodo de reserva.
2. En el nodo del servidor de administración de dc-2, obtén el UUID del nodo de Postgres como se muestra en el paso anterior. Guarda ese valor.
3. En el nodo del servidor de administración de dc-1, determina el nombre de los grupos de consumidores y de estadísticas. Muchos de los comandos que se indican a continuación requieren esa información.
  De forma predeterminada, el nombre del grupo de estadísticas es axgroup-001 y el nombre del grupo de consumidores 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 estadísticas y de consumidores, usa el siguiente comando para mostrarlos:
  > apigee-adminapi.sh analytics groups list --admin adminEmail --pwd adminPword --host localhost
  
  Este comando muestra el nombre del grupo de estadísticas en el campo de nombre y el nombre del grupo de consumidores en el campo de grupos de consumidores.
4. En el nodo del servidor de administración de dc-1, quita el servidor Postgres existente del grupo de análisis:
  1. Quita el nodo de Postgres del grupo de consumidores:
    > 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 el modo principal o 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
  2. > > Apigee-admin.adminapi..
    
    UUID
5. En el nodo del servidor de administración de dc-1, agrega los nuevos servidores Postgres principales o de resguardo al grupo de análisis:
  1. Agrega ambos servidores 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
    
    donde UUID_1 corresponde al nodo de Postgres_1 y dc-12 corresponde al nodo de la instancia principal en Postgres, y dc-12
Actualiza los espacios de claves de Cassandra con el factor de replicación correcto para los dos centros de datos. Solo debes ejecutar este paso una vez en cualquier servidor de Cassandra en cualquiera de los centros de datos:

Nota: Todos los comandos que se indican a continuación establecen el factor de replicación en “3”, lo que indica tres nodos de Cassandra en el clúster. Modifica este valor según sea necesario para tu instalación.
1. Inicia la utilidad cqlsh de Cassandra:
  > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
2. Ejecuta los siguientes comandos de CQL en el mensaje "cqlsh>" para establecer los niveles de replicación de los espacios de claves de Cassandra:
  1. cqlsh> ALTER KEYSPACE "identityzone" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
  2. cqlsh> ALTER KEYSPACE "system_traces" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
  3. Para ver los espacios de claves, usa el comando:
    cqlsh> select * from system.schema_keyspaces;
  4. Salir de cqlsh:
    cqlsh> exit
Ejecuta el siguiente comando nodetool en todos los nodos de Cassandra en dc-1 para liberar memoria:
> /opt/apigee/apigee-cassandra/bin/nodetool -h cassandraIP cleanup
Para cada organización y cada entorno que quieras admitir en los centros de datos, haz lo siguiente:
1. En el nodo del servidor de administración de dc-1, agrega el MP_POD nuevo a la 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 de la puerta de enlace config-dc del host config.
2. Agrega los nuevos procesadores de mensajes a la organización y al entorno:
  1. En el nodo del servidor de administración de dc-2, obtén los UUIDs de los 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 UUIDs aparecen al final de los datos que se muestran. Guarda esos valores.
  2. En el nodo del servidor de administración de dc-1, para cada procesador de mensajes en dc-2, agrega el procesador de mensajes 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
3. 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
  
  donde apiProxyName es el nombre de un proxy de API implementado en la organización.