Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Actualización del sistema operativo nodo por nodo para Apigee Edge para la nube privada

Estás viendo la documentación de Apigee Edge.
Ir a la documentación de Apigee X. info

En este documento, se describe un método alternativo para actualizar el sistema operativo (SO) de los servidores en tu clúster de Apigee Edge para Private Cloud. En lugar de configurar un centro de datos paralelo completamente nuevo, este enfoque nodo por nodo te permite actualizar tu SO en el lugar, una máquina o un nodo a la vez.

Compatibilidad

Antes de iniciar la actualización del SO nodo por nodo, verifica que tu versión actual de Apigee Edge para Private Cloud admita la versión del SO de destino. Para verificarlo, consulta la matriz de compatibilidad con el SO.

Requisitos previos

Antes de comenzar la actualización nodo por nodo, confirma que completaste las siguientes tareas:

Copia de seguridad de todos los nodos

Antes de seguir el procedimiento, te recomendamos que realices una copia de seguridad completa de todos los nodos, como una copia de seguridad a nivel de la VM, una copia de seguridad a nivel del componente (o ambas), por motivos de seguridad. Esto te permite tener un plan de contingencia en caso de que alguno de los siguientes pasos no funcione correctamente. Para obtener más información sobre la copia de seguridad a nivel de componente, consulta Copia de seguridad y restablecimiento.

Asegúrate de que Edge esté en ejecución

Asegúrate de que Edge esté en funcionamiento durante el proceso de actualización con el siguiente comando:

/opt/apigee/apigee-service/bin/apigee-all status

Orden de reemplazo de nodos

Te recomendamos que actualices los nodos en el orden que se indica a continuación, según el tipo de componente:

Cassandra
Zookeeper
Postgres
LDAP
Qpid
Message-Processor
Router
Management-server
IU/UE
SSO

Situaciones adicionales

Cuando realices una actualización del SO nodo por nodo, si alguna de las siguientes configuraciones está presente en la configuración existente, ten en cuenta estos pasos adicionales:

apigee-mtls: Si apigee-mtls está habilitado, no se admite la actualización del SO nodo por nodo (lanzamiento progresivo) para esta configuración. Para actualizarlo, sigue la guía de actualización de apigee-mtls.

Cassandra

Cuando reemplaces Cassandra, considera reemplazar primero los nodos que no son semilla y, luego, los nodos semilla.

Los casos especiales que se deben considerar para Cassandra son los siguientes:

Cassandra Native-mTLS: Si se habilitó y aplicó native-mTLS, quita la aplicación en los nodos habilitados para mTLS configurando conf_cassandra_client_encryption_optional=true. Para obtener más información, consulta la documentación de mTLS nativo.
Cassandra internode encryption enabled: Consulta Enable Cassandra Internode Encryption para asegurarte de que los certificados de los nodos de Cassandra existentes se incluyan en el almacén de certificados de confianza del nodo reemplazado recientemente y viceversa.

Sigue estos pasos para reemplazar un nodo de Cassandra:

Realiza una copia de seguridad del nodo tomando instantáneas de la máquina virtual (si es posible) y realiza una copia de seguridad de Apigee para Cassandra en todos los nodos con el siguiente comando:
```
apigee-service apigee-cassandra backup
```
Adquiere un nodo nuevo con el SO actualizado.
Aplica los requisitos previos específicos del SO.
Descarga y ejecuta el archivo de Edge para instalar la utilidad apigee-service. El inicio de la versión de Apigee en uso, run bootstrap para obtener apigee-service y, luego, instalar apigee-setup.
NOTA: Asegúrate de que el nodo nuevo no contenga ningún directorio de datos en la ruta de acceso del directorio de datos de apigee-cassandra.

Enumera los nodos semilla:

apigee-service apigee-cassandra configure -search conf_cassandra_seeds

Actualiza el archivo de configuración. Para ello, cambia la IP del nodo de Cassandra existente y reemplázala por la IP del nodo nuevo.
NOTA: Asegúrate de que se conserve el orden de las direcciones IP que se reemplazan. Por ejemplo, si reemplazas IP2 por IP4.

CASS_HOSTS existente
```
CASS_HOSTS="$IP1 $IP2 $IP3"
```
CASS_HOSTS recién actualizado
```
CASS_HOSTS="$IP1 $IP4 $IP3"
```
Vuelve a configurar los nodos existentes en el clúster con la IP del nuevo nodo de Cassandra actualizada (excepto el nodo que se reemplazará). Usa la referencia del archivo de configuración.
```
/opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile
```

Detén y anula el registro de Cassandra en el nodo anterior:

Detén Cassandra en el nodo que se reemplazará:
```
apigee-service apigee-cassandra stop
```

Enumera el UUID del nodo de Cassandra que se dará de baja (si hay varios centros de datos, tenlo en cuenta):

apigee-adminapi.sh servers list -r dc-1 -p central -t application-datastore --admin AdminEmailID --pwd 'AdminPassword' --host localhost

Anula el registro de los tipos de almacén de datos asociados con el UUID de Cassandra existente:

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=auth-datastore&region=dc-1&pod=central&uuid=old_cassandra_uuid&action=remove"

Borra el servidor.
NOTA: No ejecutes este paso si Cassandra y otros componentes de Edge, como management-server, están en el mismo nodo. Este puede ser el caso si tu configuración usa una configuración estándar de 5 nodos de Apigee.
```
curl -u AdminEmailID:AdminPassword -X DELETE http://MS_IP:8080/v1/servers/old_cassandra_uuid
```

Prepara un nodo nuevo para el host apigee-cassandra. Agrega la siguiente línea al archivo cassandra.properties en /opt/apigee/customer/application/cassandra.properties (créalo si aún no está presente) en el nuevo nodo de Cassandra:
```
conf_jvm_options_custom_settings=-Dcassandra.replace_address=IPOfOldCassandraNode -Dcassandra.allow_unsafe_replace=true
```
Confirma que el propietario y el grupo estén configurados en apigee:apigee en el archivo cassandra.properties. Si es necesario, usa el siguiente comando para actualizar el propietario y el grupo:
```
chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
```

Instala Cassandra y ejecuta la configuración en el nodo recién agregado:

apigee-service apigee-cassandra install

apigee-service apigee-cassandra setup -f updatedConfigFile

Después de configurar el nodo nuevo, quita la configuración adicional que se agregó a /opt/apigee/customer/application/cassandra.properties y reinicia apigee-cassandra:
```
conf_jvm_options_custom_settings=-Dcassandra.replace_address=IPOfOldCassandraNode -Dcassandra.allow_unsafe_replace=true
```
```
apigee-service apigee-cassandra restart
```

Verifica el estado del nodo nuevo reemplazado:

apigee-service apigee-cassandra status

/opt/apigee/apigee-cassandra/bin/nodetool status

Vuelve a compilar el nodo nuevo que se agregó al clúster:

/opt/apigee/apigee-cassandra/bin/nodetool rebuild -dc dc-1

Vuelve a configurar los nodos existentes de los servidores de Router, Message-Processor, Qpid, Postgres y Management, respectivamente, actualizando la IP del nodo nuevo de Cassandra en el archivo de configuración:
```
/opt/apigee/apigee-setup/bin/setup.sh -p r|mp|qs|ps|ms|mo -f updatedConfigFile
```
NOTA: Si el router y el Message Processor están en el mismo nodo, usa -p rmp.
Quita o desinstala Cassandra del nodo anterior:
```
apigee-service apigee-cassandra uninstall
```
Repite el proceso para otros nodos de Cassandra en el clúster.

Zookeeper

Consulta los pasos que se indican a continuación para reemplazar los nodos de Zookeeper. Considera reemplazar primero los nodos de seguimiento y, luego, los nodos líderes para garantizar que el conjunto mantenga el quórum.

Crea una copia de seguridad del nodo tomando instantáneas de la máquina virtual (si es posible) y crea una copia de seguridad de Apigee para Zookeeper en todos los nodos.

Detén y desinstala Zookeeper en el nodo existente:

apigee-service apigee-zookeeper stop

apigee-service apigee-zookeeper uninstall

Adquiere un nodo nuevo con el SO actualizado.
Aplica los requisitos previos específicos del SO.
Descarga el programa de arranque de la versión de Apigee en uso, ejecuta el programa de arranque para obtener apigee-service y, luego, instala apigee-setup.
Actualiza el archivo de configuración quitando las direcciones IP de los nodos obsoletos o borrados y reemplazándolas por las direcciones IP de los nodos nuevos para Zookeeper. Para obtener más detalles, consulta la referencia del archivo de configuración:
NOTA: Asegúrate de que se conserve el orden de la IP que se reemplaza. Por ejemplo, si reemplazas IP2 por IP4.

Configuración de ZK existente
```
ZK_HOSTS="$IP1 $IP2 $IP3"
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"
    
```
Se actualizó la configuración de ZK
```
ZK_HOSTS="$IP1 $IP4 $IP3"
ZK_CLIENT_HOSTS="$IP1 $IP4 $IP3"
    
```
Instala, configura e inicia Zookeeper en el nodo nuevo con el archivo de configuración actualizado:
```
/opt/apigee/apigee-setup/bin/setup.sh -p zk -f updatedConfigFile
```
Realiza cambios en el nodo de Zookeeper existente con updatedConfigFile:
```
/opt/apigee/apigee-setup/bin/setup.sh -p zk -f updatedConfigFile
```
Vuelve a configurar los nodos existentes de los servidores de Router, Message-Processor, Qpid, Postgres y Management, respectivamente, actualizando la IP del nodo de Zookeeper nuevo en el archivo de configuración:
```
/opt/apigee/apigee-setup/bin/setup.sh -p r|mp|qs|ps|ms|mo -f updatedConfigFile
```
NOTA: Si el router y el Message Processor están en el mismo nodo, usa -p rmp.
Repite este paso para todos los nodos de ZooKeeper.

Postgres

En esta sección, se describe un enfoque de tiempo de inactividad cero para actualizar los nodos de Postgres, en el que completarás los pasos descritos. En las siguientes subsecciones, se proporcionan instrucciones detalladas para completar cada paso.

Reemplaza cualquiera de los nodos en espera existentes por el SO objetivo.
Promueve el nuevo nodo en espera como principal.
Retira la instancia principal anterior.
Continúa reemplazando nodos en espera adicionales.

Antes de comenzar el reemplazo, se recomienda detener el servidor edge-qpid-server para minimizar cualquier posible pérdida de mensajes de Analytics.

apigee-service edge-qpid-server stop

En suspensión

Obtén el UUID de los nodos de edge-postgres-server:
```
curl http://pg_standby_ip:8084/v1/servers/self
```

Detén Postgres:

apigee-service edge-postgres-server stop

apigee-service apigee-postgresql stop

Sigue estos pasos para quitar la copia de seguridad de Postgres existente del grupo de Analytics.

Desinstala apigee-postgres y postgres-server:

apigee-service edge-postgres-server uninstall

apigee-service apigee-postgresql uninstall

Adquiere un nodo nuevo con el SO actualizado.
Aplica los requisitos previos específicos del SO.
Descarga el programa de arranque de la versión de Apigee en uso, ejecuta el programa de arranque para obtener apigee-service y, luego, instala apigee-setup.
Actualiza el archivo de configuración con EXISTING_PG_MASTER_IP y NEW_PG_STANDBY_IP para configurar la replicación principal en espera en la instancia principal existente. Para obtener más detalles, consulta la referencia del archivo de configuración:
```
PG_MASTER=EXISTING_PG_MASTER_IP
```
```
PG_STANDBY=NEW_PG_STANDBY_IP
```
```
apigee-service apigee-postgresql setup-replication-on-master -f updatedConfigFile
```
Instala, configura e inicia Postgres con parámetros de configuración de instancia principal y en espera en el nuevo nodo en espera:
```
PG_MASTER=EXISTING_PG_MASTER_IP
```
```
PG_STANDBY=NEW_PG_STANDBY_IP
```
```
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f updatedConfigFile
```

Verifica la configuración de espera:

apigee-service apigee-postgresql postgres-check-standby

Instancia principal

Obtén el UUID del nodo principal de Postgres existente:
```
curl http://pg_ip:8084/v1/servers/self
```
Promueve el nuevo nodo en espera del SO actualizado a principal.

Detén Postgres en el servidor principal existente:

apigee-service apigee-postgresql stop

apigee-service edge-postgres-server stop

Promueve el nuevo nodo en espera como principal:

apigee-service apigee-postgresql promote-standby-to-master EXISTING_PG_MASTER_IP

Quita el nodo principal anterior de los grupos de análisis y de consumidores.
Agrega el nuevo nodo principal a los grupos de Analytics y de consumidores.
Si usas la monetización, actualiza el nuevo nodo principal de Postgres y sigue estos pasos.
Una vez que se reemplaza el nodo principal, se puede iniciar edge-qpid-server con una configuración actualizada del nodo principal:
```
apigee-service edge-qpid-server start
```
Si usas la monetización, reinicia también el servidor de administración y el procesador de mensajes:
```
apigee-service edge-management-server restart
```

Detén y desinstala apigee-postgres y postgres-server en el nodo principal anterior:

apigee-service edge-postgres-server uninstall

apigee-service apigee-postgresql uninstall

Cómo agregar un nuevo anuncio en espera

Adquiere un nodo nuevo con el SO actualizado.
Aplica los requisitos previos específicos del SO.
Descarga el programa de arranque de la versión de Apigee en uso, ejecuta el programa de arranque para obtener apigee-service y, luego, instala apigee-setup.
Configura la replicación principal en espera con la nueva IP principal y la nueva IP del nodo en espera en el nuevo archivo de configuración del nodo principal y del nodo en espera. Para obtener más detalles, consulta la referencia del archivo de configuración:
```
apigee-service apigee-postgresql setup-replication-on-master -f updatedConfigFile
```

Instala y configura el nuevo nodo en espera:

/opt/apigee/apigee-setup/bin/setup.sh -p ps -f updatedConfigFile

Agrega el nuevo servidor en espera a los grupos de análisis siguiendo los pasos para la configuración de servidor principal y en espera.
Nota: Cuando agregues nodos en espera nuevos a los grupos de Analytics, asegúrate de quitar primero el nodo de Postgres existente y, luego, volver a agregarlo simultáneamente con el nodo en espera.

LDAP

Reemplazar el nodo LDAP requeriría que el servidor de administración se detuviera y que cualquiera de las APIs de administración se considerara no disponible durante el reemplazo de este nodo.

Detén el servidor de administración en todos los nodos:
```
apigee-service edge-management-server stop
```
Retira el nodo LDAP existente:
NOTA: Si usas la versión 4.53.01 o una posterior, asegúrate de usar mdb en cualquier configuración de LDAP. Si usas la versión 4.53.00 o una anterior, asegúrate de usar bdb en la configuración de LDAP.
1. Toma una copia de seguridad o una instantánea a nivel de la VM del nodo LDAP.
2. Antes de detener LDAP, asegúrate de capturar el recuento de datos de LDAP, que se puede verificar más adelante, por ejemplo:
```
ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" -D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w Secret123 | wc -l
```
3. Para la configuración activa-pasiva, haz lo siguiente:
  1. Para que el nodo pasivo actual se convierta en activo, agrega un archivo mark_writable.ldif en el nodo pasivo con el siguiente contenido:
```
dn: olcDatabase={2}bdb,cn=config
changetype: modify
replace: olcReadOnly
olcReadOnly: FALSE
```
  2. Ejecuta el siguiente comando en el nodo pasivo para activarlo:
```
ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_writable.ldif
```
  3. Continúa con el paso d) para la configuración activo-activo y retira los nodos.
4. En una configuración de LDAP activa-activa, interrumpe la replicación entre los dos nodos de LDAP y actualiza los parámetros de configuración. Sigue los pasos que se indican en el documento de baja de LDAP.
5. Detén y haz una copia de seguridad de los datos de LDAP, y desinstala el nodo de LDAP existente (omite este paso para la configuración activo-activo si ya lo hiciste):
```
apigee-service apigee-openldap stop
```
```
apigee-service apigee-openldap backup
```
```
apigee-service apigee-openldap uninstall
```
Adquiere un nodo nuevo con el SO actualizado.
Aplica los requisitos previos específicos del SO.
Descarga el programa de arranque de la versión de Apigee en uso, ejecuta el programa de arranque para obtener apigee-service y, luego, instala apigee-setup.
Configura un nuevo nodo LDAP:
1. Actualiza el configFile para el nodo nuevo según la configuración. Puedes consultar la referencia del archivo de configuración de Edge según la configuración activa o activa-activa:
  - LDAP_TYPE
  - LDAP_PEER
  - LDAP_SID
  - USE_LDAP_REMOTE_HOST=y/n
    Nota: Establece USE_LDAP_REMOTE_HOST en "y" o "n" según si LDAP está configurado en el mismo nodo que el servidor de administración o no.
2. Configura e inicia LDAP en el nodo nuevo con updatedConfigFile:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ld -f updatedConfigFile
```
3. Crea una copia de seguridad de los datos de LDAP de los nodos anteriores (si se puede omitir la configuración activo-activo):
  1. Toma una copia de seguridad de muestra en el nodo nuevo para que se genere una carpeta o ruta de acceso predeterminada de la copia de seguridad:
```
apigee-service apigee-openldap backup
```
  2. Mueve los datos de la copia de seguridad del nodo anterior a la carpeta de copia de seguridad generada.
  3. Detén apigee-openldap antes de restablecer los datos:
```
apigee-service apigee-openldap stop
```
  4. Restablece la copia de seguridad que se tomó del nodo anterior:
```
apigee-service apigee-openldap restore backup_file
```
    Por ejemplo:
```
apigee-service apigee-openldap restore 2026.02.09,10.28.20
```
Repite el proceso para otro nodo LDAP (si es activo-activo).
Vuelve a configurar y a iniciar el servidor de administración con la configuración de host de LDAP actualizada:
```
/opt/apigee/apigee-setup/bin/setup.sh -p mt -f updatedConfigFile
```

Restablece y comienza el SSO (si corresponde):

apigee-service apigee-sso setup -f updatedConfigFile

apigee-service apigee-sso restart

(Opcional) Configura el segundo directorio activo como de solo lectura siguiendo los pasos de la documentación.

Qpid

Para reemplazar un nodo Qpid existente por un nodo de SO actualizado, debemos asegurarnos de seguir los siguientes pasos:

Dejar de recibir mensajes en la cola de nodos existente de los procesadores de mensajes
Desvía los mensajes existentes en la cola.
Detén y retira el nodo existente.

Se retirarán los nodos existentes. Para asegurarte de que no se pierda ningún mensaje, se indican las siguientes medidas adicionales:

Detén el agente de Qpid:
```
apigee-service apigee-qpidd stop
```
Bloquea el tráfico entrante en el puerto 5672 de todos los Message Processors:
```
iptables -A INPUT -p tcp --dport 5672 -s MP_IP -j DROP
```
Vuelve a iniciar el agente de Qpid para vaciar los mensajes existentes:
```
apigee-service apigee-qpidd start
```
Antes de comenzar el proceso de baja, asegúrate de que todos los mensajes de la cola se hayan enviado al consumidor.

Obtén el UUID del nodo edge-qpid-server:

curl http://qpid_node_ip:8083/v1/servers/self

Completa los pasos para retirar o quitar Qpid de Analytics para apigee-qpidd y edge-qpid-server.

Detén y desinstala apigee-qpidd y edge-qpid-server:

apigee-service apigee-qpidd stop

apigee-service edge-qpid-server stop

apigee-service apigee-qpidd uninstall

apigee-service edge-qpid-server uninstall

Agregar un nodo nuevo:

Adquiere un nodo nuevo con el SO actualizado.
Aplica los requisitos previos específicos del SO.
Descarga el programa de arranque de la versión de Apigee en uso, ejecuta el programa de arranque para obtener apigee-service y, luego, instala apigee-setup.
Configura y ejecuta los servicios de Qpid en el nodo nuevo, y agrégalos a los grupos de consumidores siguiendo estos pasos. Sigue los mismos pasos para agregar otros grupos, como los de monetización.
Si el servicio de monetización está habilitado, reinicia el servidor de administración y el Message Processor:
```
apigee-service edge-management-server restart
```
```
apigee-service edge-message-processor restart
```
Repite este paso en todos los nodos de Qpid.

Message-processor

Obtén el UUID del nodo edge-message-processor:
```
curl http://mp_ip:8082/v1/servers/self
```
Retira y desinstala el nodo de Message Processor.
Si el servicio de monetización está habilitado, desinstala edge-mint-message-processor.

Desinstala Message Processor:

apigee-service edge-message-processor uninstall

Adquiere un nodo nuevo con el SO actualizado.
Aplica los requisitos previos específicos del SO.
Descarga el programa de arranque de la versión de Apigee en uso, ejecuta el programa de arranque para obtener apigee-service y, luego, instala apigee-setup.
Agrega, configura y, luego, inicia Message Processor en el clúster siguiendo estos pasos.
Si la monetización está habilitada, configura el servicio de monetización junto con el Message Processor. Para obtener más información, consulta la siguiente documentación.

Router

Obtén el UUID del nodo edge-router:

curl http://router_ip:8081/v1/servers/self

Inhabilita la accesibilidad y verifica si se puede acceder a ella:

iptables -A INPUT -i eth0 -p tcp --dport 15999 -j REJECT

curl -vvv -X GET http://router_ip:15999/v1/servers/self/reachable

Desactiva y desinstala el nodo del router.
Desinstala el router:
```
apigee-service edge-router uninstall
```
Adquiere un nodo nuevo con el SO actualizado.
Aplica los requisitos previos específicos del SO.
Descarga el bootstrap de la versión de Apigee en uso, ejecuta el bootstrap para obtener apigee-service y, luego, instala apigee-setup.
Agrega, configura y, luego, inicia el router en el clúster.

Servidor de administración

Solo un servidor de administración

Adquiere un nodo nuevo con el SO actualizado.
Aplica los requisitos previos específicos del SO.
Descarga el bootstrap de la versión de Apigee en uso, ejecuta el bootstrap para obtener apigee-service y, luego, instala apigee-setup.
Agrega el servidor de administración con la IP y el archivo de configuración actualizados, a los que puedes hacer referencia aquí, y ejecuta el comando de configuración:
```
/opt/apigee/apigee-setup/bin/setup.sh -p mt -f updatedConfigFile
```
Restablece y reinicia la IU con la nueva configuración de IP de administración.
```
/opt/apigee/apigee-setup/bin/setup.sh -p ui -f updatedConfigFile
```
Vuelve a configurar el SSO con la nueva configuración de IP de administración (si corresponde):
```
/opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile
```
Vuelve a configurar la nueva IU (UE) con la nueva configuración de IP de administración (si corresponde):
```
/opt/apigee/apigee-setup/bin/setup.sh -p ue -f updatedConfigFile
```
Si la monetización está habilitada, haz lo siguiente:
1. Vuelve a configurar el MS de monetización con la nueva configuración de IP de administración (si corresponde). Consulta la documentación de la configuración de monetización.
```
/opt/apigee/apigee-setup/bin/setup.sh -p mo -f updatedConfigFile
```
2. Reinicia el servidor de administración:
```
apigee-service edge-management-server restart
```
Retira de servicio el servidor de administración en el nodo existente o anterior siguiendo los pasos.

Si la monetización está habilitada, quita el UUID del servidor de administración de los grupos de análisis. Ejemplo:

curl -v -u AdminEmail:AdminPassword -X DELETE "http://localhost:8080/v1/analytics/groups/ax/mint_axgroup/servers?uuid=MS_UUID&type=consumer-server"

Desinstala el servidor de administración de la monetización:
```
apigee-service edge-mint-management-server uninstall
```

Varios servidores de administración

Retire uno de los servidores de administración usando el otro en el nodo existente, siguiendo los pasos.

Detén y desinstala el servidor de administración:

apigee-service edge-management-server stop

apigee-service edge-management-server uninstall

Adquiere un nodo nuevo con el SO actualizado.
Aplica los requisitos previos específicos del SO.
Descarga el bootstrap de la versión de Apigee en uso, ejecuta el bootstrap para obtener apigee-service y, luego, instala apigee-setup.
Agrega el servidor de administración con la IP y el archivo de configuración actualizados, a los que puedes hacer referencia aquí, y ejecuta el comando de configuración:
```
/opt/apigee/apigee-setup/bin/setup.sh -p mt -f updatedConfigFile
```
Restablece y reinicia la IU con la configuración de IP de administración actualizada:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ui -f updatedConfigFile
```
(Solo si el SSO está habilitado) Vuelve a configurar y reiniciar el SSO con la configuración de IP de administración actualizada:
```
/opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile
```
(Solo si la IU nueva está habilitada) Restablece y reinicia la IU nueva con la configuración de IP de administración actualizada:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ue -f updatedConfigFile
```
Repite el proceso para el otro servidor de administración.

IU/UE

Toma una copia de seguridad o una instantánea de la VM del nodo de IU.

Detener y desinstalar la IU:

apigee-service edge-ui stop

apigee-service edge-ui uninstall

(Solo si usas la nueva IU) Detén y desinstala la nueva IU:

apigee-service edge-management-ui stop

apigee-service edge-management-ui uninstall

Adquiere un nodo nuevo con el SO actualizado.
Aplica los requisitos previos específicos del SO.
Descarga el bootstrap de la versión de Apigee en uso, ejecuta el bootstrap para obtener apigee-service y, luego, instala apigee-setup.
Configura y ejecuta edge-ui en el nodo nuevo con las configuraciones de IP actualizadas:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ui -f updatedConfigFile
```
(Solo si el SSO está habilitado) Vuelve a configurar y ejecuta el SSO con las nuevas configuraciones de IP del nodo de la IU según corresponda:
```
/opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile
```

(Solo si la IU nueva está habilitada) Configura y ejecuta la IU nueva en el nodo nuevo con las configuraciones de IP actualizadas:

/opt/apigee/apigee-setup/bin/setup.sh -p ue -f updatedConfigFile

apigee-service edge-management-ui configure-sso -f updatedConfigFile

apigee-service edge-ui configure-sso -f updatedConfigFile

SSO

Toma una copia de seguridad o una instantánea de la VM del nodo de IU.

Detén y desinstala el SSO:

apigee-service apigee-sso stop

apigee-service apigee-sso uninstall

Adquiere un nodo nuevo con el SO actualizado.
Aplica los requisitos previos específicos del SO.
Descarga el programa de arranque de la versión de Apigee en uso, ejecuta el programa de arranque para obtener apigee-service y, luego, instala apigee-setup.
Agrega configuraciones y claves para el SSO siguiendo la guía, teniendo en cuenta la nueva IP del nodo.

Configura e inicia el SSO:

/opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile

Actualiza la configuración con las nuevas IPs de los nodos de SSO y vuelve a configurar el SSO para la IU:
```
apigee-service edge-ui configure-sso -f updatedConfigFile
```

(Si usas la IU nueva) Ejecuta configure-sso en el nodo de la IU nueva, consultando la documentación:

apigee-service edge-management-ui configure-sso -f updatedConfigFile

apigee-service edge-ui configure-sso -f updatedConfigFile