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

Retirar un centro de datos

A veces, es posible que tengas que retirar un centro de datos. Por ejemplo, si actualizas tu sistema operativo, debes instalar el sistema operativo nuevo en un centro de datos nuevo y, luego, retirar el centro de datos anterior. En las siguientes secciones, se presenta un ejemplo del 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 utiliza 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 dar de baja un centro de datos

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

Bloquear todo el tráfico de entorno de ejecución y administración al centro de datos que se retirará y redireccionarlo a otros centros de datos
Después de retirar el centro de datos, habrás reducido la capacidad de tu clúster de Apigee. Para compensarlo, considera aumentar la capacidad en los centros de datos restantes o agregar centros de datos después del retiro de servicio.
Durante el proceso de retiro de servicio, existe la posibilidad de que se pierdan los datos de estadísticas, según los componentes de estadísticas que estén instalados en el centro de datos que se retire de servicio. Puedes encontrar más detalles en Cómo agregar o quitar nodos Qpid.
Antes de retirar un centro de datos, debes comprender cómo se configuran todos los componentes en todos los centros de datos, especialmente en los servidores OpenLDAP, ZooKeeper, Cassandra y Postgres. También debes realizar copias de seguridad de todos los componentes y sus configuraciones.

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 de servidor de administración nuevo 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 esté siempre disponible.
Router: Antes de retirar un router, inhabilita la accesibilidad de los routers bloqueando el puerto 15999. Asegúrate de que el tráfico del entorno de ejecución no se dirija a los routers que se retirarán.
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 de servicio (dc-1 en este caso) de todos los archivos de configuración silenciosos en todos los centros de datos restantes. En el caso de los nodos de Cassandra que se retirarán de servicio, descarta esos hosts de CASS_HOSTS. Los nodos de Cassandra restantes 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 instancia principal de Postgres nueva. Si bien el servidor QPID mantiene un búfer en la cola, si la instancia principal de Postgres no está disponible por más tiempo, corres el riesgo de perder los datos de estadísticas.
Precaución: Debes quitar y agregar servidores Postgresql del grupo de estadísticas y del grupo de consumidores al mismo tiempo. Es posible que pierdas algunos datos de estadísticas si hay un retraso considerable entre los dos pasos.
Sugerencia: El procesador de mensajes tiene una cola pequeña en la que conserva los datos de estadísticas en la memoria durante un período breve, que puedes usar para evitar la pérdida de datos. Antes de realizar cambios en el grupo de estadísticas, bloquea el puerto 5672 en el centro de datos que recibe tráfico y asegúrate de volver a habilitar rápidamente este puerto después de realizar los cambios, ya que puede haber un desbordamiento de datos.

Por ejemplo, para detener temporalmente el tráfico de estadísticas de los procesadores de mensajes al servidor Qpid, sigue estos pasos:
1. Ingresar
```
iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
```
2. Sigue los pasos para cambiar el grupo de ejes.
3. Quita la regla de iptable después de los cambios de axgroup:
```
iptables -F
```

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 Cassandra o ZooKeeper, crea una copia de seguridad uno a la vez, ya que el proceso de copia de seguridad cierra ZooKeeper temporalmente.
Asegúrate de que Edge esté en funcionamiento antes del retiro. Para ello, usa el siguiente comando:
```
/opt/apigee/apigee-service/bin/apigee-all status
```
Asegúrate de que no esté recibiendo tráfico del entorno de ejecución al centro de datos que estás retirando de servicio.

Orden de los componentes del retiro de servicio

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

IU de Edge (edge-ui)
Servidor de administración (servidor de administración perimetral)
OpenLDAP (apigee-openldap)
Router (router perimetral)
Message Processor (edge-message-processor)
Qpid Server y Qpidd (edge-qpid-server y apigee-qpidd)
Base de datos de Postgres y PostgreSQL (edge-postgres-server y apigee-postgresql)
ZooKeeper (apigee-zookeeper)
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:

Detén el servidor de administración en dc-1:
```
apigee-service edge-management-server stop
```

Busca el UUID del servidor de administración registrado en dc-1:

curl -u <AdminEmailID>:'<AdminPassword>' \
-X GET “http://{MS_IP}:8080/v1/servers?pod=central&region=dc-1&type=management-server”

Anular 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"

Borra el servidor. Nota: Si también hay otros componentes instalados en este servidor, primero anula el registro de todos ellos antes de borrar el UUID.
```
curl -u <AdminEmailID>:'<AdminPassword> -X DELETE http://{MS_IP}:8080/v1/servers/{UUID}
```

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:

Crea una copia de seguridad del nodo de OpenLDAP dc-1. Para ello, sigue los pasos que se indican en Cómo crear una copia de seguridad.
Interrumpe 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.
Nota: Si tu configuración tiene más de dos centros de datos, debes hacer lo siguiente:
1. Identifica qué nodo de OpenLDAP se replica en el nodo que se está retirando de servicio.
2. Cambia la replicación de ese nodo para que se replique en uno diferente para completar el círculo de replicación.
Por ejemplo, supongamos que tienes tres centros de datos, en los que el nodo 1 se replica al nodo 2, el nodo 2 se replica al nodo 3 y el nodo 3 se replica al 1. Si vas a retirar el nodo 1, debes interrumpir la replicación en el nodo 1 y también modificar la replicación del nodo 3 para que se replique en el nodo 2.
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"
```
Puedes verificar que dc-2 ya no se esté replicando en dc-1 creando una entrada en el LDAP de dc-2 y asegurándote de que no aparezca en el LDAP de dc-1.

De manera opcional, puedes seguir los pasos que se indican a continuación, que crean un usuario de solo lectura en el nodo de OpenLDAP dc-2 y, luego, verifican 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 se replique. 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 anteriormente:
```
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"
```

Detén OpenLDAP en dc-1:

/opt/apigee/apigee-service/bin/apigee-service apigee-openldap stop

Desinstala el componente de 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 Quita un servidor para obtener más detalles sobre cómo quitar el router.

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

Nota: Aquí se da por sentado que el puerto de verificación de estado 15999 del router está configurado en tu balanceador de cargas y que el puerto de bloqueo 15999 hará que sea inaccesible al router. Es posible que necesites acceso raíz para bloquear el puerto.

Sigue estos pasos para retirar un router:

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
```

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

Obtén el UUID del router, como se describe en Obtén UUID.

Detén el router:

/opt/apigee/apigee-service/bin/apigee-service edge-router stop

Para obtener una lista de los Pods de puerta de enlace disponibles en la organización, usa el siguiente comando:
```
curl -u  <AdminEmailID>:<AdminPassword> -X GET "http://{MS_IP}:8080/v1/organizations/{ORG}/pods"
```
Consulta Acerca de los Pods.

Anula el registro del tipo de 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"

Borra el servidor:

curl -u <AdminEmailID>:'<AdminPassword>’ -X DELETE http://{MS_IP}:8080/v1/servers/UUID

Desinstala edge-router:

/opt/apigee/apigee-service/bin/apigee-service edge-router uninstall

Consulta Cómo quitar un servidor.

Limpia las reglas iptables para habilitar el puerto 15999 bloqueado:
```
iptables -F
```

Message Processor

En esta sección, se describe cómo retirar el Message Processor de dc-1. Consulta Cómo quitar un servidor para obtener más detalles sobre cómo quitar el procesador de mensajes.

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

Obtén los UUID de los procesadores de mensajes, como se describe en Cómo obtener UUID.

Detén Message Processor:

apigee-service edge-message-processor stop

Anula el registro del tipo de 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>

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"

Anula el registro del tipo de 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"

Desinstala el procesador de mensajes:

/opt/apigee/apigee-service/bin/apigee-service edge-message-processor uninstall

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 el servidor Qpid (edge-qpid-server) y Qpidd (apigee-qpidd). Hay dos nodos Qpid configurados en dc-1, por lo que debes seguir estos pasos para ambos nodos:

Obtén el UUID para Qpidd, como se describe en Cómo obtener UUID.

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

Obtén una lista de los grupos de consumidores y de Analytics:

curl -u <AdminEmailID>:'<AdminPassword>' -X GET http://{MS_IP}:8080/v1/analytics/groups/ax

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}"

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"

Anula el registro del servidor Qpid en 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"

Quita el servidor Qpid de la instalación de Edge:

curl -u <AdminEmailID>:'<AdminPassword>' -X DELETE http://{MS_IP}:8080/v1/servers/UUID

Reinicia todos los componentes de Edge-qpid-server en todos los nodos para asegurarte de que esos componentes capten 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

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 retirarás podría tener una instancia principal de Postgres o una instancia de reserva de Postgres. En las siguientes secciones, se explica cómo retirarlas:

Retiro de servicio principal de Postgres
Retiro de servicio en espera de Postgres

Precaución: Debes quitar y agregar servidores Postgresql del grupo de estadísticas y del grupo de consumidores al mismo tiempo. Es posible que pierdas algunos datos de estadísticas si hay un retraso considerable entre los dos pasos.

Sugerencia: El procesador de mensajes tiene una cola pequeña en la que conserva los datos de estadísticas en la memoria durante un período breve, que puedes usar para evitar la pérdida de datos. Antes de realizar cambios en el grupo de estadísticas, bloquea el puerto 5672 en el centro de datos que recibe tráfico y asegúrate de volver a habilitar rápidamente este puerto después de realizar los cambios, ya que puede haber un desbordamiento de datos.

Por ejemplo, para detener temporalmente el tráfico de estadísticas de los procesadores de mensajes al servidor Qpid, sigue estos pasos:

Ingresar

iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP

Sigue los pasos para cambiar el grupo de ejes.
Quita la regla de iptable después de los cambios de axgroup:
```
iptables -F
```

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 instancia principal de postgres nueva. Si bien la cola de QPID almacena los datos, si la instancia principal de Postgres no está disponible durante mucho tiempo, corres el riesgo de perder los datos de estadísticas.

Para retirar la instancia principal de Postgres, sigue estos pasos:

Sigue las instrucciones en los siguientes vínculos para crear una copia de seguridad del nodo principal de Postgres de dc-1:
- Copia de seguridad y restablecimiento
- Cómo crear una copia de seguridad
Obtén los UUID de los servidores de Postgres, como se describe en Obtén UUID.

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

En el nodo en espera de 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 Postgres en espera, debes agregar entradas de host en la instancia principal nueva y actualizar la configuración de replicación para todos los nodos en espera de postgres disponibles.

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

Si solo queda un nodo en espera

Por ejemplo, supongamos que antes del retiro de servicio hay tres nodos de Postgres configurados. Retiraste el servicio de la instancia principal existente y ascendiste uno de los nodos en espera restantes de postgres a principal. Configura el nodo en espera restante con los siguientes pasos:
1. En la nueva instancia principal, edita el archivo de configuración para establecer lo siguiente:
```
PG_MASTER=IP_or_DNS_of_new_PG_MASTER
PG_STANDBY=IP_or_DNS_of_PG_STANDBY
```
2. Habilita la replicación en la nueva instancia principal:
```
/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 en /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. Ingresa el siguiente comando en dc-2 para verificar que la instancia principal de Postgres esté configurada de forma correcta:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
```
5. Quita y agrega los servidores Postgresql del grupo de estadísticas y del grupo de consumidores.
  Precaución: Realiza los siguientes dos pasos juntos, ya que puede haber una pérdida de datos de estadísticas entre ellos.
  1. Quita el servidor de Postgres anterior del grupo de estadísticas según las instrucciones que se indican en Quita un servidor de Postgres de un grupo de estadísticas.
  2. Agrega un servidor de Postgres nuevo al grupo de estadísticas siguiendo las instrucciones en Agrega un servidor de Postgres existente a un grupo de estadísticas.
6. 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"<
```
7. Borra el servidor de postgres anterior de dc-1:
```
curl -u >AdminEmailID>:'>AdminPassword>' -X DELETE http://{MS_IP}:8080/v1/servers/UUID
```
8. Ya es seguro retirar del servicio la antigua instancia principal 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 en espera de Postgres

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

Para retirar el servicio en espera de Postgres, sigue estos pasos:
1. Sigue las instrucciones en Obtén UUID para obtener los UUID de los servidores de Postgres.
2. Detener 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.
  Precaución: Realiza los siguientes dos pasos juntos, ya que puede haber una pérdida de datos de estadísticas entre ellos.
  1. Quita el servidor de Postgres anterior del grupo de estadísticas según las instrucciones que se indican en Quita un servidor de Postgres de un grupo de estadísticas.
  2. Agrega un servidor de Postgres nuevo al grupo de estadísticas siguiendo las instrucciones 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 del servicio la antigua instancia principal 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 de servicio (dc-1 en este caso) de todos los archivos de configuración silenciosos en todos los centros de datos restantes. En el caso de los nodos de Cassandra que se retirarán de servicio, descarta esos hosts de CASS_HOSTS. Los nodos de Cassandra restantes deben permanecer en el orden original de CASS_HOSTS.

Nota sobre ZooKeeper: Debes mantener un quórum de nodos votantes mientras modificas la propiedad ZK_HOST en el archivo de configuración para garantizar 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 Tareas de mantenimiento de Apache ZooKeeper.

Precaución: Si retiras de servicio un centro de datos que tiene un nodo líder de ZooKeeper, habrá tiempo de inactividad.

Para retirar los servidores de ZooKeeper y Cassandra, haz lo siguiente:
1. Crea una copia de seguridad de los nodos de dc-1 Cassandra y ZooKeeper. Para ello, sigue las instrucciones de los siguientes vínculos:
  - Copia de seguridad y restablecimiento
  - Cómo crear una copia de seguridad
  Nota: Si tienes varios nodos de ZooKeeper, crea una copia de seguridad de ellos uno a la vez. El proceso de copia de seguridad cierra ZooKeeper temporalmente.
2. Enumera los UUID de los servidores de ZooKeeper y Cassandra en el centro de datos donde los nodos de Cassandra están a punto de retirarse.
```
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 de 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.
  Notas:
  - Debes mantener un quórum de nodos votantes mientras modificas la propiedad ZK_HOST en el archivo de configuración para garantizar que el ensamble de ZooKeeper siga funcionando. Debe tener una cantidad impar de nodos votantes en su configuración. Consulta Acerca de ZooKeeper y Edge.
  - En el caso de los nodos de Cassandra que se retirarán de servicio, descarta esos hosts de CASS_HOSTS. Los nodos de Cassandra restantes deben permanecer en el orden original de CASS_HOSTS.
  - Los nodos del observador de ZooKeeper no participan en la votación y no se cuentan al determinar un quórum.
  Ejemplo: Supongamos que tienes las IP $IP1 $IP2 $IP3 en dc-1 y $IP4 $IP5 $IP6 en dc-2, y retiras de servicio 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”
```
  - Nuevas entradas 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 silenciosa (modificado en el paso e) con las IP de los nodos retirados que se quitaron y ejecuta el perfil del servidor de administración en todos los nodos que alojan 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 retirados de servicio que se quitaron y ejecuta el perfil 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:
```
/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 separados, 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, sin las IP de los nodos retirados del archivo de respuesta:
```
/opt/apigee/apigee-setup/bin/setup.sh -p qs -f updated_config_file
```
9. Reconfigura todos los nodos de Postgres, con las IP de los nodos retirados que se quitaron del archivo de respuesta:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f updated_config_file
```
10. Modificar el espacio de teclas system_auth. Si tienes la autenticación de Cassandra habilitada 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 que hay 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. Retira los nodos de Cassandra en dc-1, uno por uno.
  Nota: Los nodos retirados aún tienen Cassandra con información inicial del clúster original. Si por casualidad el servicio de Cassandra debe aparecer, los nodos retirados se volverán a unir al anillo del clúster. Para evitar esto, asegúrate de desinstalar el componente de Cassandra después del retiro y no permitir que aparezca ningún nodo retirado y se vuelva a unir al clúster.
  
  Para retirar los nodos de Cassandra, ingresa el siguiente comando:
```
/opt/apigee/apigee-cassandra/bin/nodetool -h cassIP -u cassandra -pw '<AdminPassword>' decommission
```
  Nota: Si un nodo se detiene en un estado de retiro de servicio, puedes usar Cassandra nodetool removenode para quitarlo. Por ejemplo:
```
/opt/apigee/apigee-cassandra/bin/nodetool removenode UUID
```
12. Comprueba 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 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 de 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, por lo tanto, puedes omitir el siguiente paso. De lo contrario, realiza el siguiente paso.
  3. Quita todas las vinculaciones del servidor para los UUID obtenidos en el paso anterior:
```
curl -u <AdminEmailID>:'<AdminPassword>' -X DELETE http://MS_IP:8080/v1/servers/UUID
```
  4. Desasocia 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 alguno de los pasos para borrar los servidores, el paso anterior mostrará un mensaje de error que indica que aún existe un servidor en particular 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 aún hay servidores en algunos Pods después de realizar los pasos anteriores, sigue estos 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. Anular 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 mediante 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 todos 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 y 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:
```
/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 el centro de datos activo.

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:
```
/opt/apigee/apigee-zookeeper/contrib/zk-tree.sh >> /tmp/zk-tree.out.txt
```
En el nodo principal de Postgres, ejecuta lo siguiente:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
```
Valida que la respuesta indique que el nodo es el nodo 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.

Retirar un centro de datos

Consideraciones antes de dar de baja un centro de datos

Antes de comenzar

Requisitos previos

Orden de los componentes del retiro de servicio

IU de Edge

Servidor de administración

Abrir LDAP

Router

Message Processor

Servidor Qpid y Qpidd

Postgres y Postgresql

Retiro de servicio principal de Postgres

Si solo queda un nodo en espera

Si hay más de un nodo en espera restante

Retiro de servicio en espera de Postgres

ZooKeeper y Cassandra

Borra las vinculaciones de dc-1

Apéndice

Solución de problemas

Validación

Servidor de administración

Nodos de Cassandra y ZooKeeper

Registros