Retirar un centro de datos

A veces, es posible que debas retirar un centro de datos. Por ejemplo, si actualizas el sistema operativo, debes instalar el sistema operativo nuevo en un centro de datos nuevo y, luego, retirar el anterior. En las siguientes secciones, se presenta un ejemplo de retiro de servicio de un centro de datos, en el que hay dos centros de datos, dc-1 y dc-2, en una instalación agrupada en clústeres de 12 nodos:

  • dc-1 es el centro de datos que se retirará.
  • dc-2 es un segundo centro de datos que se usa en el procedimiento de retiro de servicio.

Si actualizas tu sistema operativo, dc-2 podría ser el centro de datos en el que instalaste la versión nueva del sistema operativo (SO). Sin embargo, no es necesario instalar un SO nuevo para retirar un centro de datos.

Consideraciones antes de retirar un centro de datos

Ten en cuenta las siguientes consideraciones cuando retires un centro de datos:

  • Bloquea todo el tráfico de administración y entorno de ejecución al centro de datos que se retirará de servicio y redirecciónalo a otros centros de datos.
  • Después de retirar el centro de datos, tendrás una capacidad reducida en tu clúster de Apigee. Para compensarlo, considera aumentar la capacidad en los centros de datos restantes o agregar centros de datos después de su retiro de servicio.
  • Durante el proceso de retiro de servicio, es posible que se pierdan datos de estadísticas, según los componentes de estadísticas que se instalen en el centro de datos que se retirará de servicio. Para obtener más información, consulta Agrega o quita nodos de Qpid.
  • Antes de retirar un centro de datos, debes comprender cómo se configuran todos los componentes en todos los centros de datos, en especial en los servidores OpenLDAP, ZooKeeper, Cassandra y Postgres. También debes realizar copias de seguridad de todos los componentes y su configuración.

Antes de comenzar

  • Servidor de administración: Todos los pasos del retiro de servicio dependen en gran medida del servidor de administración. Si solo tienes un servidor de administración disponible, te recomendamos que instales un componente nuevo del servidor de administración en un centro de datos que no sea dc-1 antes de retirar el servidor de administración en dc-1 y que te asegures de que uno de los servidores de administración siempre esté disponible.
  • Router: Antes de retirar un router, bloquea el puerto 15999 para inhabilitar la accesibilidad de los routers. Asegúrate de que no se dirija ningún tráfico del entorno de ejecución a los routers que se retirarán de servicio.
  • Cassandra y ZooKeeper: En las siguientes secciones, se describe cómo retirar dc-1 en una configuración de dos centros de datos. Si tienes más de dos centros de datos, asegúrate de quitar todas las referencias al nodo que se está retirando (en este caso, dc-1) de todos los archivos de configuración silenciosos en todos los centros de datos restantes. Para los nodos de Cassandra que se retirarán de servicio, descarta esos hosts de CASS_HOSTS. Los nodos restantes de Cassandra deben permanecer en el orden original de CASS_HOSTS.

  • Postgres: Si retiras la instancia principal de Postgres, asegúrate de ascender cualquiera de los nodos en espera disponibles como una nueva instancia principal de postgres. Mientras el servidor QPID mantiene un búfer en la cola, si la instancia principal de Postgres no está disponible durante más tiempo, corres el riesgo de perder datos de estadísticas.

Requisitos previos

  • Antes de retirar cualquier componente, te recomendamos que realices una copia de seguridad completa de todos los nodos. Usa el procedimiento de tu versión actual de Edge para realizar la copia de seguridad. Para obtener más información sobre las copias de seguridad, consulta Copia de seguridad y restablecimiento.

    Nota: Si tienes varios nodos de Cassandra o ZooKeeper, crea una copia de seguridad de a uno, ya que el proceso de copia de seguridad cierra ZooKeeper temporalmente.

  • Asegúrate de que Edge esté listo antes del retiro de servicio con el siguiente comando:
    /opt/apigee/apigee-service/bin/apigee-all status
  • Asegúrate de que no haya tráfico del entorno de ejecución en el centro de datos que quieres retirar.

Orden de los componentes de retiro de servicio

Si instalas Edge para la nube privada en varios nodos, debes quitar los componentes de Edge de esos nodos en el siguiente orden:

  1. IU de Edge (edge-ui)
  2. Servidor de administración (edge-management-server)
  3. OpenLDAP (apigee-openldap)
  4. Router (router perimetral)
  5. Message Processor (edge-message-processor)
  6. Qpid Server y Qpidd (edge-qpid-server y apigee-qpidd)
  7. Postgres y la base de datos de PostgreSQL (edge-postgres-server y apigee-postgresql)
  8. ZooKeeper (apigee-zookeeper)
  9. Cassandra (apigee-cassandra)

En las siguientes secciones, se explica cómo retirar cada componente.

IU de Edge

Para detener y desinstalar el componente de IU de Edge de dc-1, ingresa los siguientes comandos:

/opt/apigee/apigee-service/bin/apigee-service edge-ui stop
/opt/apigee/apigee-service/bin/apigee-service edge-ui uninstall

Servidor de administración

Para retirar el servidor de administración en dc-1, sigue estos pasos:

  1. Detén el servidor de administración en dc-1:
    apigee-service edge-management-server stop
  2. Busca el UUID de Management Server registrado en dc-1:
    curl -u <AdminEmailID>:'<AdminPassword>' \
    -X GET “http://{MS_IP}:8080/v1/servers?pod=central&region=dc-1&type=management-server”
  3. Anula el registro del tipo de servidor:
    curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://{MS_IP}:8080/v1/servers \
    -d "type=management-server&region=dc-1&pod=central&uuid=UUID&action=remove"
  4. Borra el servidor. Nota: Si también hay otros componentes instalados en este servidor, anula el registro de todos antes de borrar el UUID.
    curl -u <AdminEmailID>:'<AdminPassword> -X DELETE http://{MS_IP}:8080/v1/servers/{UUID}
  5. Desinstala el componente del servidor de administración en dc-1:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server uninstall

Abrir LDAP

En esta sección, se explica cómo retirar OpenLDAP en dc-1.

Nota: Si tienes más de dos centros de datos, consulta Configuraciones con más de dos centros de datos a continuación.

Para retirar OpenLDAP en dc-1, sigue estos pasos:

  1. Para crear una copia de seguridad del nodo OpenLDAP de dc-1, sigue los pasos que se indican en Cómo crear una copia de seguridad.
  2. Rompe la replicación de datos entre los dos centros de datos, dc-1 y dc-2, mediante la ejecución de los siguientes pasos en ambos centros de datos.

    1. Verifica el estado actual:
      ldapsearch -H ldap://{HOST}:{PORT} -LLL -x -b "cn=config" -D "cn=admin,cn=config" -w {credentials} -o ldif-wrap=no 'olcSyncRepl' | grep olcSyncrepl

      El resultado debería ser similar al siguiente:

      olcSyncrepl: {0}rid=001 provider=ldap://{HOST}:{PORT}/ binddn="cn=manager,dc=apigee,dc=com" bindmethod=simple credentials={credentials} searchbase="dc=apigee,dc=com" attrs="*,+" type=refreshAndPersist retry="60 1 300 12 7200 +" timeout=1

    2. Crea un archivo break_repl.ldif que contenga los siguientes comandos:
      dn: olcDatabase={2}bdb,cn=config
      changetype: modify
      delete: olcSyncRepl
      
      dn: olcDatabase={2}bdb,cn=config
      changetype: modify
      delete: olcMirrorMode
    3. Ejecuta el comando ldapmodify:
      ldapmodify -x -w {credentials} -D "cn=admin,cn=config" -H "ldap://{HOST}:{PORT}/" -f path/to/file/break_repl.ldif

      El resultado debería ser similar al siguiente:

      modifying entry "olcDatabase={2}bdb,cn=config"
      modifying entry "olcDatabase={2}bdb,cn=config"

  3. Para verificar que dc-2 ya no se replica a dc-1, crea una entrada en LDAP de dc-2 y asegúrate de que no aparezca en el LDAP de dc-1.

    De manera opcional, puedes seguir los pasos a continuación, que crean un usuario de solo lectura en el nodo OpenLDAP de dc-2 y, luego, verifica si el usuario está replicado o no. Luego, se borrará el usuario.

    1. Crea un archivo readonly-user.ldif en dc-2 con el siguiente contenido:
      dn: uid=readonly-user,ou=users,ou=global,dc=apigee,dc=com
      objectClass: organizationalPerson
      objectClass: person
      objectClass: inetOrgPerson
      objectClass: top
      cn: readonly-user
      sn: readonly-user
      userPassword: {testPassword}
    2. Agrega un usuario con el comando “ldapadd” en dc-2:
      ldapadd -H ldap://{HOST}:{PORT} -w {credentials} -D "cn=manager,dc=apigee,dc=com" -f path/to/file/readonly-user.ldif

      El resultado será similar a este:

      adding new entry "uid=readonly-user,ou=users,ou=global,dc=apigee,dc=com"

    3. Busca el usuario en dc-1 para asegurarte de que no esté replicado. Si el usuario no está presente en dc-1, te asegurarás de que ambos LDAP ya no se repliquen:
      ldapsearch -H ldap://{HOST}:{PORT} -x -w {credentials} -D "cn=manager,dc=apigee,dc=com" -b uid=readonly-user,ou=users,ou=global,dc=apigee,dc=com -LLL

      El resultado debería ser similar al siguiente ejemplo:

      No such object (32)
      Matched DN: ou=users,ou=global,dc=apigee,dc=com
    4. Quita el usuario de solo lectura que agregaste antes:
      ldapdelete -v -H ldap://{HOST}:{PORT} -w {credentials} -D "cn=manager,dc=apigee,dc=com" "uid=readonly-user,ou=users,ou=global,dc=apigee,dc=com"
      .
  4. Detén OpenLDAP en dc-1:
    /opt/apigee/apigee-service/bin/apigee-service apigee-openldap stop
  5. Desinstala el componente OpenLDAP en dc-1:
    /opt/apigee/apigee-service/bin/apigee-service apigee-openldap uninstall

Router

En esta sección, se explica cómo retirar un router. Consulta Cómo quitar un servidor si necesitas más información para quitar el router.

Los siguientes pasos retiran el router de dc-1. Si hay varios nodos de router configurados en dc-1, sigue los pasos en todos los nodos de router, uno a la vez.

Nota: Aquí se supone que el puerto de verificación de estado 15999 del router está configurado en el balanceador de cargas y que, si se bloquea el puerto 15999, no se podrá acceder al router. Es posible que necesites acceso con permisos de administrador para bloquear el puerto.

Para retirar un router, sigue estos pasos:

  1. Inhabilita la accesibilidad de los routers bloqueando el puerto 15999, el puerto de verificación de estado. Asegúrate de que el tráfico del entorno de ejecución esté bloqueado en este centro de datos:

    iptables -A INPUT -i eth0 -p tcp --dport 15999 -j REJECT
  2. Verifica que se pueda acceder al router:

    curl -vvv -X GET http://{ROUTER_IP}:15999/v1/servers/self/reachable

    El resultado debería ser similar al siguiente:

    About to connect() to 10.126.0.160 port 15999 (#0)
    Trying 10.126.0.160...
    Connection refused
    Failed connect to 10.126.0.160:15999; Connection refused
    Closing connection 0
    curl: (7) Failed connect to 10.126.0.160:15999; Connection refused

  3. Obtén el UUID del router, como se describe en Obtén UUID.
  4. Detén el router:
    /opt/apigee/apigee-service/bin/apigee-service edge-router stop
  5. Obtén una lista de los Pods de puerta de enlace disponibles en la organización con el siguiente comando:
    curl -u  <AdminEmailID>:<AdminPassword> -X GET "http://{MS_IP}:8080/v1/organizations/{ORG}/pods"

    Consulta Acerca de los Pods.

  6. Anula el registro del tipo del servidor:
    curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://{MS_IP}:8080/v1/servers \
    -d "type=router&amp;region=dc-1&amp;pod=gateway-1&amp;uuid=UUID&amp;action=remove"
  7. Anula el registro del servidor:
    curl -u <AdminEmailID>:'<AdminPassword>’ -X DELETE http://{MS_IP}:8080/v1/servers/UUID
  8. Desinstala edge-router:
    /opt/apigee/apigee-service/bin/apigee-service edge-router uninstall
    Consulta Cómo quitar un servidor.
  9. Limpia las reglas iptables para habilitar el puerto bloqueado 15999:
    iptables -F

Procesador de mensajes

En esta sección, se describe cómo retirar el procesador de mensajes de dc-1. Consulta Quitar un servidor para obtener más información sobre la eliminación del Message Processor.

Dado que suponemos que dc-1 tiene una instalación agrupada en clústeres de 12 nodos, hay dos nodos de Message Processor configurados en dc-1. Ejecuta los siguientes comandos en ambos nodos.

  1. Obtén los UUID de los procesadores de mensajes, como se describe en Obtén UUID.
  2. Detén el procesador de mensajes:
    apigee-service edge-message-processor stop
  3. Anula el registro del tipo del servidor:
    curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://{MS_IP}:8080/v1/servers  \
    -d "type=message-processor&amp;region=dc-1&amp;pod=gateway-1&amp;uuid=UUID&amp;action=remove"/pre>
  4. Disassociate an environment from the Message Processor.

    Note: You need to remove the bindings on each org/env that associates the Message Processor UUID.

    curl -H "Content-Type:application/x-www-form-urlencoded" -u <AdminEmailID>:''  \
    -X POST http://{MS_IP}:8080/v1/organizations/{ORG}/environments/{ENV}/servers \
    -d "action=remove&uuid=UUID"
  5. Anula el registro del tipo del servidor:
    curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://MS_IP:8080/v1/servers -d "type=message-processor&region=dc-1&pod=gateway-1&uuid=UUID&action=remove"
  6. Desinstala el procesador de mensajes:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor uninstall
  7. Anula el registro del servidor:
    curl -u <AdminEmailID>:'<AdminPassword> -X DELETE http://{MS_IP}:8080/v1/servers/UUID

Servidor Qpid y Qpidd

En esta sección, se explica cómo retirar Qpid Server (edge-qpid-server) y Qpidd (apigee-qpidd). Hay dos nodos de Qpid configurados en dc-1, por lo que debes realizar los siguientes pasos para ambos:

  1. Obtén el UUID de Qpidd, como se describe en Obtén UUID.
  2. Detener edge-qpid-server y apigee-qpidd:
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd stop
  3. Obtén una lista de Analytics y grupos de consumidores:
    curl -u <AdminEmailID>:'<AdminPassword>' -X GET http://{MS_IP}:8080/v1/analytics/groups/ax
  4. Quita Qpid del grupo de consumidores:
    curl -u <AdminEmailID>:'<AdminPassword>' -H "Content-Type: application/json"  -X DELETE \ "http://{MS_IP}:8080/v1/analytics/groups/ax/{ax_group}/consumer-groups/{consumer_group}/consumers/{QPID_UUID}"
  5. Quita Qpid del grupo de estadísticas:
    curl -v -u <AdminEmailID>:'<AdminPassword>' \
    -X DELETE "http://{MS_IP}:8080/v1/analytics/groups/ax/{ax_group}/servers?uuid={QPID_UUID}&type=qpid-server"
  6. Anula el registro del servidor de Qpid de la instalación de Edge:
    curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://{MS_IP}:8080/v1/servers \
    -d "type=qpid-server&region=dc-1&pod=central&uuid={QPID_UUID}&action=remove"
  7. Quita el servidor Qpid de la instalación de Edge:
    curl -u <AdminEmailID>:'<AdminPassword>' -X DELETE http://{MS_IP}:8080/v1/servers/UUID
  8. Reinicia todos los componentes de Edge-qpid-server en todos los nodos para asegurarte de que esos componentes observen el cambio:
    $ /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
    $ /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server wait_for_ready
  9. Desinstala Edge-qpid-server y apigee-qpidd:
    $ /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server uninstall
    $ /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd uninstall

Postgres y Postgresql

El centro de datos que estás retirando podría tener una instancia principal de Postgres o una espera de Postgres. En las siguientes secciones, se explica cómo retirarlas:

Retiro de servicio principal de Postgres

Nota: Si retiras la instancia principal de Postgres, asegúrate de ascender cualquiera de los nodos en espera disponibles como una nueva instancia principal de Postgres. Mientras el QPID almacena en búfer los datos, si la instancia principal de Postgres no está disponible durante un tiempo prolongado, corres el riesgo de perder datos de estadísticas.

Para retirar el servicio principal de Postgres, sigue estos pasos:

  1. Crea una copia de seguridad del nodo principal Postgres de dc-1 siguiendo las instrucciones en los siguientes vínculos:
  2. Obtén los UUID de los servidores de Postgres, como se describe en Obtén UUID.
  3. En dc-1, detén edge-postgres-server y apigee-postgresql en la instancia principal actual:
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
  4. En el nodo en espera en dc-2, ingresa el siguiente comando para convertirlo en el nodo principal:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql promote-standby-to-master <IP of OLD Progress master>

    Nota: Si tienes más de un nodo de Postgres en espera, debes agregar entradas de host en la instancia principal nueva y actualizar la configuración de replicación de todos los nodos en espera de Postgres disponibles.

    Para agregar entradas de host a la nueva instancia principal de Postgres, sigue los pasos que se indican en la sección correspondiente a continuación:

    Si solo queda un nodo en espera

    Por ejemplo, supongamos que, antes del retiro de servicio, había tres nodos de Postgres configurados. Quitaste de servicio la instancia principal existente y ascendiste uno de los nodos en espera de Postgres restantes a la instancia principal. Para configurar el nodo en espera restante, sigue estos pasos:

    1. En la instancia principal nueva, edita el archivo de configuración para establecer:
      PG_MASTER=IP_or_DNS_of_new_PG_MASTER
      PG_STANDBY=IP_or_DNS_of_PG_STANDBY
      .
    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

    Si hay más de un nodo en espera restante

    1. Agrega la siguiente configuración a /opt/apigee/customer/application/postgresql.properties:
      conf_pg_hba_replication.connection=host replication apigee standby_1_ip/32 trust \n host replication apigee standby_2_ip/32 trust
    2. Asegúrate de que el archivo /opt/apigee/customer/application/postgresql.properties sea propiedad del usuario de Apigee:
            chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
    3. Reinicia apigee-postgresql:
      apigee-service apigee-postgresql restart
    4. Para actualizar la configuración de replicación en un nodo en espera, haz lo siguiente:

      1. Modifica el archivo de configuración /opt/silent.conf y actualiza el campo PG_MASTER con la dirección IP de la nueva instancia principal de Postgres.
      2. Quita todos los datos antiguos de Postgres con el siguiente comando:
        rm -rf /opt/apigee/data/apigee-postgresql/
      3. Configura la replicación en el nodo en espera:
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    5. Para verificar que la instancia principal de Postgres esté configurada correctamente, ingresa el siguiente comando en dc-2:
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
    6. Quita y agrega los servidores Postgresql del grupo de estadísticas y del grupo de consumidores.
      1. Quita el servidor de Postgres anterior del grupo de estadísticas con las instrucciones que aparecen en Cómo quitar un servidor de Postgres de un grupo de estadísticas.
      2. Agrega un servidor postgres nuevo al grupo de estadísticas según las instrucciones que se indican en Agrega un servidor de Postgres existente a un grupo de estadísticas.
    7. Anula el registro del servidor de postgres anterior de dc-1:
      curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://{MS_IP}:8080/v1/servers \
      -d "type=postgres-server&region=dc-1&pod=analytics&uuid=UUID&action=remove"<
    8. Borra el servidor de postgres anterior de dc-1:
      curl -u >AdminEmailID>:'>AdminPassword>' -X DELETE http://{MS_IP}:8080/v1/servers/UUID
    9. Ya es seguro retirar el antiguo maestro de Postgres. Desinstala edge-postgres-server y apigee-postgresql:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server uninstall
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql uninstall

    Retiro de servicio de la espera de Postgres

    Nota: En la documentación para una instalación agrupada en clústeres de 12 nodos, se muestra el nodo postgresql de dc-1 como principal, pero, por conveniencia, en esta sección, se supone que el nodo postgresql de dc-1 está en espera y que el nodo postgresql es el principal.

    Para retirar el servicio en espera de Postgres, sigue estos pasos:

    1. Para obtener los UUID de los servidores de Postgres, sigue las instrucciones que aparecen en Obtén UUID.
    2. Detén apigee-postgresql en el nodo en espera actual en dc-1:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Quita y agrega los servidores Postgresql del grupo de estadísticas y del grupo de consumidores.
      1. Quita el servidor de Postgres anterior del grupo de estadísticas con las instrucciones que aparecen en Cómo quitar un servidor de Postgres de un grupo de estadísticas.
      2. Agrega un servidor postgres nuevo al grupo de estadísticas según las instrucciones que se indican en Agrega un servidor de Postgres existente a un grupo de estadísticas.
    4. Anula el registro del servidor de postgres anterior de dc-1:
      curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://{MS_IP}:8080/v1/servers \
      -d "type=postgres-server&region=dc-1&pod=analytics&uuid=UUID&action=remove"<
    5. Borra el servidor de postgres anterior de dc-1:
      curl -u >AdminEmailID>:'>AdminPassword>' -X DELETE http://{MS_IP}:8080/v1/servers/UUID
    6. Ya es seguro retirar el antiguo maestro de Postgres. Desinstala edge-postgres-server y apigee-postgresql:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server uninstall
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql uninstall

    ZooKeeper y Cassandra

    En esta sección, se explica cómo retirar los servidores de ZooKeeper y Cassandra en una configuración de dos centros de datos.

    Si tienes más de dos centros de datos, asegúrate de quitar todas las referencias al nodo que se está retirando (en este caso, dc-1) de todos los archivos de configuración silenciosos en todos los centros de datos restantes. Para los nodos de Cassandra que se retirarán de servicio, descarta esos hosts de CASS_HOSTS. Los nodos restantes de Cassandra deben permanecer en el orden original de CASS_HOSTS.

    Nota sobre ZooKeeper: Debes mantener un quórum de nodos electorales mientras modificas la propiedad ZK_HOST en el archivo de configuración para asegurarte de que el ensamble de ZooKeeper siga funcionando. Debes tener una cantidad impar de nodos votantes en tu configuración. Para obtener más información, consulta las tareas de mantenimiento de Apache ZooKeeper.

    Para retirar los servidores de ZooKeeper y Cassandra, sigue estos pasos:

    1. Para crear una copia de seguridad de los nodos de Cassandra y ZooKeeper de dc-1, sigue las instrucciones en los siguientes vínculos:
    2. Enumera los UUID de los servidores de ZooKeeper y Cassandra del centro de datos donde los nodos de Cassandra se retirarán de servicio.

      apigee-adminapi.sh servers list -r dc-1 -p central -t application-datastore --admin <AdminEmailID> --pwd '<AdminPassword>' --host localhost
    3. Anula el registro del tipo del servidor:
      curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://MS_IP:8080/v1/servers -d "type=cache-datastore&type=user-settings-datastore&type=scheduler-datastore&type=audit-datastore&type=apimodel-datastore&type=application-datastore&type=edgenotification-datastore&type=identityzone-datastore&type=user-settings-datastore&type=auth-datastore&region=dc-1&pod=central&uuid=UUID&action=remove"
    4. Anula el registro del servidor:
      curl -u <AdminEmailID>:'<AdminPassword>' -X DELETE http://MS_IP:8080/v1/servers/UUID
    5. Actualiza el archivo de configuración con las IP de los nodos retirados que se quitaron de ZK_HOSTS y CASS_HOSTS.

      Ejemplo: Supongamos que tienes las IP $IP1 $IP2 $IP3 en dc-1 y $IP4 $IP5 $IP6 en dc-2, y estás retirando dc-1. Luego, debes quitar las IP $IP1 $IP2 $IP3 de los archivos de configuración.

      • Entradas del archivo de configuración existente:
        ZK_HOSTS="$IP1 $IP2 $IP3 $IP4 $IP5 $IP6"
        CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1, $IP4:2,1 $IP5:2,1 $IP6:2,1”
      • Entradas nuevas del archivo de configuración:
        ZK_HOSTS="$IP4 $IP5 $IP6"
        CASS_HOSTS="$IP4:2,1 $IP5:2,1 $IP6:2,1"
    6. Actualiza el archivo de configuración silencioso (modificado en el paso e) con las IP de los nodos que se quitaron y ejecuta el perfil del servidor de administración en todos los nodos que alojan a los servidores de administración:
      /opt/apigee/apigee-setup/bin/setup.sh -p ms -f updated_config_file
    7. Actualiza el archivo de configuración con las IP de los nodos que se quitaron de servicio y ejecuta el perfil de MP/RMP en todos los nodos del router y del procesador de mensajes:
      • Si el router perimetral y el procesador de mensajes están configurados en el mismo nodo, ingresa lo siguiente:
        /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f updated_config_file
      • Si el router perimetral y el procesador de mensajes están configurados en nodos diferentes, ingresa lo siguiente:

        Para el router:

        /opt/apigee/apigee-setup/bin/setup.sh -p r -f updated_config_file

        Para el procesador de mensajes:

        /opt/apigee/apigee-setup/bin/setup.sh -p mp -f updated_config_file
    8. Reconfigura todos los nodos de Qpid, y se quitaron las IP de los nodos que se retiraron del archivo de respuesta:
      /opt/apigee/apigee-setup/bin/setup.sh -p qs -f updated_config_file
    9. Vuelve a configurar todos los nodos de Postgres, en los que se quitarán las direcciones IP de los nodos que se retiraron del archivo de respuesta:
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f updated_config_file
    10. Modifica el espacio de teclas system_auth. Si habilitaste la autenticación de Cassandra en un nodo de Cassandra existente, ejecuta el siguiente comando para actualizar el factor de replicación del espacio de claves system_auth:
      ALTER KEYSPACE system_auth WITH replication = {'class': 'NetworkTopologyStrategy', 'dc-2': '3'};

      Este comando establece 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.

      Después de completar este paso, la topología de Cassandra no debe tener dc-1 en ninguno de los espacios de claves.

    11. Quita los nodos de Cassandra en dc-1, uno por uno.

      Para retirar los nodos de Cassandra, ingresa el siguiente comando:

      /opt/apigee/apigee-cassandra/bin/nodetool -h cassIP -u cassandra -pw '<AdminPassword>' decommission

    12. Verifica la conexión de los nodos de Cassandra desde dc-1 mediante uno de los siguientes comandos:
      /opt/apigee/apigee-cassandra/bin/cqlsh cassIP 9042 -u cassandra -p '<AdminPassword>'

      O un comando de verificación secundario que se ejecutará en el nodo retirado de servicio:

      /opt/apigee/apigee-cassandra/bin/nodetool netstats

      El comando anterior debería mostrar lo siguiente:

      Mode: DECOMMISSIONED

    13. Ejecuta el perfil de DS para todos los nodos de Cassandra y ZooKeeper en dc-2:
      /opt/apigee/apigee-setup/bin/setup.sh -p ds -f updated_config_file
      .
    14. Detén apigee-cassandra y apigee-zookeeper en dc-1:
      apigee-service apigee-cassandra stop
      apigee-service apigee-zookeeper stop
      .
    15. Desinstala apigee-cassandra y apigee-zookeeper en dc-1:
      apigee-service apigee-cassandra uninstall
      apigee-service apigee-zookeeper uninstall
      .

    Borra las vinculaciones de dc-1

    Para borrar las vinculaciones de dc-1, sigue estos pasos:

    1. Borra las vinculaciones de dc-1.
      1. Enumera todos los Pods disponibles en la organización:
        curl -v -u  <AdminEmailID>:<AdminPassword> -X GET "http://MS_IP:8080/v1/o/ORG/pods"
      2. Para verificar si se quitaron todas las vinculaciones, obtén los UUID de los servidores asociados con los Pods:
        curl -v -u  <AdminEmailID>:<AdminPassword> \
        -X GET "http://MS_IP:8080/v1/regions/dc-1/pods/gateway-1/servers"

        Si este comando no muestra ningún UUID, significa que los pasos anteriores quitaron todas las vinculaciones, y puedes omitir el paso siguiente. De lo contrario, realiza el siguiente paso.

      3. Quita todas las vinculaciones del servidor para los UUID que obtuviste en el paso anterior:
        curl -u <AdminEmailID>:'<AdminPassword>' -X DELETE http://MS_IP:8080/v1/servers/UUID
      4. Desasociar la organización del Pod:
        curl -v -u  <AdminEmailID>:<AdminPassword>  "http://MS_IP:8080/v1/o/ORG/pods" -d "action=remove&region=dc-1&pod=gateway-1" -H "Content-Type: application/x-www-form-urlencoded" -X POST
    2. Borra los pods:
      curl -v -u <AdminEmailID>:<AdminPassword> "http://MS_IP:8080/v1/regions/dc-1/pods/gateway-1" -X DELETE
    3. Borra la región.
      curl -v -u <AdminEmailID>:<AdminPassword>  "http://MS_IP:8080/v1/regions/dc-1" -X DELETE

    Nota: Si omites uno de los pasos para borrar los servidores, el paso anterior mostrará un mensaje de error que indica que aún existe un servidor específico en el Pod. Por lo tanto, bórralos siguiendo los pasos para solucionar problemas que se indican a continuación mientras personalizas los tipos en el comando curl.

    En este punto, completaste el retiro de servicio de dc-1.

    Apéndice

    Solución de problemas

    Si después de realizar los pasos anteriores aún quedan servidores en algunos Pods, sigue los pasos para anular el registro y borrar los servidores. Nota: Cambie los tipos y los Pods según sea necesario.

    1. Obtén los UUID con el siguiente comando:
      apigee-adminapi.sh servers list -r dc-1 -p POD -t  --admin <AdminEmailID> --pwd  '<AdminPassword>’ --host localhost
    2. Anula el registro del tipo de servidor:
      curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://MP_IP:8080/v1/servers -d "type=TYPE=REGION=dc-1&pod=POD&uuid=UUID&action=remove"
    3. Borra los servidores uno por uno:
      curl -u <AdminEmailID>:'<AdminPassword>' -X DELETE http://MP_IP:8080/v1/servers/UUID

    Validación

    Puedes validar el retiro de servicio con los siguientes comandos.

    Servidor de administración

    Ejecuta los siguientes comandos desde los servidores de administración en todas las regiones.

    curl -v  -u  <AdminEmailID>:'<AdminPassword>' http://MS_IP:8080/v1/servers?pod=central&region=dc-1
    curl -v  -u  <AdminEmailID>:'<AdminPassword>' http://MS_IP:8080/v1/servers?pod=gateway&region=dc-1
    curl -v -u  <AdminEmailID>:'<AdminPassword>'  http://MS_IP:8080/v1/servers?pod=analytics&region=dc-1

    Ejecuta el siguiente comando en todos los componentes para verificar los requisitos de los puertos de administración.

    curl -v http://MS_IP:8080/v1/servers/self

    Verifica el grupo de estadísticas.

    curl  -v  -u  <AdminEmailID>:'<AdminPassword>' "http://MS_IP:8080}/v1/o/ORG/e/ENV/provisioning/axstatus"
    curl -v  -u  <AdminEmailID>:'<AdminPassword>'  http://MS_IP:8080/v1/analytics/groups/ax

    Nodos de Cassandra/ZooKeeper

    En todos los nodos de Cassandra, ingresa lo siguiente:

    /opt/apigee/apigee-cassandra/bin/nodetool -h <host> statusthrift

    Se mostrará el estado running o not running para ese nodo en particular.

    En un nodo, ingresa lo siguiente:

    /opt/apigee/apigee-cassandra/bin/nodetool -h <host> ring
    /opt/apigee/apigee-cassandra/bin/nodetool -h <host> status

    Los comandos anteriores mostrarán información sobre los centros de datos activos.

    En los nodos de ZooKeeper, ingresa primero lo siguiente:

    echo ruok | nc <host> 2181

    Este comando mostrará imok.

    Luego, ingresa lo siguiente:

    echo stat | nc <host> 2181 | grep Mode

    El valor de Mode que muestra el comando anterior será uno de los siguientes: observer, leader o follower.

    En un nodo de ZooKeeper, haz lo siguiente:

    /opt/apigee/apigee-zookeeper/contrib/zk-tree.sh >> /tmp/zk-tree.out.txt

    En el nodo principal de Postgres, ejecuta el siguiente comando:

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

    Valida que la respuesta indique que el nodo es el principal.

    En el nodo en espera:

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

    Valida que la respuesta indique que el nodo está en espera.

    Accede a la base de datos de PostgreSQL con el comando

    psql -h localhost -d apigee -U postgres

    Cuando se te solicite, ingresa la contraseña de usuario 'postgres' como 'postgres'. Selecciona max(client_received_start_timestamp) en Analytics.

    ”$org.$env.fact” limit 1;

    Registros

    Revisa los registros de los componentes para asegurarte de que no haya errores.