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

Actualiza Apigee Edge 4.53.00 o 4.53.01 a 4.54.00

Apigee admite la actualización de Edge para la nube privada directamente desde la versión 4.53.00 o 4.53.01 a la versión 4.54.00. En esta página, se describe cómo realizar esas actualizaciones.

Para obtener una descripción general de las rutas de actualización compatibles, consulta la matriz de compatibilidad de actualización para las versiones de Edge para nube privada.

Quién puede realizar la actualización

La persona que ejecuta la actualización debe ser la misma que instaló Edge originalmente o una persona que se ejecuta como raíz.

Después de instalar los RPM de Edge, cualquier persona puede configurarlos.

¿Qué componentes debes actualizar?

Debes actualizar todos los componentes de Edge. Edge no admite una configuración que contenga componentes de varias versiones.

Materiales de lectura previa

Revisa los siguientes temas para obtener información importante sobre los cambios que se introdujeron en Edge para la nube privada 4.54.00:

Cambios en la versión 4.54.00: Revisa los cambios en TLS y la llamada de código Java que requieren preparación antes de la actualización. Para obtener más información, consulta Cambios en la versión 4.54.00.
Arquitectura de tiempo de ejecución de Java doble (Java 17 y Java 21): A partir de la versión 4.54.00, Edge para nubes privadas ya no admite Java 8 y ejecuta componentes en Java 17 o Java 21. Para obtener más información, consulta Cambios en la versión 4.54.00.
No se realiza la instalación automática de Java durante el inicio: Edge para nube privada 4.54.00 tiene la capacidad de detectar instalaciones de Java y valida que tengas instaladas las versiones 17 y 21 de Java.
Nueva IU de Edge en 4.54.00: Obtén información sobre la transición a la nueva IU de Edge como la interfaz de administración predeterminada y la eliminación de la IU clásica (edge-ui). Para obtener más información, consulta Nueva IU de Edge.
SSO de Apigee en la versión 4.54.00: Comprende la arquitectura de SSO actualizada y los cambios de configuración para la autenticación. Para obtener más información, consulta SSO de Apigee.
Nginx 1.30 en la versión 4.54.00: Revisa la actualización automática de Nginx 1.30.x en los Edge Routers, los posibles impactos en el tiempo de ejecución y los pasos de mitigación. Para obtener más información, consulta Cambios en Nginx 1.30.

Requisitos previos de la actualización

Asegúrate de cumplir con los siguientes requisitos antes de actualizar Apigee Edge:

Revisa las notas de la versión y las funciones nuevas

Asegúrate de revisar y comprender todas las funciones nuevas, los cambios de comportamiento y las retiradas que se detallan en las notas de la versión 4.54.00 de Edge para nube privada antes de iniciar el proceso de actualización.
Detección automática de objetos binarios de Java y coexistencia durante la actualización: Instala Java con administradores de paquetes estándar (como yum) o ubicaciones estándar (como /usr/lib/jvm o update-alternatives). No es necesario que configures ambas versiones en la PATH del sistema de forma simultánea. No desinstales Java 8 antes de actualizar. Mantén Java 8 instalado junto con Java 17 y Java 21 para que los servicios existentes de Edge para nube privada 4.53.xx sigan ejecutándose sin interrupciones hasta que se actualicen.
Crea una copia de seguridad de todos los nodos

Antes de actualizar, te recomendamos que realices una copia de seguridad completa de todos los nodos por motivos de seguridad. Sigue el procedimiento para tu versión actual de Edge para realizar la copia de seguridad. Esto te permite tener un plan de respaldo en caso de que la actualización a una versión nueva no funcione correctamente. Para obtener más información sobre las copias de seguridad, consulta Copia de seguridad y restablecimiento.
Copia de seguridad del archivo de configuración silenciosa

Asegúrate de conservar copias de seguridad de los archivos de configuración silenciosa de Edge para la nube privada 4.53.00 o 4.53.01 para facilitar una reversión si es necesario.
Asegúrate de que Edge esté en ejecución

Para asegurarte de que Edge esté en funcionamiento durante el proceso de actualización, usa el siguiente comando:
```
/opt/apigee/apigee-service/bin/apigee-all status
```
Verifica los requisitos previos de Cassandra

Si anteriormente actualizaste de una versión anterior de Edge para nube privada a la versión 4.53.00 (o) 4.53.01 y ahora planeas actualizar a la versión 4.54.00, asegúrate de haber completado los pasos posteriores a la actualización requeridos para Cassandra. Estos pasos se describen en la documentación de actualización de la versión 4.53.00 (o) 4.53.01 y también se mencionan en Requisitos previos para la actualización de Cassandra. Si no tienes certeza de que estos pasos se hayan completado durante la actualización anterior, vuelve a completarlos antes de continuar con la actualización a la versión 4.54.00.
Detén apigee-monit: Si apigee-monit se ejecuta en el nodo, detenlo con /opt/apigee/apigee-service/bin/apigee-service apigee-monit stop antes de actualizarlo. Esto evita que apigee-monit reinicie automáticamente los componentes mientras se actualizan. Vuelve a habilitarlo con apigee-service apigee-monit start después de que se complete la actualización.

Propagación automática de la configuración de la propiedad

Si editaste archivos .properties en /opt/apigee/customer/application para establecer propiedades, la actualización conservará esos valores.

Actualiza el router y el Message Processor

Actualiza todos los nodos de routers y Message Processor en los centros de datos uno por uno:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Actualiza el servidor de administración

Actualiza todos los nodos del servidor de administración en los centros de datos uno por uno:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Actualiza a OpenLDAP 2.6.10

Edge para nube privada 4.54.00 introduce OpenLDAP 2.6.10. Esta actualización se aplica a todas las topologías de implementación de OpenLDAP de Apigee: servidor único, activo-pasivo y activo-activo (multimaestro).

Preparación e instalación (todos los servidores LDAP)

Pasos para actualizar LDAP de la versión 4.53.00 a la 4.54.00

Requisitos previos y consideraciones

Ten en cuenta que, durante el proceso de migración de OpenLDAP 2.4 a 2.6.10 (cuando se actualiza desde la versión 4.53.00), las API de Management y, por lo tanto, la IU de Apigee no estarán disponibles en todas las regiones. Todas las tareas administrativas, como la administración de usuarios, roles, apps y organizaciones, fallarán y se deben pausar. No hay impacto en el procesamiento del tráfico de tu proxy de API. Cierra todas las instancias de edge-management-server y edge-ui antes de continuar con la migración de LDAP.
La copia de seguridad es fundamental (cuando se actualiza desde la versión 4.53.00): Cuando actualices desde Edge para nube privada 4.53.00 (OpenLDAP 2.4.46), es obligatorio realizar una copia de seguridad completa y validada de tus datos de LDAP existentes. Si continúas sin una copia de seguridad válida, se producirá una pérdida de datos irreversible. Inicia la copia de seguridad mientras el servicio de LDAP aún se esté ejecutando para capturar una instantánea coherente y de un momento determinado de los datos de LDAP. Sin una copia de seguridad, no puedes ejecutar la migración de 2.4 a 2.6.10 ni revertirla, ya que los pasos de migración de 4.53.00 borran los directorios de datos de LDAP heredados.

Apaga el servidor de administración y la IU: Apaga todas las instancias de edge-management-server y edge-ui antes de continuar con la migración de LDAP desde la versión 4.53.00.
```
apigee-service edge-management-server stop
apigee-service edge-ui stop
```
Crea una copia de seguridad de los datos de LDAP existentes: Antes de realizar cualquier cambio cuando actualices desde la versión 4.53.00 (OpenLDAP 2.4.46), crea una copia de seguridad completa de los datos de LDAP actuales de todos los servidores LDAP. Esto crea un punto de restauración seguro. (Cuando se actualiza de la versión 4.53.01 a la 4.54.00, no se requiere esta secuencia de copia de seguridad, detención y limpieza).
- Ejecuta el comando de copia de seguridad. Esta acción crea un archivo de copia de seguridad con marca de tiempo en el directorio /opt/apigee/backup/openldap.
```
apigee-service apigee-openldap backup
```
- Obtén el recuento total de registros: Captura la cantidad de registros de tu directorio para la validación posterior a la actualización. (El recuento de registros debe coincidir en todos los servidores LDAP).
```
# Note: Replace 'YOUR_PASSWORD' with your current LDAP manager password.
ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" \
-D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w 'YOUR_PASSWORD' | wc -l
```
Detén LDAP y limpia los directorios de datos: Realiza este paso en todos los servidores LDAP solo si actualizas desde la versión 4.53.00 (OpenLDAP 2.4.46). No detengas LDAP ni borres /opt/apigee/data/apigee-openldap/* si actualizas desde la versión 4.53.01 (OpenLDAP 2.6.7). En el caso de las actualizaciones a la versión 4.53.00, este paso es obligatorio debido al cambio de versión principal y a las diferencias estructurales subyacentes de la base de datos. Cuando se detienen todos los servidores LDAP, comienza la interrupción de las API de Management y la IU.
- Detén el servicio de LDAP.
```
apigee-service apigee-openldap stop
```
- Quita de forma permanente los directorios de configuración y datos de LDAP antiguos.
```
rm -rf /opt/apigee/data/apigee-openldap/*
```
Instala y configura la nueva versión de LDAP: En todos los servidores LDAP, usa las secuencias de comandos estándar de Apigee para descargar e instalar la nueva versión del componente.
- Instala el nuevo componente de LDAP: La secuencia de comandos de actualización lee tu archivo de configuración y, luego, instala el nuevo paquete apigee-openldap.
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
- Valida la nueva versión de LDAP: Una vez que se complete la instalación, vuelve a cargar el perfil y verifica que esté instalada la nueva versión de LDAP (2.6.10):
```
echo 'export PATH=/opt/symas/bin:$PATH' >> ~/.bash_profile
source ~/.bash_profile
ldapsearch -VV
```
  El resultado del comando especificado anteriormente debe verificar la versión 2.6.10 de LDAP, como se muestra a continuación:
```
Expected output:
ldapsearch: @(#) OpenLDAP: ldapsearch 2.6.10
```
Detén LDAP en todos los servidores antes de restablecer los datos: Realiza los pasos 5, 6 y 7 solo si actualizas desde la versión 4.53.00 (OpenLDAP 2.4.46) (si actualizaste desde la versión 4.53.01 en el paso 4, se conservarán tus datos de LDAP existentes y se completará la actualización). Antes de restablecer la copia de seguridad de la versión 4.53.00, asegúrate de que el servicio LDAP recién instalado esté detenido en todos los servidores. En cada servidor LDAP, ejecuta los siguientes comandos:
```
apigee-service apigee-openldap stop
rm -rf /opt/apigee/data/apigee-openldap/ldap/*
```
Restablece los datos de LDAP: La estrategia consiste en restablecer la copia de seguridad en el primer servidor activo. Luego, este servidor actuará como la fuente de información y replicará los datos en sus pares en una configuración de varios servidores.
1. Identifica el primer servidor activo para la restauración:
  - Para la configuración de un solo servidor: Este es tu único servidor LDAP. Puedes continuar directamente con el siguiente paso.
  - Para las configuraciones activo-pasivo y activo-activo: Ejecuta el siguiente comando de diagnóstico en cada servidor LDAP:
```
grep -i '^olcSyncrepl:' /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase*.ldif
```
    Nota:
    - Si el comando anterior devuelve un resultado, significa que el servidor es pasivo.
    - Si no devuelve ningún resultado, el servidor es el servidor activo.
2. Restablece los datos de la copia de seguridad: Antes de continuar, verifica que el paso 5 se haya completado correctamente en todos los servidores LDAP.
  - En el primer servidor activo que identificaste anteriormente, navega al directorio de copia de seguridad.
```
cd /opt/apigee/backup/openldap
```
  - Ejecuta el comando de restablecimiento. Especifica la marca de tiempo exacta de la copia de seguridad del paso 2 para evitar que se restablezca una versión anterior o no deseada.
```
# To restore a specific backup (recommended):
apigee-service apigee-openldap restore 2025.08.11,23.34.00

# To restore the latest available backup by default:
apigee-service apigee-openldap restore
```
  - Una vez que el proceso de restablecimiento se complete correctamente, inicia el servicio LDAP en el primer servidor activo.
```
apigee-service apigee-openldap start
```
Inicia los servidores LDAP restantes: Si tienes una configuración de varios servidores, inicia el servicio en cada uno de los servidores LDAP:
```
apigee-service apigee-openldap start
```
Nota: No es necesario que restablezcas los datos de forma manual en estos servidores de intercambio de tráfico. Cuando se inicien, se conectarán al primer servidor (que ahora contiene los datos restablecidos) y sincronizarán automáticamente todo el directorio a través de la replicación.
Validación final: El último paso es verificar que la actualización se haya realizado correctamente y que los datos sean coherentes en todo el clúster de LDAP.
- Ejecuta el comando de validación en todos los servidores LDAP. El recuento de registros debe ser idéntico en todos los servidores y debe coincidir con el recuento que capturaste en el paso 2:
```
# Note: Replace 'YOUR_PASSWORD' with your LDAP manager password.
ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" -D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w 'YOUR_PASSWORD' | wc -l
```
- Después de confirmar que los datos son correctos y coherentes, se completará la actualización de LDAP. Ahora puedes iniciar edge-management-server, edge-ui y cualquier otro componente dependiente según el procedimiento de actualización estándar de tu organización.

Pasos para actualizar LDAP de la versión 4.53.01 a la 4.54.00

Instala y configura la nueva versión de LDAP: En todos los servidores LDAP, usa las secuencias de comandos estándar de Apigee para descargar e instalar la nueva versión del componente.

Instala el nuevo componente de LDAP: La secuencia de comandos de actualización lee tu archivo de configuración y, luego, instala el nuevo paquete apigee-openldap.
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
Valida la nueva versión de LDAP: Una vez que se complete la instalación, vuelve a cargar el perfil y verifica que esté instalada la nueva versión de LDAP (2.6.10):
```
echo 'export PATH=/opt/symas/bin:$PATH' >> ~/.bash_profile
source ~/.bash_profile
ldapsearch -VV
```
El resultado del comando especificado anteriormente debe verificar la versión 2.6.10 de LDAP, como se muestra a continuación:
```
Expected output:
ldapsearch: @(#) OpenLDAP: ldapsearch 2.6.10
```

Actualiza a la nueva IU de Edge y al SSO de Apigee (si está instalado)

En Apigee Edge para nube privada 4.54.00, se quita la IU clásica (edge-ui) y se reemplaza por la nueva IU de Edge (edge-management-ui). Según si el inicio de sesión único (SSO) de Apigee está instalado y se usa en tu configuración, sigue una de las dos opciones que se indican a continuación:

Opción 1: Actualiza la IU (sin el SSO de Apigee)

Esta sección se aplica exclusivamente si SSO de Apigee (apigee-sso) no está configurado ni instalado en tu instalación existente de Edge para nube privada de la versión 4.53.00 o 4.53.01.

Como parte del proceso de actualización de Edge para nube privada a la versión 4.54.00, se quitó la IU clásica (edge-ui). La ejecución del siguiente comando de actualización hace que el nodo de la IU pase de la IU clásica (edge-ui) a la nueva IU de Edge(edge-management-ui).

Paso 1: Crea una copia de seguridad de los archivos de configuración

Antes de iniciar, realiza una copia de seguridad del archivo de configuración silenciosa existente (configFile) y del directorio /opt/apigee/customer/application/ en todos los nodos de la IU.

Paso 2: Actualiza el archivo de configuración silenciosa para la autenticación básica

Edita tu archivo de configuración silenciosa (por ejemplo, /opt/silent.conf) y agrega las siguientes propiedades de la IU de New Edge para la autenticación básica:

# Authentication mode for New Edge UI (Basic Authentication - No Apigee SSO)
AUTH_MODE=basic

# Access configuration for the New Edge UI
MANAGEMENT_UI_PORT=3001
MANAGEMENT_UI_APP_ENV=OPDK
MANAGEMENT_UI_IP=MANAGEMENT_UI_NODE_IP #Replace MANAGEMENT_UI_NODE_IP with the IP address or hostname of the UI node.
MANAGEMENT_UI_SCHEME=http

Paso 3: Actualiza el componente de la IU

Ejecuta la secuencia de comandos update.sh con el componente -c ue para actualizar de la IU clásica (edge-ui) a la IU de Edge nueva (edge-management-ui):

/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile

Paso 4: Verifica la actualización de la IU de Edge nueva

Una vez que hayas completado correctamente el proceso de actualización en todos los nodos de la IU, verifica que la versión 4.54.00 de la nueva IU de Edge esté completamente operativa y accesible:

Verifica que el servicio edge-management-ui esté en ejecución:
```
apigee-service edge-management-ui status
```
Abre un navegador y navega a la siguiente dirección:
```
http://MANAGEMENT_UI_NODE_IP:3001
```
Una vez que se verifique, omite Opción 2: Actualiza la IU (con el SSO de Apigee) y continúa directamente con Actualización obligatoria a Qpid.

Opción 2: IU de actualización (con SSO de Apigee)

Usa esta sección si el SSO de Apigee (apigee-sso) está configurado o instalado en tu entorno de Edge para nube privada 4.53.00 o 4.53.01.

En Apigee Edge para nube privada 4.54.00:

El servicio de SSO de Apigee subyacente pasa del componente heredado apigee-sso al SSO de Apigee administrado en apigee-openldap. Esta actualización es obligatoria cuando se actualiza a la versión 4.54.00 de Apigee Edge para nube privada si el SSO está habilitado en la versión 4.53.00 o 4.53.01 de Edge para nube privada.
Tanto la IU clásica 4.53.x (edge-ui) con SSO como la IU de Edge nueva 4.53.x (edge-management-ui) con SSO se actualizan a la IU de Edge nueva 4.54.00 (edge-management-ui) con SSO de Apigee.

Lee los siguientes artículos para comprender el nuevo diseño del SSO de Apigee y su impacto en las utilidades y los flujos de automatización con la API de Management:
Acerca de la nueva estructura del SSO de Apigee
Tareas automatizadas con SSO

Sigue los pasos consolidados de extremo a extremo que se indican a continuación para actualizar la IU y el SSO de Apigee de forma limpia sin pasos de configuración duplicados:

Paso 1: Haz una copia de seguridad de los archivos de configuración

Crea una copia de seguridad de tu configFile silencioso existente y del directorio /opt/apigee/customer/application/ en todos los nodos de IU y SSO antes de continuar.

Paso 2: Quita las variables de IU o SSO obsoletas y actualiza el archivo de configuración silenciosa (`configFile`)

Antes de actualizar la IU de New Edge y configurar el módulo de SSO de Apigee, actualiza tu archivo de configuración silenciosa (configFile) en un solo paso según tu configuración actual de la IU 4.53.x:

Quita o marca como comentario las variables de IU y SSO de la versión 4.53.x que están obsoletas de configFile:

Si actualizas desde la IU clásica (edge-ui) con apigee-sso, quita o marca como comentario las propiedades relacionadas con la IU clásica y el SSO:

EDGEUI_SSO_ENABLED=y
EDGEUI_SSO_CLIENT_NAME=edgeui
EDGEUI_SSO_CLIENT_SECRET=edgeuisecret
EDGEUI_PUBLIC_URIS=
EDGEUI_SSO_CLIENT_OVERWRITE=y
EDGEUI_SSO_REGISTERD_PUBLIC_URIS=$EDGEUI_PUBLIC_URIS

Si actualizas desde la nueva IU de Edge (edge-management-ui) con apigee-sso, quita o marca como comentario las propiedades obsoletas de la IU clásica 4.53.x, Shoehorn y las relacionadas con el SSO:

EDGEUI_SSO_ENABLED=y
EDGEUI_SSO_CLIENT_NAME=edgeui
EDGEUI_SSO_CLIENT_SECRET=edgeuisecret
EDGEUI_PUBLIC_URIS=
EDGEUI_SSO_CLIENT_OVERWRITE=y
EDGEUI_SSO_REGISTERD_PUBLIC_URIS=$EDGEUI_PUBLIC_URIS
EDGEUI_ENABLE_UNIFIED_UI=n
SHOEHORN_SCHEME=$MANAGEMENT_UI_SCHEME
SHOEHORN_IP=$MANAGEMENT_UI_IP
SHOEHORN_PORT=9000
CLASSIC_UI_SCHEME=http
CLASSIC_UI_PORT=9000
MANAGEMENT_UI_PUBLIC_URIS=http://Public_IP:3001
MANAGEMENT_UI_SSO_REGISTERD_PUBLIC_URIS=$MANAGEMENT_UI_PUBLIC_URIS
ROUTES_CLASSICUI=""
ROUTES_SHOEHORN=""

Usa el siguiente comando en el nodo apigee-openldap para crear un usuario de máquina para la nueva IU de Edge y asegúrate de usar las mismas credenciales exactas cuando definas la propiedad en el archivo de configuración silenciosa (configFile) en el paso posterior. Para obtener más información, consulta Crea un usuario de máquina para la IU.
```
/opt/apigee/apigee-openldap/bin/apigee-machineuser.sh add -u ui-machine-user@apigee.com -p Secret123
```

Agrega o actualiza las propiedades obligatorias de SSO de Apigee 4.54.00 y de la IU de Edge nueva en configFile:

# ==========================================
# SSO Enablement
# ==========================================
ENABLE_SSO=y

# ==========================================
# SSO Hostname/IP and Port config for Apigee SSO
# ==========================================
SSO_PUBLIC_URL_SCHEME=http
SSO_PUBLIC_URL_HOSTNAME=YOUR_SSO_NODE_IP_OR_HOSTNAME #Replace YOUR_SSO_NODE_IP_OR_HOSTNAME with the IP address or hostname of the SSO node.
SSO_PUBLIC_URL_PORT=9099

# ==========================================
# Static Client UI credentials
# ==========================================
MANAGEMENT_UI_SSO_CLIENT_ID=YOUR_SSO_CLIENT_ID #Example : MANAGEMENT_UI_SSO_CLIENT_ID=unifiedui
MANAGEMENT_UI_SSO_CLIENT_SECRET=YOUR_SSO_CLIENT_SECRET #Example : MANAGEMENT_UI_SSO_CLIENT_SECRET=secret123

# ==========================================
# Management UI & SSO redirect URLs
# ==========================================
MANAGEMENT_UI_SCHEME=http
MANAGEMENT_UI_IP=MANAGEMENT_UI_NODE_IP #Replace MANAGEMENT_UI_NODE_IP with the IP address or hostname of the UI node.
MANAGEMENT_UI_PORT=3001

# ==========================================
# Management Server parameters (Required for SSO registration)
# ==========================================
MSIP=MS_IP_OR_HOSTNAME #Replace MS_IP_OR_HOSTNAME with the IP address or hostname of the Management Server node.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=your_password

# ==========================================
# Machine user for UI
# ==========================================
UI_MACHINE_USER=ui-machine-user@apigee.com
UI_MACHINE_PWD=Secret123

# ==========================================
# Postgres connection parameters
# ==========================================
# Postgres username and password as set when you installed Edge.
PG_HOST=PG_IP_OR_HOSTNAME
PG_USER=apigee
PG_PWD=YOUR_PG_PASSWORD

# ==========================================
# Other UI Parameters
# ==========================================
AUTH_MODE=sso

# Y to use Internal/Local LDAP for authentication, N to use external IDP
SSO_LOCAL_LDAP=y

MANAGEMENT_UI_APP_ENV=OPDK
MANAGEMENT_UI_SSO_ENABLED=y
MANAGEMENT_UI_SSO_CSRF_SECRET=YOUR_CSRF_SECRET
MANAGEMENT_UI_SSO_CSRF_EXPIRATION_HOURS=24
MANAGEMENT_UI_SSO_STRICT_TRANSPORT_SECURITY_AGE_HOURS=24
MANAGEMENT_UI_SSO_PUBLIC_KEY_CACHE_HOURS=0.5

Paso 3: Actualiza el componente de la IU de Edge nueva

Detén y desinstala los componentes edge-management-ui (nueva IU de Edge) y edge-ui (IU de Shoehorn) si actualmente se usa la nueva IU de Edge :

#Remove 4.53.xx New Edge UI from installation node 
apigee-service edge-management-ui stop
apigee-service edge-management-ui uninstall

#Remove Shoehorn UI from the node with 4.53.xx New Edge UI
apigee-service edge-ui stop
apigee-service edge-ui uninstall

Ejecuta la secuencia de comandos update.sh en los nodos de la IU clásica (edge-ui) para instalar y actualizar el componente de la nueva IU de Edge (edge-management-ui):
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
```

Paso 4: Detén el `apigee-sso`

Detén el servicio heredado apigee-sso en todos los nodos en los que esté instalado:

apigee-service apigee-sso stop

Paso 5: Crea la base de datos `apigee_dex` para el SSO de Apigee en el nodo de Postgres

En el nodo principal de Postgres, accede a Postgresql con el siguiente comando:
```
psql -h $(hostname -i) -U apigee
```
Ejecuta el siguiente comando en el mensaje de psql para crear la base de datos de SSO de Apigee:
```
create database apigee_dex;
```

Paso 6: Configura el SSO de Apigee en los nodos de OpenLDAP

Ejecuta el siguiente comando en el nodo apigee-openldap en el que se instalará Apigee SSO:

/opt/apigee/apigee-service/bin/apigee-service apigee-openldap setup-sso -f configFile

Paso 7: Configura la IU de administración para el SSO de Apigee y reinicia la IU

Ejecuta los siguientes comandos en cada nodo que tenga instalado Edge para nube privada 4.54.00 edge-management-ui:

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-sso -f configFile

Paso 8: Verifica la actualización de la IU de Edge nueva y el SSO de Apigee

Después de completar los pasos anteriores, verifica que la nueva IU de Edge y el SSO de Apigee de la versión 4.54.00 se estén ejecutando y sean accesibles:

Verifica que el servicio edge-management-ui esté en ejecución:
```
apigee-service edge-management-ui status
```
Abre un navegador y navega a la siguiente URL:
```
http://MANAGEMENT_UI_NODE_IP:3001
```
Accede con tus credenciales de SSO configuradas.

Paso 9: Desinstala la versión heredada de `apigee-sso`

En todos los nodos en los que se instaló apigee-sso heredado, desinstala el componente apigee-sso:

apigee-service apigee-sso uninstall

Actualiza a Qpid 10.0.1

Este método garantiza que no haya tiempo de inactividad en tu entorno de ejecución de Edge y minimiza la pérdida de datos del entorno de ejecución, si los hay, adquiridos para las estadísticas.

Para realizar una actualización in situ sin tiempo de inactividad a Qpid, haz lo siguiente:

Elige un nodo de Qpid para comenzar.
Detén el agente de Qpid en el nodo:
```
apigee-service apigee-qpidd stop
```
Bloquea el tráfico entrante en el puerto 5672 del agente de mensajes desde todos los Message Processors aplicando un firewall. Puedes aplicar este firewall a nivel de la instancia del nodo de Qpid o algún otro componente de red o firewall externo.

Te recomendamos que realices el mismo paso para todas las direcciones IP del Message Processor. Por ejemplo, para DESCARTAR las solicitudes que provienen de direcciones IP del Message Processor al nodo de Qpid en el puerto 5672 con IPTables, puedes usar un comando como este:
```
iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
```
Vuelve a iniciar el agente de Qpid para vaciar los mensajes existentes, si los hay:
```
apigee-service apigee-qpidd start
```
Verifica que las colas existentes estén vacías:
```
/opt/apigee/apigee-qpidd/bin/qpid-stat -q
```
Si los mensajes están atascados en la cola de mensajes no entregados (DLQ) (ax-q-axgroup-001-consumer-group-001-dl), vacía la cola siguiendo los pasos para resolver el problema de los datos de análisis atascados en la cola de mensajes no entregados.
Después de verificar que las colas se hayan vaciado en el nodo anterior, detén apigee-qpidd:
```
apigee-service apigee-qpidd stop
```

Actualiza Qpid en el nodo:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Reinicia edge-qpid-server:
```
apigee-service edge-qpid-server restart
```
Quita la regla de firewall que se aplicó en el paso 3.

Realiza el mismo paso de eliminación para todas las direcciones IP del Message Processor a las que se aplicó el firewall. Una vez que se quiten los firewalls, se aceptarán las solicitudes que provengan de las direcciones IP del Message Processor al nodo de Qpid en el puerto 5672. Si usaste iptables para agregar el firewall, quitarlo y enumerar la configuración existente, puedes usar comandos como los siguientes:
```
iptables -F
iptables -L
```
Usa la supervisión web para verificar que las colas de Qpid reciban mensajes:
```
http://QPID_NODE_IP:8090
```
Repite los pasos del 1 al 9 para cada nodo de Qpid.

Actualiza a Postgres 18.6

Esta versión de Edge incluye una actualización a Postgres 18.6. Como parte de esa actualización, todos los datos de Postgres se migran a Postgres 18.6.

La mayoría de los sistemas de producción de Edge usan dos nodos de Postgres configurados para la replicación principal y en espera. Durante el proceso de actualización, mientras los nodos de Postgres están inactivos para la actualización, los datos de estadísticas se siguen escribiendo en los nodos de Qpid. Después de que se actualizan los nodos de Postgres y vuelven a estar en línea, los datos de análisis se envían a los nodos de Postgres.

La forma en que realizas la actualización de Postgres depende de cómo configuraste el almacenamiento de datos para tus nodos de Postgres:

Si usas el almacén de datos local para tus nodos de Postgres , debes instalar un nodo de Postgres en espera nuevo durante la actualización. Una vez que se complete la actualización, podrás retirar el nuevo nodo en espera de Postgres. El nodo de Postgres en espera adicional es necesario si tienes que revertir la actualización por cualquier motivo. Si tienes que revertir la actualización, el nuevo nodo en espera de Postgres se convierte en el nodo principal de Postgres después de la reversión. Por lo tanto, cuando instales el nuevo nodo en espera de Postgres, debe estar en un nodo que cumpla con todos los requisitos de hardware de un servidor de Postgres, como se define en los Requisitos de instalación de Edge.

En una configuración de 1 y 2 nodos de Edge, las topologías que se usan para la creación de prototipos y las pruebas, solo tienes un nodo de Postgres. Puedes actualizar estos nodos de Postgres directamente sin tener que crear un nodo de Postgres nuevo.
Si usas el almacenamiento de red para tus nodos de Postgres , como recomienda Apigee, no es necesario que instales un nodo de Postgres nuevo. En los procedimientos que se indican a continuación, puedes omitir los pasos que especifican instalar y, luego, retirar un nodo en espera de Postgres nuevo. Antes de comenzar el proceso de actualización, toma una instantánea de red del almacén de datos que usa Postgres. Luego, si se produce algún error durante la actualización y te ves en la obligación de revertirla, puedes restablecer el nodo de Postgres desde esa instantánea.

Instala un nuevo nodo en espera de Postgres

En este procedimiento, se crea un servidor de espera de Postgres en un nodo nuevo. Asegúrate de instalar un nuevo servidor de espera de Postgres para tu versión existente de Edge (4.53.00 o 4.53.01), no para la versión 4.54.00.

Para realizar la instalación, usa el mismo archivo de configuración que usaste para instalar la versión actual de Edge.

Para crear un nuevo nodo de Postgres en espera, sigue estos pasos:

En el servidor principal actual de Postgres, edita el archivo /opt/apigee/customer/application/postgresql.properties para establecer el siguiente token. Si ese archivo no existe, créalo:
```
conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust
```
Donde existing_standby_ip es la dirección IP del servidor en espera de Postgres actual y new_standby_ip es la dirección IP del nodo en espera nuevo.

Reinicia apigee-postgresql en la instancia principal de Postgres:

/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

Para verificar que se agregó el nuevo nodo en espera, consulta el archivo /opt/apigee/apigee-postgresql/conf/pg_hba.conf en el nodo principal. Deberías ver las siguientes líneas en ese archivo:
```
host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
```
Instala el nuevo servidor de espera de Postgres:
1. Edita el archivo de configuración que usaste para instalar la versión actual de Edge para especificar lo siguiente:
```
# IP address of the current primary(master):
PG_MASTER=PG_MASTER_NODE_IP
# IP address of the new standby node
PG_STANDBY=PG_STANDBY_NODE_IP
```
2. Inhabilita SELinux como se describe en Instala la utilidad apigee-setup de Edge.
3. Descarga y ejecuta la secuencia de comandos de arranque según tu versión actual de Edge:
  - Si actualmente tienes la versión 4.53.00 de Edge, haz lo siguiente:
    
    Descarga el archivo bootstrap_4.53.00.sh de Edge en /tmp/bootstrap_4.53.00.sh:
```
curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
```
    Instala la utilidad apigee-service de Edge y las dependencias:
```
bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord
```
  - Si actualmente usas Edge 4.53.01, haz lo siguiente:
    
    Descarga el archivo bootstrap_4.53.01.sh de Edge en /tmp/bootstrap_4.53.01.sh:
```
curl https://software.apigee.com/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh
```
    Instala la utilidad apigee-service de Edge y las dependencias:
```
bash /tmp/bootstrap_4.53.01.sh apigeeuser=uName apigeepassword=pWord
```
4. Usa apigee-service para instalar la utilidad apigee-setup:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
```
5. Instala Postgres:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
```
6. En el nuevo nodo en espera, ejecuta el siguiente comando y verifica que sea el en espera:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
```

Realiza una actualización in situ de Postgres

Paso preliminar

Antes de realizar una actualización in situ a Postgres, sigue estos pasos en el host principal y en el de espera para actualizar la propiedad max_locks_per_transaction en apigee-postgresql:

Si no está presente, crea el archivo /opt/apigee/customer/application/postgresql.properties .

Cambia la propiedad de este archivo a apigee :

chown apigee:apigee /opt/apigee/customer/application/postgresql.properties

Agrega la siguiente propiedad al archivo:

conf/postgresql.conf+max_locks_per_transaction=30000

Configura apigee-postgresql :

apigee-service apigee-postgresql configure

Reinicia apigee-postgresql :

apigee-service apigee-postgresql restart

Realiza la actualización in situ.

Para realizar una actualización local a Postgres 18, sigue estos pasos:

Actualiza Postgres en el host principal

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

Ejecuta el comando de configuración en el host principal:
```
apigee-service apigee-postgresql setup -f configFile
```
Ejecuta el comando de configuración en el host principal:
```
apigee-service apigee-postgresql configure
```

Reinicia el host principal:

apigee-service apigee-postgresql restart

Configúrala como principal:

apigee-service apigee-postgresql setup-replication-on-master -f configFile

Asegúrate de que se haya iniciado el host principal:
```
apigee-service apigee-postgresql wait_for_ready
```
Detén la instancia en espera:
```
apigee-service apigee-postgresql stop
```
Actualiza la instancia en espera.

Nota: Si este paso genera un error o falla, puedes ignorarlo. update.sh intentará iniciar el servidor de reserva con una configuración incorrecta. Siempre que la instalación de Postgres se actualice a la versión 18, se puede ignorar el error.
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
Asegúrate de que la instancia en espera esté detenida:
```
apigee-service apigee-postgresql stop
```
Quita la configuración de espera anterior:
```
rm -rf /opt/apigee/data/apigee-postgresql/
```

Configura la replicación en el servidor en espera:

apigee-service apigee-postgresql setup-replication-on-standby -f configFile

Quita la línea conf/postgresql.conf+max_locks_per_transaction=30000 del archivo /opt/apigee/customer/application/postgresql.properties en el host principal y en el de reserva. Esta línea se agregó en el paso preliminar .

Después de completar este procedimiento, la instancia en espera se iniciará correctamente.

Retira un nodo de Postgres

Una vez que se complete la actualización, retira de servicio el nuevo nodo en espera:

Asegúrate de que Postgres se esté ejecutando:

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

Si Postgres no se está ejecutando, inícialo:

/opt/apigee/apigee-service/bin/apigee-all start

Ejecuta el siguiente comando curl en el nuevo nodo en espera para obtener su UUID:
```
curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self
```
Deberías ver el UUID del nodo al final del resultado, con el siguiente formato:
```
"type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
```
Detén el nodo en espera nuevo ejecutando el siguiente comando en él:
```
/opt/apigee/apigee-service/bin/apigee-all stop
```
En el nodo principal de Postgres, edita /opt/apigee/customer/application/postgresql.properties para quitar el nuevo nodo en espera de conf_pg_hba_replication.connection:
```
conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
```

Reinicia apigee-postgresql en la instancia principal de Postgres:

/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

Para verificar que se haya quitado el nodo en espera nuevo, consulta el archivo /opt/apigee/apigee-postgresql/conf/pg_hba.conf en el nodo principal. Deberías ver solo la siguiente línea en ese archivo:
```
host replication apigee existing_standby_ip/32 trust
```
Borra el UUID del nodo en espera de ZooKeeper realizando la siguiente llamada a la API de Management de Edge en el nodo del servidor de administración:
```
curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid
```

Pasos posteriores a la actualización de Postgres

Después de una actualización importante de Postgres, se borran las estadísticas internas de Postgres. Estas estadísticas ayudan al planificador de consultas de Postgres a usar los índices y las rutas más óptimos para ejecutar consultas.

Postgres puede volver a compilar sus estadísticas de forma gradual con el tiempo a medida que se ejecutan las consultas y cuando se ejecuta el daemon de autovacuum. Sin embargo, hasta que se vuelvan a compilar las estadísticas, es posible que tus consultas sean lentas.

Para solucionar este problema, ejecuta ANALYZE en todas las tablas de la base de datos en el nodo principal de Postgres. Como alternativa, puedes ejecutar ANALYZE para algunas tablas a la vez.

Actualiza a ZooKeeper 3.8.5

Esta versión de Edge para la nube privada incluye una actualización a ZooKeeper 3.8.5. Como parte de esa actualización, todos los datos de ZooKeeper se migrarán a ZooKeeper 3.8.5.

Antes de actualizar ZooKeeper, lee la guía de mantenimiento de ZooKeeper. La mayoría de los sistemas de producción de Edge usan un clúster de nodos de ZooKeeper distribuidos en varios centros de datos. Algunos de estos nodos se configuran como votantes que participan en la elección de líder de ZooKeeper, y el resto se configura como observadores. Consulta Acerca de los líderes, seguidores, votantes y observadores para obtener más detalles. Los nodos de votación eligen un líder, después de lo cual se convierten en seguidores.

Durante el proceso de actualización, podría haber un retraso momentáneo o una falla de escritura en ZooKeeper cuando se apaga el nodo líder. Esto podría afectar las operaciones de Management que escriben en ZooKeeper, como la operación de implementación de un proxy y los cambios en la infraestructura de Apigee, como la adición o eliminación de un Message Processor, etc. No debería haber ningún impacto en las APIs de entorno de ejecución de Apigee (a menos que estas APIs de entorno de ejecución llamen a las APIs de Management) durante la actualización de ZooKeeper mientras se sigue el procedimiento que se indica a continuación.

A un nivel general, el proceso de actualización implica crear una copia de seguridad de cada nodo. Luego, se actualizan todos los observadores y seguidores, y, por último, se actualiza el nodo líder.

Crea una copia de seguridad

Crea una copia de seguridad de todos los nodos de ZooKeeper para usarla en caso de que se requiera una reversión. Ten en cuenta que la reversión restablecerá ZooKeeper al estado en el que se encontraba cuando se realizó la copia de seguridad.

/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

Si usas máquinas virtuales y tienes la capacidad, también se podrían tomar instantáneas o copias de seguridad de las VMs para la restauración o la reversión (si es necesario).

Identifica al líder, a los seguidores y a los observadores

Si no está instalado en el nodo de ZooKeeper, instala nc:
```
yum install nc
```

Ejecuta el siguiente comando nc en el nodo, donde 2181 es el puerto de ZooKeeper:

echo stat | nc localhost 2181

Deberías ver un resultado como el siguiente:

Zookeeper version: 3.8.5-19f1842d4b6ee1f82cc8b05284959b26c6ae507d, built on 2025-09-03 21:35 UTC
Clients:
 /[0:0:0:0:0:0:0:1]:40696[0](queued=0,recved=1,sent=0)

Latency min/avg/max: 3/4.3333/6
Received: 4
Sent: 3
Connections: 1
Outstanding: 0
Zxid: 0x500000005
Mode: follower

En la línea Mode del resultado de los nodos, deberías ver observer, leader o follower (es decir, un votante que no es el líder) según la configuración del nodo.

Repite los pasos 1 y 2 en cada nodo de ZooKeeper.

Actualiza ZooKeeper en los nodos observadores y seguidores

Actualiza ZooKeeper en cada uno de los nodos observadores y seguidores de la siguiente manera:

Descarga y ejecuta el arranque de Edge para nube privada 4.54.00, como se describe en Actualiza a la versión 4.54.00 en un nodo con una conexión a Internet externa . Es probable que el proceso varíe según si el nodo tiene una conexión a Internet externa o si estás realizando una instalación sin conexión.
Actualiza el componente de ZooKeeper:
```
/opt/apigee/apigee-setup/bin/update.sh -c zk -f silent-config-file
```
Nota: Si estos nodos tienen otros componentes instalados (como Cassandra), también puedes actualizarlos ahora (como con el perfil zk,cs) o puedes actualizar los otros componentes más adelante. Apigee recomienda que primero actualices solo ZooKeeper y te asegures de que tu clúster funcione correctamente antes de actualizar otros componentes.
Repite los pasos anteriores en cada nodo observador y seguidor de ZooKeeper.

Apaga el líder

Una vez que se hayan actualizado todos los nodos observadores y seguidores, apaga el nodo líder. En el nodo identificado como líder, ejecuta el siguiente comando:

/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

Ten en cuenta que, durante este evento, antes de que se elija un líder nuevo, podría haber demoras momentáneas o fallas de escritura en ZooKeeper. Esto podría afectar las operaciones que escriben en ZooKeeper, como la acción de implementación de proxies o los cambios en la infraestructura de Apigee, como la adición o eliminación de procesadores de mensajes, etcétera.

Verifica que se haya elegido el nuevo líder

Sigue los pasos de la sección Identifica al líder, los seguidores y los observadores que se encuentra más arriba para verificar que se haya elegido un nuevo líder entre los seguidores una vez que se detenga el líder existente. Ten en cuenta que el líder podría haber sido elegido en un centro de datos diferente del líder actual.

Líder de actualización

Sigue los mismos pasos que se indican en Cómo actualizar ZooKeeper en los nodos observador y seguidor.

Una vez que también se actualice el nodo líder anterior, verifica el estado del clúster y asegúrate de que haya un nodo líder.

Actualiza a Cassandra 5.0.8

Apigee Edge para nube privada 4.54.00 incluye una actualización de Cassandra a la versión 5.0.8.

Actualizaciones y reversión

La actualización de Cassandra 4.0.X a Cassandra 5.0.X es un proceso progresivo.
No es posible revertir directamente en el lugar de Cassandra 5.0.X a 4.0.X. Revertir a una versión anterior con réplicas o copias de seguridad es un procedimiento complejo que puede implicar tiempo de inactividad o pérdida de datos. Es preferible solucionar problemas y actualizar a Cassandra 5.0.X que revertir.
Es importante que te familiarices con los procedimientos de reversión antes de intentar la actualización. Tener en cuenta los detalles de la reversión durante la actualización es fundamental para garantizar que haya rutas de reversión adecuadas disponibles.

Un solo centro de datos

La actualización de Cassandra de la versión 4.0.X a la 5.0.X dentro de un solo centro de datos es perfecta, pero la reversión es compleja y puede provocar tiempo de inactividad y pérdida de datos. Para las cargas de trabajo de producción, se recomienda agregar un centro de datos nuevo con al menos nodos de Cassandra disponibles en el centro de datos nuevo antes de iniciar la actualización. Esto permitirá revertir Cassandra sin incurrir en pérdida de datos ni interrupción del tráfico de la API. Este centro de datos adicional se puede dar de baja una vez que finalice la actualización.

Si no es posible agregar un centro de datos nuevo, pero aún se desea tener la capacidad de revertir, se necesitarán copias de seguridad para restablecer Cassandra 4.0.X. Sin embargo, es probable que este método implique tiempo de inactividad y pérdida de datos.

Varios centros de datos

Operar varios centros de datos con Edge para nube privada 4.53.00 (o) 4.53.01 ofrece más flexibilidad para las reversiones durante la actualización a Edge para nube privada 4.54.00.

Las reversiones requieren al menos un centro de datos que ejecute la versión anterior de Cassandra (4.0.X).

Metodología de actualización recomendada

Actualiza un centro de datos de Cassandra a la vez: Comienza por actualizar los nodos de Cassandra de forma individual dentro de un solo centro de datos. Completa las actualizaciones de todos los nodos de Cassandra en un centro de datos antes de continuar con el siguiente.
Pausa y valida: Después de actualizar un centro de datos, haz una pausa para asegurarte de que tu clúster de nube privada, en especial el centro de datos actualizado, funcione correctamente.
Recuerda: Solo puedes revertir a la versión anterior de Cassandra si tienes al menos un centro de datos que aún ejecuta la versión anterior.
Sensible al tiempo: Si bien puedes pausar durante un período breve (se recomiendan algunas horas) para validar la funcionalidad, no puedes permanecer en un estado de versión mixta de forma indefinida. Esto se debe a que un clúster de Cassandra no uniforme (con nodos en diferentes versiones) tiene limitaciones operativas.
Pruebas exhaustivas: Apigee recomienda realizar pruebas exhaustivas de rendimiento y funcionalidad antes de actualizar el siguiente centro de datos. Una vez que se actualicen todos los centros de datos, no será posible revertir a la versión anterior.

Proceso de punto de control de reversión

Punto de control de reversión único: Cuando todos los componentes se actualizan a la versión 4.54.00, la reversión de Cassandra solo es posible si al menos un centro de datos de Cassandra sigue ejecutando la versión anterior. Una vez que se actualice el centro de datos final de Cassandra, se completará la actualización a Edge para nube privada 4.54.00 y ya no será posible revertir la actualización.

Ejemplo

Considera un clúster de dos centros de datos (DC):

Estado inicial: Los nodos de Cassandra en ambos centros de datos están en la versión 4.0.X. Todos los demás nodos están en la versión 4.54.00 de Edge para nube privada. Supongamos que hay tres nodos de Cassandra por DC.
Upgrade DC-1: Actualiza los tres nodos de Cassandra en DC-1 uno por uno.
Pausa y valida: Haz una pausa para asegurarte de que el clúster, en particular DC-1, funcione correctamente (verifica el rendimiento y la funcionalidad). Puedes revertir al estado inicial con los nodos de Cassandra en DC-2. Recuerda que esta pausa debe ser temporal debido a las limitaciones de un clúster de Cassandra de versiones mixtas.
Actualiza DC-2: Actualiza los tres nodos de Cassandra restantes en DC-2. Una vez que todos los nodos de Cassandra en DC-2 se actualicen correctamente, se completará la actualización de Edge para nube privada 4.54.00.

Requisitos previos para la actualización de Cassandra

Debes ejecutar Cassandra 4.0.X con Edge para nube privada 4.53.00 (o) 4.53.01 y asegurarte de lo siguiente:

Establece Java 17 como la versión predeterminada de Java en el servidor: Cassandra 5.0.X quita la compatibilidad con Java 8. No puedes ejecutar Cassandra 5.0.X ni su utilidad nodetool con Java 8. Asegúrate de que Java 17 esté instalado en cada nodo de Cassandra y configúralo como la versión predeterminada de Java antes de ejecutar los pasos de actualización de Cassandra para que los comandos de nodetool se ejecuten con Java 17:
```
alternatives --set java JAVA_17_PATH/bin/java
```
Verifica que la versión predeterminada activa de Java sea Java 17:
```
java -version
```
Todo el clúster está operativo y es completamente funcional con Cassandra 4.0.X.
La estrategia de compactación se establece en LeveledCompactionStrategy (un requisito previo para la actualización a la versión 4.53.00 o 4.53.01).
Confirma que cada uno de los pasos que se indican a continuación se completó como parte de la actualización inicial de Cassandra 4.0.X en Edge para nube privada de 4.53.00 (o) 4.53.01.
- El comando post_upgrade se ejecutó en cada nodo de Cassandra durante la actualización anterior.
- El comando drop_old_tables se ejecutó en todo el clúster de Cassandra durante la actualización anterior.

Si no tienes la certeza de que los comandos post_upgrade y drop_old_tables se hayan ejecutado en Cassandra 4.0.X mientras usabas Edge para nube privada 4.53.00 (o) 4.53.01, puedes volver a ejecutarlos de forma segura antes de intentar la actualización a la versión 4.54.00.

Paso 1: Prepárate para la actualización

Los pasos que se indican a continuación se suman a los archivos estándar que sueles crear, como el archivo de configuración estándar de Apigee para habilitar las actualizaciones de componentes.

Crea una copia de seguridad de Cassandra con Apigee.
Toma instantáneas de VM de los nodos de Cassandra (si es posible).
Asegúrate de que se pueda acceder al puerto 9042 desde todos los componentes de Edge para la nube privada, incluidos el servidor de administración, el procesador de mensajes, el router, Qpid y Postgres, hasta los nodos de Cassandra si aún no se configuró. Consulta los requisitos de puertos para obtener más información.

Paso 2: Actualiza todos los nodos de Cassandra

Todos los nodos de Cassandra deben actualizarse uno por uno en cada centro de datos, un centro de datos a la vez. Entre las actualizaciones de los nodos dentro de un centro de datos, espera unos minutos para asegurarte de que un nodo actualizado se haya iniciado por completo y se haya unido al clúster antes de continuar con la actualización de otro nodo en el mismo centro de datos.

Después de actualizar todos los nodos de Cassandra en un centro de datos, espera un tiempo (entre 30 minutos y unas horas) antes de continuar con los nodos del siguiente centro de datos. Durante este tiempo, revisa minuciosamente el centro de datos que se actualizó y asegúrate de que las métricas de rendimiento y funcionamiento de tu clúster de Apigee estén intactas. Este paso es fundamental para garantizar la estabilidad del centro de datos en el que Cassandra se actualizó a la versión 5.0.X, mientras que el resto de los componentes de Apigee se actualizaron a la versión 4.54.00.

Para actualizar un nodo de Cassandra, ejecuta el siguiente comando:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
```
Una vez que se actualice un nodo, ejecuta el siguiente comando en él para realizar algunas validaciones antes de continuar:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
```

El resultado de lo anterior será similar a lo siguiente:

Cassandra version is verified - [cqlsh 6.2.0 | Cassandra 5.0.8 | CQL spec 3.4.7 | Native protocol v5]
Metadata is verified

Ejecuta el siguiente comando post_upgrade en el nodo de Cassandra:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade

Ejecuta el siguiente comando cleanup_old_index en el nodo de Cassandra:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra cleanup_old_index

Ejecuta los siguientes comandos de nodetool para volver a compilar los índices en el nodo de Cassandra:

/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms api_products api_products_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_api_products_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_end_user app_end_user_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_family_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_type_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms maps maps_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_company_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_developer_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_active_rev
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_index_template
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_method_template
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_latest_rev
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_active
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_latest
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rel_ver
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_res_path
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_res_path
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_entity
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template_auth au_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index dek keys usecase_index
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_operation_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_requesturi_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_responsecode_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_timestamp_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_user_idx    
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index cache cache_entries cache_entries_cache_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_consumer_key_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_consumer_key_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_request_token_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_client_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_refresh_token_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_client_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_organization_name_idx

Si usas la monetización, también ejecuta los siguientes comandos de reconstrucción de índices relacionados con los espacios de claves de monetización:

/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_created_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_updated_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_created_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_currency_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_dev_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_limit_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_prod_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_reason_code_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_sub_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_company_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_created_at_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_developer_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_lastmodified_at_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_env_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_job_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_class_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_group_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus org_triggers org_triggers_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_group_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_suite_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_to_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_org_id_idx

Actualiza con mTLS de Apigee

Para actualizar Apigee mTLS , sigue estos pasos:

Revierte una actualización

En caso de que falle una actualización, puedes intentar corregir el problema y, luego, volver a ejecutar update.sh. Puedes ejecutar la actualización varias veces y esta continuará desde donde se detuvo por última vez.

Si el error requiere que reviertas la actualización a la versión anterior, consulta Cómo revertir a la versión 4.54.00 para obtener instrucciones detalladas.

Información de actualización de Logging

De forma predeterminada, la utilidad update.sh escribe la información de registro en las siguientes ubicaciones:

/opt/apigee/var/log/apigee-setup/update.log

Si la persona que ejecuta la utilidad update.sh no tiene acceso a ese directorio, escribe el registro en el directorio /tmp como un archivo llamado update_username.log.

Si la persona no tiene acceso a /tmp, la utilidad update.sh falla.

Actualización sin tiempo de inactividad

Una actualización sin tiempo de inactividad, o actualización progresiva, te permite actualizar tu instalación de Edge sin interrumpir su funcionamiento.

La actualización sin tiempo de inactividad solo es posible con una configuración de 5 nodos o más.

La clave para la actualización sin tiempo de inactividad es quitar cada router, uno por uno, del balanceador de cargas. Luego, actualiza el router y cualquier otro componente en la misma máquina que el router y, luego, vuelve a agregar el router al balanceador de cargas.

Actualiza las máquinas en el orden correcto para tu instalación, como se describe en Orden de actualización de la máquina .
Cuando sea el momento de actualizar los routers, selecciona cualquiera de ellos y haz que no se pueda acceder a él, como se describe en Cómo habilitar o inhabilitar la accesibilidad del servidor (procesador de mensajes o router) .
Actualiza el router seleccionado y todos los demás componentes de Edge en la misma máquina que el router. Todas las configuraciones de Edge muestran un router y un Message Processor en el mismo nodo.
Haz que el router vuelva a estar disponible.
Repite los pasos 2 a 4 para los routers restantes.
Continúa con la actualización de las máquinas restantes de tu instalación.

Ten en cuenta lo siguiente antes y después de la actualización:

En el nodo combinado de router y Message Processor:
- Antes de la actualización, haz lo siguiente:
  1. Haz que el router no sea accesible.
  2. Haz que el Message Processor no esté disponible.
- Después de la actualización, haz lo siguiente:
  1. Haz que el procesador de mensajes sea accesible.
  2. Haz que se pueda acceder al router.
En nodos de router único:
- Antes de la actualización, haz que el router no sea accesible.
- Después de la actualización, haz que el router sea accesible.
En nodos de Message Processor únicos, haz lo siguiente:
- Antes de la actualización, haz que el Message Processor sea inaccesible.
- Después de la actualización, haz que el Message Processor sea accesible.

Usa un archivo de configuración silencioso

Debes pasar un archivo de configuración silencioso al comando de actualización. Si bien el archivo de configuración silenciosa es muy similar al que usaste para instalar Edge para nube privada 4.53.00 o 4.53.01, es posible que debas realizar cambios en componentes como la IU y el SSO, como se describe en Actualiza a la nueva IU de Edge y al SSO de Apigee (si está instalado).

Actualiza a la versión 4.54.00 en un nodo con una conexión a Internet externa

Sigue este procedimiento para actualizar los componentes de Edge en un nodo:

Si hay trabajos de cron configurados para realizar una operación de reparación en Cassandra, inhabilítalos hasta que se complete la actualización.
Accede a tu nodo como raíz para instalar los RPM de Edge.

Nota: Si bien la instalación de RPM requiere acceso raíz, puedes realizar la configuración de Edge sin acceso raíz.
Inhabilita SELinux como se describe en Instala la utilidad apigee-setup de Edge .

Si realizas la instalación en AWS , ejecuta los siguientes comandos de yum-configure-manager:

yum update rh-amazon-rhui-client.noarch
yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

Si actualmente usas Edge para la nube privada 4.53.00 o 4.53.01, haz lo siguiente:
1. Descarga el archivo bootstrap_4.54.00.sh de Edge en /tmp/bootstrap_4.54.00.sh :
```
curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
```
2. Instala la utilidad apigee-service de Edge 4.54.00 y las dependencias ejecutando el siguiente comando:
```
bash /tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord
```
  Donde uName:pWord son el nombre de usuario y la contraseña que recibiste de Apigee. Si omites pWord, se te pedirá que lo ingreses.
  
  De forma predeterminada, el instalador verifica que tengas instaladas las versiones 17 y 21 de Java.
3. Usa apigee-service para actualizar la utilidad apigee-setup, como se muestra en el siguiente ejemplo:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
```
4. Actualiza la utilidad apigee-validate en el servidor de administración, como se muestra en el siguiente ejemplo:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
5. Actualiza la utilidad apigee-provision en el servidor de administración, como se muestra en el siguiente ejemplo:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
6. Ejecuta la utilidad update en tus nodos con el siguiente comando:
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
  Hazlo en el orden que se describe en Orden de actualización de la máquina.
  
  Donde:
  - component es el componente de Edge que se actualizará. Estos son algunos de los valores posibles:
    - edge : Todos los componentes de Edge, excepto la IU de New Edge: Management Server, Message Processor, Router, QPID Server y Postgres Server
    - ldap : OpenLDAP
    - ue : Nueva IU de Edge
    - qpid : Apigee Qpid
    - ps : Apigee Postgresql
    - zk : ZooKeeper
    - cs : Cassandra
  - configFile es el mismo archivo de configuración que usaste para definir tus componentes de Edge durante la instalación de la versión 4.53.00 o 4.53.01.
  Nota: El usuario "apigee" debe poder leer el archivo de configuración. Para cambiar el propietario, usa el siguiente comando:
```
chown apigee:apigee configFile
```
  Puedes ejecutar update.sh en todos los componentes si configuras component como "all", pero solo si tienes un perfil de instalación todo en uno (AIO) de Edge. Por ejemplo:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
```
7. Reinicia los componentes de la IU de Edge nueva en todos los nodos que los ejecutan, si aún no lo hiciste:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
8. Para probar la actualización, ejecuta la utilidad apigee-validate en el servidor de administración, como se describe en Prueba la instalación.

Si luego decides revertir la actualización, usa el procedimiento que se describe en Cómo revertir la versión 4.54.00

Actualiza a la versión 4.54.00 desde un repo local

Si tus nodos de Edge están detrás de un firewall o, de alguna otra manera, tienen prohibido acceder al repositorio de Apigee a través de Internet, puedes realizar la actualización desde un repositorio local o una duplicación del repositorio de Apigee.

Después de crear un repositorio de Edge local, tienes dos opciones para actualizar Edge desde el repositorio local:

Crea un archivo .tar del repositorio, cópialo en un nodo y, luego, actualiza Edge desde el archivo .tar.
Instala un servidor web en el nodo con el repo local para que otros nodos puedan acceder a él. Apigee proporciona el servidor web Nginx para que lo uses, o puedes usar tu propio servidor web.

Para actualizar desde un repo local 4.54.00, haz lo siguiente:

Crea un repositorio local 4.54.00 como se describe en "Crea un repositorio local de Apigee" en Instala la utilidad apigee-setup de Edge.

Nota: Si ya tienes un repositorio, puedes agregarle el repositorio 4.54.00 como se describe en "Actualiza un repositorio local de Apigee" en Instala la utilidad apigee-setup de Edge.
Instala apigee-service en los nodos de destino con uno de los siguientes métodos:
- Opción 1: Instala apigee-service desde un archivo .tar
  1. En el nodo con el repositorio local, usa el siguiente comando para empaquetar el repositorio local en un solo archivo .tar llamado /opt/apigee/data/apigee-mirror/apigee-4.54.00.tar.gz:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
```
  2. Copia el archivo .tar en el nodo en el que deseas actualizar Edge. Por ejemplo, cópiala en el directorio /tmp del nodo nuevo.
  3. En el nodo nuevo, descomprime el archivo en el directorio /tmp:
```
tar -xzf apigee-4.54.00.tar.gz
```
    Este comando crea un directorio nuevo, llamado repos, en el directorio que contiene el archivo .tar. Por ejemplo: /tmp/repos.
  4. Instala la utilidad apigee-service de Edge y las dependencias de /tmp/repos:
```
bash /tmp/repos/bootstrap_4.54.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
    Ten en cuenta que debes incluir la ruta de acceso al directorio de repositorios en este comando.
- Opción 2: Instala apigee-service con el servidor web Nginx
  1. Configura el servidor web Nginx como se describe en "Instala desde el repo con el servidor web Nginx" en Instala la utilidad apigee-setup de Edge.
  2. En el nodo remoto, descarga el archivo bootstrap_4.54.00.sh de Edge en /tmp/bootstrap_4.54.00.sh:
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
```
    Donde uName:pWord son el nombre de usuario y la contraseña que estableciste anteriormente para el repo, y remoteRepo es la dirección IP o el nombre de DNS del nodo del repo.
  3. En el nodo remoto, instala la utilidad apigee-service de Edge y las dependencias:
```
bash /tmp/bootstrap_4.54.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
```
    donde uName:pWord son el nombre de usuario y la contraseña del repo.
Usa apigee-service para actualizar la utilidad apigee-setup, como se muestra en el siguiente ejemplo:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
```
Actualiza la utilidad apigee-validate en el servidor de administración, como se muestra en el siguiente ejemplo:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
Actualiza la utilidad apigee-provision en el servidor de administración, como se muestra en el siguiente ejemplo:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
Ejecuta la utilidad update en tus nodos en el orden que se describe en Orden de actualización de la máquina:
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
Donde:
- component es el componente de Edge que se actualizará. Estos son algunos de los valores posibles:
  - edge : Todos los componentes de Edge, excepto la IU de New Edge: Management Server, Message Processor, Router, QPID Server y Postgres Server
  - ldap : OpenLDAP
  - ue : Nueva IU de Edge
  - qpid : Apigee Qpid
  - ps : Apigee Postgresql
  - zk : ZooKeeper
  - cs : Cassandra
- configFile es el mismo archivo de configuración que usaste para definir tus componentes de Edge durante la instalación de la versión 4.53.00 (o) 4.53.01.
  
  Nota: El usuario "apigee" debe poder leer el archivo de configuración. Para cambiar el propietario, usa el siguiente comando:
```
chown apigee:apigee configFile
```
Puedes ejecutar update.sh en todos los componentes si configuras component como "all", pero solo si tienes un perfil de instalación todo en uno (AIO) de Edge. Por ejemplo:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
```
Reinicia los componentes de la IU en todos los nodos que la ejecutan, si aún no lo hiciste:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
Para probar la actualización, ejecuta la utilidad apigee-validate en el servidor de administración, como se describe en Prueba la instalación.

Si más adelante decides revertir la actualización, usa el procedimiento que se describe en Cómo revertir la versión 4.54.00.

Orden de actualización de la máquina

El orden en el que actualizas las máquinas en una instalación de Edge es importante. Actualiza tus componentes en la siguiente secuencia.

Actualiza todos los nodos de Router y Message Processor en todos los centros de datos con la opción -c edge.
Actualiza todos los nodos del servidor de administración en todos los centros de datos con la opción -c edge.
Actualiza todos los nodos LDAP en todos los centros de datos. Si actualizas desde Edge para nube privada 4.53.00, deberás seguir pasos especiales para la actualización de LDAP.
Actualiza la IU y el SSO de Apigee (si está instalado) en todos los centros de datos:
1. Si no está instalado apigee-sso: Sigue la Opción 1: Actualiza la IU (sin Apigee SSO) para actualizar a la nueva IU de Edge.
2. Si apigee-sso está instalado: Sigue la Opción 2: Actualiza la IU (con SSO de Apigee) para actualizar a la nueva IU de Edge y al SSO de Apigee.
Actualiza todos los componentes de Qpid y edge-qpid-server en todos los centros de datos siguiendo los pasos especiales de Qpid.
Actualiza todos los componentes de Postgresql y edge-postgres-server en todos los centros de datos siguiendo los pasos especiales de Postgres.
Actualiza todos los componentes de ZooKeeper en todos los centros de datos siguiendo los pasos especiales de actualización de ZooKeeper.
Actualiza todos los componentes de Cassandra en todos los centros de datos siguiendo los pasos especiales de actualización de Cassandra.
No hay un paso independiente para actualizar la monetización. Se actualiza cuando especificas la opción -c edge.

Actualización independiente de 1 nodo

Para actualizar una configuración independiente de 1 nodo a la versión 4.54.00, haz lo siguiente:

Cuando actualices desde Edge para nube privada 4.53.00, primero debes actualizar LDAP siguiendo los pasos para actualizar de la versión 4.53.00 a la 4.54.00 antes de comenzar la actualización de todos los componentes.

Actualiza todos los componentes:

/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile

(Si instalaste apigee-adminapi) Actualiza la utilidad apigee-adminapi:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```

Actualización independiente de 2 nodos

Actualiza los siguientes componentes para una instalación independiente de 2 nodos:

Consulta Topologías de instalación para obtener la lista de topologías de Edge y números de nodos.

Actualiza los componentes de Edge en la máquina 1:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Actualiza LDAP en la máquina 1:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Actualiza la IU de Edge nueva en la máquina 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
```
Nota: Si apigee-sso está instalado, consulta Opción 2: Actualiza la IU (con SSO de Apigee) para obtener instrucciones sobre cómo configurarlo para el SSO de Apigee.

Actualiza los componentes de Edge en la máquina 2:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Actualiza Qpid en la máquina 2:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Actualiza Postgres en la máquina 2:

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

Actualiza Cassandra y ZooKeeper en la máquina 1:

/opt/apigee/apigee-setup/bin/update.sh -c zk,cs -f configFile

(Si instalaste apigee-adminapi) Actualiza la utilidad apigee-adminapi en la máquina 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```

Actualización de 5 nodos

Actualiza los siguientes componentes para una instalación de 5 nodos:

Consulta Topologías de instalación para obtener la lista de topologías de Edge y números de nodos.

Actualiza los componentes de Edge en las máquinas 2, 3 y 1:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Actualiza LDAP en la máquina 1:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Actualiza la IU de Edge nueva en la máquina 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
```
Nota: Si apigee-sso está instalado, consulta Opción 2: Actualiza la IU (con SSO de Apigee) para obtener instrucciones sobre cómo configurarlo para el SSO de Apigee.

Actualiza los componentes de Edge en las máquinas 4 y 5:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Actualiza Qpid en las máquinas 4 y 5:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Actualiza Postgres en las máquinas 4 y 5:

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

Actualiza Cassandra y ZooKeeper en las máquinas 1, 2 y 3:

/opt/apigee/apigee-setup/bin/update.sh -c zk,cs -f configFile

(Si instalaste apigee-adminapi) Actualiza la utilidad apigee-adminapi en la máquina 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```

Actualización de clústeres de 9 nodos

Actualiza los siguientes componentes para una instalación agrupada en clústeres de 9 nodos:

Consulta Topologías de instalación para obtener la lista de topologías de Edge y números de nodos.

Actualiza los componentes de Edge en las máquinas 4, 5 y 1 (router, message-processor y management-server) en ese orden:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Actualiza LDAP en la máquina 1:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Actualiza la nueva IU de Edge en la máquina 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
```
Nota: Si apigee-sso está instalado, consulta la Opción 2: Actualiza la IU (con el SSO de Apigee) para obtener instrucciones sobre cómo configurarlo en el SSO de Apigee.
Actualiza los componentes de Edge en las máquinas 6, 7, 8 y 9 en ese orden:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Actualiza Qpid en las máquinas 6 y 7:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Actualiza Postgres en la máquina 8:

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

Actualiza Postgres en la máquina 9:

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

Actualiza Cassandra y ZooKeeper en las máquinas 1, 2 y 3:

/opt/apigee/apigee-setup/bin/update.sh -c zk,cs -f configFile

(Si instalaste apigee-adminapi) Actualiza la utilidad apigee-adminapi en la máquina 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```

Actualización de clústeres de 13 nodos

Actualiza los siguientes componentes para una instalación en clúster de 13 nodos:

Consulta Topologías de instalación para obtener la lista de topologías de Edge y números de nodos.

Actualiza los componentes de Edge en las máquinas 10, 11, 6 y 7 en ese orden:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Actualiza LDAP en las máquinas 4 y 5:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Actualiza la IU de Edge nueva en las máquinas 6 y 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
```
Nota: Si apigee-sso está instalado, consulta la Opción 2: Actualiza la IU (con el SSO de Apigee) para obtener instrucciones sobre cómo configurarlo en el SSO de Apigee.
Actualiza los componentes de Edge en las máquinas 12, 13, 8 y 9 en ese orden:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Actualiza Qpid en las máquinas 12 y 13:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Actualiza Postgres en la máquina 8:

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

Actualiza Postgres en la máquina 9:

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

Actualiza Cassandra y ZooKeeper en las máquinas 1, 2 y 3:

/opt/apigee/apigee-setup/bin/update.sh -c zk,cs -f configFile

(Si instalaste apigee-adminapi) Actualiza la utilidad apigee-adminapi en las máquinas 6 y 7:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```

Actualización de clústeres de 12 nodos

Actualiza los siguientes componentes para una instalación agrupada en clústeres de 12 nodos:

Consulta Topologías de instalación para obtener la lista de topologías de Edge y números de nodos.

Actualiza los componentes de Edge (Router y Message Processor):
- En las máquinas 2 y 3 del centro de datos 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
- En las máquinas 8 y 9 del centro de datos 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
Actualiza los componentes de Edge (servidor de administración):
- En la máquina 1 del centro de datos 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
- En la máquina 7 del centro de datos 2, haz lo siguiente:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Actualiza LDAP:

Máquina 1 en el centro de datos 1:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Máquina 7 en el centro de datos 2:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Actualiza los componentes de la nueva IU de Edge:
- En la máquina 1 del centro de datos 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
```
  Nota: Si apigee-sso está instalado, consulta Opción 2: Actualiza la IU (con SSO de Apigee) para obtener instrucciones sobre cómo configurarlo para el SSO de Apigee.
- En la máquina 7 del centro de datos 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
```
  Nota: Si apigee-sso está instalado, consulta Opción 2: Actualiza la IU (con SSO de Apigee) para obtener instrucciones sobre cómo configurarlo para el SSO de Apigee.

Actualiza los componentes de Edge:

Máquinas 4, 5 y 6 del centro de datos 1:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Máquinas 10, 11 y 12 en el centro de datos 2:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Actualiza qpidd:

Máquinas 4 y 5 en el centro de datos 1:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Máquinas 10 y 11 en el centro de datos 2:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Actualiza Postgres:

Máquina 6 en el centro de datos 1:

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

Máquina 12 en el centro de datos 2:

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

Actualiza Cassandra y ZooKeeper:
- Máquinas 1, 2 y 3 en el centro de datos 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c zk,cs -f configFile
```
- En las máquinas 7, 8 y 9 del centro de datos 2, haz lo siguiente:
```
/opt/apigee/apigee-setup/bin/update.sh -c zk,cs -f configFile
```
(Si instalaste apigee-adminapi) Actualiza la utilidad apigee-adminapi:
- Máquina 1 en el centro de datos 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
- Máquina 7 en el centro de datos 2:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```

Para una configuración no estándar

Si tienes una configuración no estándar, actualiza los componentes de Edge en el siguiente orden:

Router
Message Processor
Servidor de administración
LDAP
IU (IU clásica o IU nueva)
SSO (si corresponde)
Qpid y edge-qpid-server
Postgres y edge-postgres-server
ZooKeeper
Cassandra
apigee-adminapi

Actualiza Apigee Edge 4.53.00 o 4.53.01 a 4.54.00

Quién puede realizar la actualización

¿Qué componentes debes actualizar?

Materiales de lectura previa

Requisitos previos de la actualización

Propagación automática de la configuración de la propiedad

Actualiza el router y el Message Processor

Actualiza el servidor de administración

Actualiza a OpenLDAP 2.6.10

Preparación e instalación (todos los servidores LDAP)

Pasos para actualizar LDAP de la versión 4.53.00 a la 4.54.00

Requisitos previos y consideraciones

Pasos para actualizar LDAP de la versión 4.53.01 a la 4.54.00

Actualiza a la nueva IU de Edge y al SSO de Apigee (si está instalado)

Opción 1: Actualiza la IU (sin el SSO de Apigee)

Paso 1: Crea una copia de seguridad de los archivos de configuración

Paso 2: Actualiza el archivo de configuración silenciosa para la autenticación básica

Paso 3: Actualiza el componente de la IU

Paso 4: Verifica la actualización de la IU de Edge nueva

Opción 2: IU de actualización (con SSO de Apigee)

Paso 1: Haz una copia de seguridad de los archivos de configuración

Paso 2: Quita las variables de IU o SSO obsoletas y actualiza el archivo de configuración silenciosa (configFile)

Paso 3: Actualiza el componente de la IU de Edge nueva

Paso 4: Detén el apigee-sso

Paso 5: Crea la base de datos apigee_dex para el SSO de Apigee en el nodo de Postgres

Paso 6: Configura el SSO de Apigee en los nodos de OpenLDAP

Paso 7: Configura la IU de administración para el SSO de Apigee y reinicia la IU

Paso 8: Verifica la actualización de la IU de Edge nueva y el SSO de Apigee

Paso 9: Desinstala la versión heredada de apigee-sso

Actualiza a Qpid 10.0.1

Actualiza a Postgres 18.6

Instala un nuevo nodo en espera de Postgres

Realiza una actualización in situ de Postgres

Paso preliminar

Realiza la actualización in situ.

Retira un nodo de Postgres

Pasos posteriores a la actualización de Postgres

Actualiza a ZooKeeper 3.8.5

Crea una copia de seguridad

Identifica al líder, a los seguidores y a los observadores

Actualiza ZooKeeper en los nodos observadores y seguidores

Apaga el líder

Verifica que se haya elegido el nuevo líder

Líder de actualización

Actualiza a Cassandra 5.0.8

Actualizaciones y reversión

Un solo centro de datos

Varios centros de datos

Metodología de actualización recomendada

Proceso de punto de control de reversión

Ejemplo

Requisitos previos para la actualización de Cassandra

Paso 1: Prepárate para la actualización

Paso 2: Actualiza todos los nodos de Cassandra

Actualiza con mTLS de Apigee

Revierte una actualización

Información de actualización de Logging

Actualización sin tiempo de inactividad

Usa un archivo de configuración silencioso

Actualiza a la versión 4.54.00 en un nodo con una conexión a Internet externa

Actualiza a la versión 4.54.00 desde un repo local

Orden de actualización de la máquina

Actualización independiente de 1 nodo

Actualización independiente de 2 nodos

Actualización de 5 nodos

Actualización de clústeres de 9 nodos

Actualización de clústeres de 13 nodos

Actualización de clústeres de 12 nodos

Para una configuración no estándar

Paso 2: Quita las variables de IU o SSO obsoletas y actualiza el archivo de configuración silenciosa (`configFile`)

Paso 4: Detén el `apigee-sso`

Paso 5: Crea la base de datos `apigee_dex` para el SSO de Apigee en el nodo de Postgres

Paso 9: Desinstala la versión heredada de `apigee-sso`