Cómo agregar un centro de datos

Edge para nube privada v4.18.05

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 de OpenLDAP, ZooKeeper, Cassandra y Postgres en 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 de OpenLDAP configurado con la replicación habilitada. Cuando instales el nuevo centro de datos, debes configurar OpenLDAP para que use la replicación y debes volver a configurar el servidor de OpenLDAP en el centro de datos existente para que use la replicación.

  • ZooKeeper

    En 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: los nodos 1, 2, 3, 7 y 8.

    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.

  • Cassandra

    Todos los centros de datos deben tener la misma cantidad de nodos de Cassandra.

    En CASS_HOSTS para 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, enumera primero los nodos de Cassandra en ese centro de datos. Para el centro de datos 2, enumera primero los nodos de Cassandra en ese centro de datos. Enumera 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 el 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 modo principal. Sin embargo, cuando tienes varios centros de datos, configuras los nodos de Postgres para que usen la replicación de principal en espera, de modo que, si el nodo principal falla, el nodo en espera pueda seguir entregando tráfico. Por lo general, configuras el servidor de Postgres principal en un centro de datos y el servidor en espera en el segundo centro de datos.

    Si el centro de datos existente ya está configurado para tener dos nodos de Postgres que se ejecutan 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 único de Postgres 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 de Postgres en espera anterior en dc-1

  • Requisitos del puerto

    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 puertos.

Actualiza el centro de datos existente

Para agregar un centro de datos, debes realizar los pasos para instalar y configurar los nodos nuevos del centro de datos, pero también debes actualizar los nodos en el centro de datos original. Estas modificaciones son necesarias porque agregas nodos nuevos de Cassandra y ZooKeeper en el centro de datos nuevo que debe ser accesible 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 silenciosa para 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 para lo siguiente:

  • Configurar 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>"

Agrega un centro de datos nuevo

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

  • dc-1: el centro de datos existente
  • dc-2: el centro de datos nuevo

Para agregar un centro de datos nuevo, sigue estos pasos:

  1. En dc-1, vuelve a ejecutar setup.sh en los nodos de Cassandra originales con el nuevo archivo de configuración de dc-1 que incluye los nodos de Cassandra de dc-2:
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile1
  2. 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
  3. En dc-2, instala apigee-setup en todos los nodos. Consulta Instala la utilidad apigee-setup de Edge para obtener más información.
  4. En dc-2, instala Cassandra y ZooKeeper en los nodos correspondientes:
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile2
  5. 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
  6. En dc-2, instala el servidor de administración en el nodo correspondiente:
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile2
  7. 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
  8. En dc-2, instala los routers y los Message Processors en los nodos correspondientes:
    /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile2
  9. En dc-2, instala Qpid en los nodos correspondientes:
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile2
  10. En dc-2, instala Postgres en el nodo correspondiente:
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile2
  11. Configura la instancia principal y de 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 en espera.
    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 la instancia principal nueva:
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFIle
    3. En el nodo en espera en dc-2, edita el archivo de configuración para establecer lo siguiente:
      PG_MASTER=IPorDNSofDC1Master
      PG_STANDBY=IPorDNSofDC2Standby
    4. En el nodo en espera de dc-2, detén el servidor y, luego, borra los datos de Postgres existentes:
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
      rm -rf /opt/apigee/data/apigee-postgresql/
    5. Configura el nodo en espera en dc-2:
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
  12. En dc-1, actualiza la configuración de estadísticas 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.

    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 silenciosa de una región, puedes establecer el nombre del grupo de estadísticas con la propiedad AXGROUP.

      Si no estás seguro de los nombres de los grupos de consumidores y de estadísticas, usa el siguiente comando para mostrarlos:

      apigee-adminapi.sh analytics groups list \
        --admin adminEmail --pwd adminPword --host localhost

      Este comando devuelve el nombre del grupo de estadísticas en el campo name y el nombre del grupo de consumidores en el campo consumer-groups.

    4. En el nodo del servidor de administración de dc-1, quita el servidor de Postgres existente del grupo de estadísticas:
      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 que se ejecutan 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
      2. 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, quita ambos:

        apigee-adminapi.sh analytics groups postgres_server \
          remove -g axgroup-001 -u UUID1,UUID2 -Y --admin adminEmail \
          --pwd adminPword --host localhost
    5. En el nodo del servidor de administración de dc-1, agrega los nuevos servidores de Postgres principal y en espera al grupo de estadísticas:
      1. 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

        Donde UUID_1 corresponde al nodo de Postgres principal en dc-1 y UUID_2 corresponde al nodo de Postgres en espera en dc-2.

      2. Agrega los servidores de PG al grupo de consumidores como principal/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
    6. Agrega los servidores de Qpid de dc-2 al grupo de estadísticas:
      1. En el nodo del servidor de administración de dc-1, obtén los UUID de los nodos de Qpid 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.

      2. En el nodo del servidor de administración de dc-1, agrega los nodos de Qpid al grupo de estadísticas (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
      3. En el nodo del servidor de administración de dc-1, agrega los nodos de Qpid al grupo de consumidores (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
    7. Anula el registro y borra el servidor en espera de Postgres anterior de dc-1:
      1. Anula el registro del servidor en espera de Postgres dc-1 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 en espera anterior en dc-1.

      2. Borra el servidor en espera de Postgres de dc-1 existente:
        apigee-adminapi.sh servers delete -u UUID \
          --admin adminEmail --pwd adminPword --host localhost
  13. 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:
    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. ALTER KEYSPACE "identityzone" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' }; 
      2. ALTER KEYSPACE "system_traces" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      3. Visualiza los espacios de claves con el siguiente comando:
        select * from system.schema_keyspaces;
      4. Salga de cqlsh:
        exit
  14. 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
  15. 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 nuevo MP_POD a la organización:
      apigee-adminapi.sh orgs pods add -o orgName -r dc-2 -p gateway-2 \
        --admin adminEmail --pwd adminPword --host localhost

      En el ejemplo anterior, gateway-2 es el nombre del Pod de la puerta de enlace, como lo define la propiedad MP_POD en el archivo de configuración dc-2.

    2. Agrega los Message Processors nuevos a la organización y al entorno:
      1. En el nodo del servidor de administración de dc-2, obtén los UUID de los nodos de Message Processor 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.

      2. En el nodo del servidor de administración de dc-1, para cada Message Processor en dc-2, agrega el Message Processor a un entorno de 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

      En el ejemplo anterior, apiProxyName es el nombre de un proxy de API implementado en la organización.