Actualiza Apigee Edge 4.52.02 o 4.53.00 a la versión 4.53.01

Apigee admite la actualización de Edge para la nube privada directamente desde la versión 4.52.02 o 4.53.00 a la versión 4.53.01. 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 actualizaciones para las versiones de Edge para la 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.

Actualiza los requisitos previos

En esta versión, se abordaron varios problemas de seguridad. Si bien estas mejoras de seguridad son fundamentales, introducen algunos cambios que no son compatibles con versiones anteriores. Esto significa que la actualización requerirá pasos adicionales para garantizar que no haya interrupciones durante la actualización ni después de ella. Para obtener más información, revisa este tema detenidamente cuando actualices a la versión 4.53.01 desde versiones anteriores de la nube privada.

Antes de actualizar Apigee Edge, asegúrate de cumplir con los siguientes requisitos previos:

• 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 copia de seguridad 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.

• Asegúrate de que Edge se esté ejecutando
  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

• Verifica los requisitos previos de Cassandra
  

  Si antes actualizaste desde una versión anterior de Edge para Private Cloud a la versión 4.52.02 y ahora planeas actualizar a la versión 4.53.01, asegúrate de haber completado los pasos posteriores a la actualización necesarios para Cassandra. Estos pasos se describen en la documentación de actualización de la versión 4.52.02 y también se mencionan en Requisitos previos para la actualización de Cassandra. Si no sabes con certeza si se completaron estos pasos durante la actualización anterior, vuelve a completarlos antes de continuar con la actualización a la versión 4.53.01.

• Configuración de claves y certificados del IDP en Edge para Private Cloud 4.53.01
  

  En Edge para Private Cloud 4.53.01, las claves y los certificados del IDP que se usan en el componente apigee-sso ahora se configuran a través de un almacén de claves. Deberás exportar la clave y el certificado que usaste anteriormente a un almacén de claves. Sigue los pasos que se indican en la sección Pasos para actualizar Apigee SSO desde versiones anteriores para obtener instrucciones detalladas antes de actualizar el componente de SSO.

• Requisitos de Python
  Antes de intentar la actualización, asegúrate de que todos los nodos, incluidos los de Cassandra, tengan instalado Python 3.

Qué pasos especiales se deben tener en cuenta para la actualización

Para actualizar a Edge para nubes privadas 4.53.01, considera ejecutar pasos específicos para actualizar cierto software. Los pasos necesarios dependen de tu versión actual. Consulta la siguiente tabla para ver los diferentes softwares que requieren pasos complementarios y sigue las instrucciones detalladas para cada uno. Después de completar las tareas necesarias, regresa al procedimiento de actualización principal para continuar con el proceso.

Después de realizar los pasos necesarios según tu versión, regresa al procedimiento principal de actualización para continuar.

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

Si configuraste alguna propiedad editando archivos .properties en /opt/apigee/customer/application, la actualización conservará esos valores.

Se requiere la actualización a OpenLDAP 2.6

A continuación, se describe el procedimiento paso a paso para actualizar el servicio LDAP subyacente de Apigee Edge para la nube privada de la versión heredada OpenLDAP 2.4 a OpenLDAP 2.6. Esta actualización es un requisito obligatorio para actualizar a la versión 4.53.01 y posteriores de Apigee Edge para la nube privada. Esta actualización se aplica a todas las topologías de implementación de LDAP de Apigee: de un solo servidor, activa-pasiva y activa-activa (multimaestro).

Requisitos previos y consideraciones

• Ten en cuenta que, durante el proceso de actualización de LDAP, las APIs de administración y, por lo tanto, la IU de Apigee no estarán disponibles en ninguna región. Todas las tareas administrativas, como la administración de usuarios, roles, organizaciones y apps, fallarán y se deben pausar. El procesamiento del tráfico de tu proxy de API no se verá afectado. Asegúrate de apagar todos los servidores de administración perimetral y la IU perimetral antes de continuar con la actualización de LDAP.

• La copia de seguridad es fundamental: Una copia de seguridad completa y validada de tus datos de LDAP existentes es indispensable. Si continúas sin una copia de seguridad válida, se producirá una pérdida de datos irreversible. La copia de seguridad se debe iniciar mientras el servicio de LDAP aún se esté ejecutando para capturar una instantánea coherente de los datos de LDAP en un momento determinado. Se requiere una copia de seguridad para realizar la actualización. Sin una copia de seguridad, no podrás ejecutar la actualización ni revertirla, ya que los pasos de actualización implican borrar los datos de LDAP.

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

Los pasos de esta sección (del paso 2 al 5) son idénticos para todas las topologías de implementación de LDAP. Estas acciones se deben realizar en todos los servidores en los que esté instalado el componente apigee-openldap, independientemente de su rol.

1. Asegúrate de apagar todos los edge-management-server y edge-ui antes de continuar con la actualización de LDAP.

   apigee-service edge-management-server stop
   apigee-service edge-ui stop

2. Crea una copia de seguridad de los datos de LDAP existentes

   Antes de realizar cualquier cambio, haz una copia de seguridad completa de los datos LDAP actuales de todos los servidores LDAP. Esto crea un punto de restauración seguro.

   • Ejecuta el comando de copia de seguridad. Esta acción crea un archivo de copia de seguridad con marca de tiempo dentro del directorio /opt/apigee/backup/openldap.

     apigee-service apigee-openldap backup

   • Obtén el recuento total de registros: Captura la cantidad de registros en tu directorio para la validación posterior a la actualización (el recuento de registros debe coincidir en todos los servidores LDAP). Esta es una verificación de estado.

     # 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

3. Detén LDAP y limpia los directorios de datos

   Este paso debe realizarse en todos los servidores LDAP. Es obligatorio debido al cambio de versión principal y a las diferencias estructurales subyacentes. Un directorio limpio garantiza que no haya conflictos. Cuando se detengan todos los servidores LDAP, comenzará la interrupción de las APIs y la IU de administración.

   • 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/*

4. 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 /opt/silent.conf

   • Valida la nueva versión de LDAP: Después de que se complete la instalación, vuelve a cargar el perfil y verifica que la nueva versión de LDAP se haya instalado correctamente.

     source ~/.bash_profile
     ldapsearch -VV
     Expected output:
     ldapsearch: @(#) $OpenLDAP: ldapsearch 2.6.7

5. Detén LDAP en todos los servidores antes de restablecer los datos

   Este es un paso de sincronización fundamental. Antes de restablecer la copia de seguridad, debes asegurarte 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/*

6. Cómo restablecer datos de LDAP

   La estrategia consiste en restablecer la copia de seguridad en el primer servidor activo. Luego, este servidor actuará como 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
        Note:
        -If this command returns output, the server is a passive server.
        -If it returns no output, the server is the active server.

   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 restore. Te recomendamos que especifiques la marca de tiempo exacta de la copia de seguridad del paso 2 para evitar restablecer una versión no deseada o anterior.

        # 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

7. Inicia los servidores LDAP restantes

   Si tienes una configuración de varios servidores, en cada uno de los servidores LDAP, inicia el servicio:

   apigee-service apigee-openldap start

8. Validación final

   El paso final 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

   • Una vez que confirmes que los datos son correctos y coherentes, se completará la actualización de LDAP. Ahora puedes iniciar edge-management-server y edge-ui, y cualquier otro componente dependiente según el procedimiento de actualización estándar de tu organización.

Se requiere la actualización a Cassandra 4.0.18

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

Actualizaciones y reversión

• La actualización de Cassandra 3.11.X a Cassandra 4.0.X es un proceso sin problemas. Cassandra 4.0.X, que se lanzó con Edge para Private Cloud 4.53.00, es compatible con los componentes de administración y de tiempo de ejecución de Private Cloud 4.52.02.
• No es posible revertir directamente en el lugar de Cassandra 4.0.X a 3.11.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 los problemas y actualizar a Cassandra 4.0.X que revertir la versión.
• Es importante que te familiarices con los procedimientos de reversión antes de intentar la actualización. Tener en cuenta los matices 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 3.11.X a la 4.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 nuevo centro de datos con al menos nodos de Cassandra disponibles en el nuevo centro de datos antes de iniciar la actualización. Esto permitirá revertir Cassandra sin incurrir en pérdida de datos ni interrupciones en el tráfico de la API. Este centro de datos adicional se puede dar de baja una vez que finalice la actualización o se alcance el punto de control 2.

Si no es factible agregar un centro de datos nuevo, pero aún se desea la capacidad de reversión, se necesitarán copias de seguridad para restablecer Cassandra 3.11.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 la nube privada 4.52.02 ofrece más flexibilidad para las reversiones durante la actualización a Edge para la nube privada 4.53.00.

• Las reversiones dependen de tener al menos un centro de datos que ejecute la versión anterior de Cassandra (3.11.X).
• Si todo tu clúster de Cassandra se actualizó a la versión 4.0.X, no debes revertir a la versión 3.11.X de Cassandra. Debes seguir usando la versión más reciente de Cassandra con los demás componentes de Private Cloud 4.53.00 o 4.52.02.

Metodología de actualización recomendada

1. 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.
2. Pausa y valida: Después de actualizar un centro de datos, haz una pausa para asegurarte de que tu clúster de Private Cloud, en especial el centro de datos actualizado, funcione correctamente.
3. 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.
4. Urgente: Si bien puedes pausar la actualización por 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.
5. Pruebas exhaustivas: Apigee recomienda realizar pruebas integrales de rendimiento y funcionalidad antes de actualizar el siguiente centro de datos. Una vez que se actualicen todos los centros de datos, no se podrá revertir a la versión anterior.

Reversión como proceso de dos puntos de control

1. Checkpoint 1: El estado inicial, con todos los componentes en la versión 4.52.02. Es posible realizar una reversión completa siempre que al menos un centro de datos de Cassandra permanezca en la versión anterior.
2. Punto de control 2: Después de que se actualicen todos los nodos de Cassandra en todos los centros de datos Puedes revertir el estado a este punto, pero no puedes volver al punto de control 1.

Ejemplo

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

1. Estado inicial: Los nodos de Cassandra en ambos centros de datos están en la versión 3.11.X. Todos los demás nodos están en la versión 4.52.02 de Edge para la nube privada. Supón que hay tres nodos de Cassandra por DC.
2. Actualiza DC-1: Actualiza los tres nodos de Cassandra en DC-1 uno por uno.
3. 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.
4. Actualiza DC-2: Actualiza los tres nodos restantes de Cassandra en DC-2. Este se convertirá en tu nuevo punto de control de reversión.
5. Actualiza otros componentes: Actualiza los nodos de administración, tiempo de ejecución y análisis como de costumbre en todos los centros de datos, un nodo y un centro de datos a la vez. Si surgen problemas, puedes revertir al estado del paso 4.

Requisitos previos para la actualización de Cassandra

1. Todo el clúster está operativo y funciona perfectamente con Cassandra 3.11.16.
2. La estrategia de compactación se establece en LeveledCompactionStrategy (un requisito previo para la actualización a la versión 4.52.02).

3. Confirma que cada uno de los siguientes pasos se completó como parte de la actualización inicial de Cassandra 3.11 en Edge para Private Cloud 4.52.02.

   • 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 ejecutaron en Cassandra 3.11 mientras usabas Edge para Private Cloud 4.52.02, puedes volver a ejecutarlos de forma segura antes de intentar la actualización a la versión 4.53.01.

Paso 1: Prepárate para la actualización

Los siguientes pasos 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.

1. Crea una copia de seguridad de Cassandra con Apigee.
2. Toma instantáneas de VM de los nodos de Cassandra (si es posible).
3. Asegúrate de que se pueda acceder al puerto 9042 desde todos los componentes de Edge para Private Cloud, incluidos el servidor de administración, el procesador de mensajes, el router, Qpid y Postgres, a 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 dentro de un centro de datos, espera un tiempo (de 30 minutos a algunas horas) antes de continuar con los nodos del siguiente centro de datos. Durante este tiempo, revisa a fondo el centro de datos que se actualizó y asegúrate de que las métricas de rendimiento y funcionales de tu clúster de Apigee estén intactas. Este paso es fundamental para garantizar la estabilidad del centro de datos en el que se actualizó Cassandra a la versión 4.0.X, mientras que el resto de los componentes de Apigee permanecen en la versión 4.52.02.

1. Para actualizar un nodo de Cassandra, ejecuta el siguiente comando:

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

2. Una vez que se actualiza 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

3. El comando anterior generará un resultado similar al siguiente:

   Cassandra version is verified - [cqlsh 6.0.0 | Cassandra 4.0.18 | CQL spec 3.4.5 | Native protocol v5] 
   Metadata is verified

4. Ejecuta el siguiente comando post_upgrade en el nodo de Cassandra:

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

5. 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 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
   /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 cache cache_entries cache_entries_cache_name_idx
   /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 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

   Si usas la monetización, también ejecuta los siguientes comandos de recompilació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

Paso 3: Actualiza todos los nodos de administración

Actualiza todos los nodos de administración en todas las regiones uno por uno:

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

Paso 4: Actualiza todos los nodos de Runtime

Actualiza todos los nodos de Router y Message Processor en todas las regiones uno por uno:

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

Paso 5: Actualiza todos los componentes restantes de Edge para la nube privada 4.53.01

Actualiza todos los nodos edge-qpid-server y edge-postgres-server restantes en todas las regiones de a uno.

Actualización obligatoria a Zookeeper 3.8.4

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

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 configuran como observadores. Consulta Acerca de los líderes, los seguidores, los votantes y los observadores para obtener más detalles. Los nodos de votantes eligen un líder, después de lo cual los nodos de votantes se convierten en seguidores.

Durante el proceso de actualización, podría haber una demora momentánea o una falla de escritura en Zookeeper cuando se apaga el nodo líder. Esto podría afectar las operaciones de administración 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 procesador de mensajes, etcétera. No debería haber ningún impacto en las APIs de tiempo de ejecución de Apigee (a menos que estas APIs de tiempo de ejecución llamen a las APIs de administración) durante la actualización de Zookeeper si se sigue el procedimiento que se indica a continuación.

En términos generales, 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.

Cómo crear 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 una reversión restablecerá Zookeeper al estado en el que se encontraba cuando se tomó la copia de seguridad. Nota: Durante la restauración, se perderán todas las implementaciones o los cambios en la infraestructura de Apigee que se hayan realizado desde que se creó la copia de seguridad (cuya información se almacena en Zookeeper).

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

Si usas máquinas virtuales y tienes la capacidad, también se pueden tomar instantáneas o copias de seguridad de las VMs para restablecerlas o revertirlas (si es necesario).

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

Nota: Los siguientes comandos de ejemplo usan la utilidad nc para enviar datos a ZooKeeper. También puedes usar utilidades alternativas para enviar datos a ZooKeeper.

1. Si no está instalado en el nodo de ZooKeeper, instala nc:

     sudo yum install nc

2. Ejecuta el siguiente comando nc en el nodo, en el que 2181 es el puerto de ZooKeeper:

     echo stat | nc localhost 2181

   Deberías ver un resultado como el siguiente:

     Zookeeper version: 3.8.4-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC
     Clients:
      /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0)
     
     Latency min/avg/max: 0/0.2518/41
     Received: 647228
     Sent: 647339
     Connections: 4
     Outstanding: 0
     Zxid: 0x400018b15
     Mode: follower
     Node count: 100597

   En la línea Mode del resultado de los nodos, deberías ver observer, leader o follower (lo que significa que es un votante que no es el líder) según la configuración del nodo. Nota: En una instalación independiente de Edge con un solo nodo de ZooKeeper, Mode se establece como independiente.

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

Actualiza Zookeeper en los nodos observador y seguidor

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

1. Descarga y ejecuta el bootstrap de Edge para Private Cloud 4.53.01, como se describe en Actualiza a la versión 4.53.01 en un nodo con una conexión externa a Internet. Es probable que el proceso varíe según si el nodo tiene una conexión a Internet externa o si realizas una instalación sin conexión.
2. 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 cs,zk) 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.
3. 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 nuevo líder, podría haber retrasos momentáneos 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

Con los pasos de la sección Identifica al líder, a los seguidores y a los observadores anterior, verifica 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 haberse elegido en un centro de datos diferente del líder actual.

Líder de actualización

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

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

Actualización de Nginx 1.26 en Edge Router

La actualización a Edge para la Nube privada 4.53.01 desde versiones anteriores no actualiza automáticamente el software de Nginx a la versión más reciente (1.26.x). Esto se hace para evitar efectos secundarios accidentales en el tiempo de ejecución como resultado de los cambios documentados en Nginx 1.26 changes in Apigee Edge 4.53.01. Puedes actualizar Nginx de la versión 1.20.x a la 1.26.x de forma manual después de la verificación en entornos inferiores. Para actualizar manualmente, haz lo siguiente:

1. Asegúrate de que el nodo del router perimetral tenga el software 4.53.01 más reciente.

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

2. Cómo verificar la versión de Nginx que se está ejecutando

   /opt/nginx/sbin/nginx -V

   Si ejecutas una versión anterior de Nginx, puedes seguir los pasos que se indican a continuación para actualizar Nginx a la versión 1.26.X en el nodo del router.

3. Detén el proceso del router perimetral en el nodo del router

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

4. Actualiza el software de nginx en el nodo del router

   dnf update apigee-nginx

5. Verifica que se haya actualizado la versión de Nginx

   /opt/nginx/sbin/nginx -V

6. Inicia el proceso del router en el nodo

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

7. Repite el proceso en cada nodo del router, uno a la vez.

Se requiere la actualización a Postgres 17

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

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

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

• Si usas almacenamiento de datos local para tus nodos de Postgres, debes instalar un nuevo nodo de reserva de Postgres durante la actualización. Una vez que se complete la actualización, puedes retirar el nuevo nodo de reserva de Postgres.

  El nodo de espera adicional de Postgres es necesario si debes revertir la actualización por algún motivo. Si debes 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 de 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 tienen un nodo de Postgres. Puedes actualizar estos nodos de Postgres directamente sin tener que crear uno nuevo.

• Si usas almacenamiento de red para tus nodos de Postgres, como lo recomienda Apigee, no tienes que instalar un nodo de Postgres nuevo. En los procedimientos que se indican a continuación, puedes omitir los pasos que especifican la instalación y, luego, la baja de un nuevo nodo de espera de Postgres.

  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 obligado a revertir la operación, puedes restablecer el nodo de Postgres a partir de esa instantánea.

Cómo instalar un nodo de espera de Postgres nuevo

Este procedimiento 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.52.02 o 4.53.00), no para la versión 4.53.01.

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 nodo de espera de Postgres nuevo, haz lo siguiente:

1. En el servidor principal de Postgres actual, 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

   Aquí, existing_standby_ip es la dirección IP del servidor de espera de Postgres actual y new_standby_ip es la dirección IP del nuevo nodo de espera.

2. Reinicia apigee-postgresql en el servidor principal de Postgres:

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

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

4. Instala el nuevo servidor de espera de Postgres:
   1. Edita el archivo de configuración que usaste para instalar tu versión actual de Edge y especifica lo siguiente:

      # IP address of the current master:
      PG_MASTER=192.168.56.103
      # IP address of the new standby node
      PG_STANDBY=192.168.56.102

   2. Inhabilita SELinux como se describe en Instala la utilidad apigee-setup de Edge.

   3. Si actualmente usas Edge 4.52.02, sigue estos pasos:

      1. Descarga el archivo Edge bootstrap_4.52.02.sh en /tmp/bootstrap_4.52.02.sh :

         curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.51.00.sh

      2. Instala la utilidad apigee-service de Edge y las dependencias:

         sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

      Si actualmente usas Edge 4.53.00, haz lo siguiente:

      1. Descarga el archivo Edge bootstrap_4.53.00.sh en /tmp/bootstrap_4.53.00.sh :

         curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh

      2. Instala la utilidad apigee-service de Edge y las dependencias:

         sudo bash /tmp/bootstrap_4.53.00.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:

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

      Verifica que sea el servidor en espera.

Cómo realizar una actualización in situ de Postgres

Paso preliminar

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

1. Si no está presente, crea el archivo /opt/apigee/customer/application/postgresql.properties.
2. Cambia la propiedad de este archivo a apigee:

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

3. Agrega la siguiente propiedad al archivo:

   conf/postgresql.conf+max_locks_per_transaction=30000

4. Configura apigee-postgresql:

   apigee-service apigee-postgresql configure

5. Reinicia apigee-postgresql:

   apigee-service apigee-postgresql restart

Realiza la actualización in situ.

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

1. Actualiza postgres en el host principal

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

2. Ejecuta el comando de configuración en el host principal:

   apigee-service apigee-postgresql setup -f /opt/silent.conf

3. Ejecuta el comando de configuración en el host principal:

   apigee-service apigee-postgresql configure

4. Reinicia el host principal:

   apigee-service apigee-postgresql restart

5. Configúrala como principal:

   apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf

6. Asegúrate de que se haya iniciado el host principal:

   apigee-service apigee-postgresql wait_for_ready

7. Detén la instancia en espera:

   apigee-service apigee-postgresql stop

8. Actualiza la base de datos en espera.

   Nota: Si este paso genera un error o falla, se puede ignorar. update.sh intentará iniciar el servidor de reserva con una configuración incorrecta. Si la instalación de Postgres se actualizó a la versión 17, se puede ignorar el error.

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

9. Asegúrate de que la instancia en espera esté detenida:

   apigee-service apigee-postgresql stop

10. Quita la configuración anterior de la instancia en espera:

    rm -rf /opt/apigee/data/apigee-postgresql/

11. Configura la replicación en el servidor en espera:

    apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf

12. 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, se iniciará correctamente el modo de espera.

Cómo retirar un nodo de Postgres

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

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

2. 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, de la siguiente manera:

   "type" : [ "postgres-server" ],
   "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"

3. Detén el nuevo nodo en espera ejecutando el siguiente comando en el nuevo nodo en espera:

   /opt/apigee/apigee-service/bin/apigee-all stop

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

5. Reinicia apigee-postgresql en la instancia principal de Postgres:

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

6. Verifica que se haya quitado el nuevo nodo en espera. Para ello, consulta el archivo /opt/apigee/apigee-postgresql/conf/pg_hba.conf en el nodo principal. Solo deberías ver la siguiente línea en ese archivo:

   host replication apigee existing_standby_ip/32 trust

7. Borra el UUID del nodo en espera de ZooKeeper realizando la siguiente llamada a la API de administración 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 utilizar los índices y las rutas más óptimos para ejecutar consultas.

Postgres puede volver a generar sus estadísticas de forma gradual con el tiempo a medida que se ejecutan las consultas y cuando se ejecuta el daemon autovacuum. Sin embargo, hasta que se vuelvan a generar las estadísticas, es posible que las búsquedas 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.

Pasos para actualizar Apigee SSO desde versiones anteriores

En Edge para la Nube Privada 4.53.01, las claves y los certificados del IDP que se usan en el componente apigee-sso ahora se configuran a través de un almacén de claves. Deberás exportar la clave y el certificado que se usaron anteriormente a un almacén de claves, configurarlo y, luego, continuar con la actualización del SSO como de costumbre.

1. Identifica la clave y el certificado existentes que se usan para configurar el IDP:

   1. Para recuperar el certificado, busca el valor de SSO_SAML_SERVICE_PROVIDER_CERTIFICATE en el archivo de configuración de la instalación del SSO o consulta el componente apigee-sso para obtener conf_login_service_provider_certificate.

      Usa el siguiente comando en el nodo de SSO para consultar apigee-sso sobre la ruta del certificado del IDP. En el resultado, busca el valor en la última línea.

      apigee-service apigee-sso configure -search conf_login_service_provider_certificate

   2. Para recuperar la clave, busca el valor de SSO_SAML_SERVICE_PROVIDER_KEY en el archivo de configuración de la instalación del SSO o consulta el componente apigee-sso para conf_login_service_provider_key.

      Usa el siguiente comando en el nodo de SSO para consultar apigee-sso sobre la ruta de acceso de la clave del IDP. En el resultado, busca el valor en la última línea.

      apigee-service apigee-sso configure -search conf_login_service_provider_key

2. Exporta la clave y el certificado a un almacén de claves:
   1. Exporta la clave y el certificado a un almacén de claves PKCS12:

      sudo openssl pkcs12 -export -clcerts -in <certificate_path> -inkey <key_path> -out <keystore_path> -name <alias>

      Parámetros:

      • certificate_path: Es la ruta de acceso al archivo del certificado recuperado en el paso 1a.
      • key_path: Es la ruta de acceso al archivo de claves privadas que se recuperó en el paso 1b.
      • keystore_path: Es la ruta de acceso al almacén de claves recién creado que contiene el certificado y la clave privada.
      • alias: Es el alias que se usa para el par de claves y certificados dentro del almacén de claves.

      Consulta la documentación de OpenSSL para obtener más detalles.

   2. (Opcional) Exporta la clave y el certificado de PKCS12 a un almacén de claves JKS:

      sudo keytool -importkeystore -srckeystore <PKCS12_keystore_path> -srcstoretype PKCS12 -destkeystore <destination_keystore_path> -deststoretype JKS -alias <alias>

      Parámetros:

      • PKCS12_keystore_path: Es la ruta de acceso al almacén de claves PKCS12 creado en el paso 2a, que contiene el certificado y la clave.
      • destination_keystore_path: Es la ruta de acceso al nuevo almacén de claves JKS en el que se exportarán el certificado y la clave.
      • alias: Es el alias que se usa para el par de claves y certificados dentro del almacén de claves JKS.

   Consulta la documentación de keytool para obtener más detalles.

3. Cambia el propietario del archivo de almacén de claves de salida al usuario "apigee":

   sudo chown apigee:apigee <keystore_file>

4. Agrega las siguientes propiedades en el archivo de configuración de SSO de Apigee y actualízalas con la ruta de acceso del archivo del almacén de claves, la contraseña, el tipo de almacén de claves y el alias:

   # Path to the keystore file
   SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PATH=${APIGEE_ROOT}/apigee-sso/source/conf/keystore.jks
   
   # Keystore password
   SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PASSWORD=Secret123  # Password for accessing the keystore
   
   # Keystore type
   SSO_SAML_SERVICE_PROVIDER_KEYSTORE_TYPE=JKS  # Type of keystore, e.g., JKS, PKCS12
   
   # Alias within keystore that stores the key and certificate
   SSO_SAML_SERVICE_PROVIDER_KEYSTORE_ALIAS=service-provider-cert 

5. Actualiza el software de Apigee SSO en el nodo de SSO de la manera habitual con el siguiente comando:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f /opt/silent.conf

Nueva IU de Edge

En esta sección, se enumeran las consideraciones relacionadas con la IU de Edge. Para obtener más información, consulta La nueva IU de Edge para la nube privada.

Instala la IU de Edge

Después de completar la instalación inicial, Apigee recomienda que instales la IU de Edge, que es una interfaz de usuario mejorada para los desarrolladores y administradores de Apigee Edge para una nube privada.

Ten en cuenta que la IU de Edge requiere que inhabilites la autenticación básica y uses un IDP, como SAML o LDAP.

Para obtener más información, consulta Instala la nueva IU de Edge.

Actualización con mTLS de Apigee

Para actualizar Apigee mTLS , sigue estos pasos:

• Desinstala mTLS de Apigee.
• Vuelve a instalar mTLS de Apigee.

Revierte una actualización

En caso de que falle una actualización, puedes intentar corregir el problema y, luego, ejecutar update.sh nuevamente. Puedes ejecutar la actualización varias veces y se reanudará desde donde quedó.

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

Información de actualización del registro

De forma predeterminada, la utilidad update.sh escribe la información de registro en lo siguiente:

/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 que se interrumpa el servicio.

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

La clave para realizar actualizaciones sin tiempo de inactividad es quitar cada router, uno a la vez, 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.

1. Actualiza las máquinas en el orden correcto para tu instalación, como se describe en Orden de actualización de la máquina.
2. 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).
3. 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 procesador de mensajes en el mismo nodo.
4. Haz que el router vuelva a estar accesible.
5. Repite los pasos del 2 al 4 para los routers restantes.
6. Continúa la actualización para las máquinas restantes de la 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, realiza las siguientes acciones:
    1. Haz que el router sea inaccesible.
    2. Hacer que el Message Processor sea inaccesible
  • Después de la actualización, realiza las siguientes acciones:
    1. Asegúrate de que se pueda acceder al Message Processor.
    2. Haz que el router sea accesible.
• En nodos de Router únicos:
  • Antes de la actualización, haz que el router sea inaccesible.
  • Después de la actualización, haz que el router sea accesible.
• En nodos únicos de Message Processor, haz lo siguiente:
  • Antes de la actualización, haz que el procesador de mensajes sea inaccesible.
  • Después de la actualización, haz que el procesador de mensajes sea accesible.

Usa un archivo de configuración silencioso

Debes pasar un archivo de configuración silencioso al comando de actualización. El archivo de configuración silencioso debe ser el mismo que usaste para instalar Edge para la nube privada 4.52.02 o 4.53.00.

Actualización a la versión 4.53.01 en un nodo con una conexión externa a Internet

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

1. 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.
2. Accede a tu nodo como raíz para instalar los RPM de Edge.
3. Inhabilita SELinux como se describe en Instala la utilidad apigee-setup de Edge.
4. Si realizas la instalación en AWS, ejecuta los siguientes comandos de yum-configure-manager:

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

5. Si actualmente usas Edge 4.52.02 o 4.53.00, haz lo siguiente:

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

   2. Instala la utilidad apigee-service y las dependencias de Edge 4.53.01 ejecutando el siguiente comando:

      sudo bash /tmp/bootstrap_4.53.01.sh apigeeuser=uName apigeepassword=pWord

      En el ejemplo anterior, 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 instalado Java 1.8. De lo contrario, el instalador lo hará por ti.

      Usa la opción JAVA_FIX para especificar cómo controlar la instalación de Java. JAVA_FIX toma los siguientes valores:

      • I: Instala OpenJDK 1.8 (predeterminado).
      • C: Continúa sin instalar Java.
      • Q: Salir. En esta opción, debes instalar Java por tu cuenta.
   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á. Entre los valores posibles, se incluyen los siguientes:
        • cs: Cassandra
        • edge: Todos los componentes de Edge, excepto la IU de Edge: Management Server, Message Processor, Router, QPID Server y Postgres Server
        • ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • sso: SSO de Apigee (si instalaste el SSO)
        • ue: Nueva IU de Edge
        • ui: IU de Edge clásica
        • zk: Zookeeper
      • 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.52.02 o 4.53.00.

      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 ./sa_silent_config

   7. Si aún no lo hiciste, reinicia los componentes de la IU de Edge en todos los nodos que los ejecutan:

      /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-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 más adelante decides revertir la actualización, usa el procedimiento que se describe en Cómo revertir la versión 4.53.01.

Actualiza a la versión 4.53.01 desde un repo local

Si tus nodos de Edge están detrás de un firewall o tienen prohibido el acceso al repositorio de Apigee a través de Internet, puedes realizar la actualización desde un repositorio local, o bien desde un duplicado del repositorio de Apigee.

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

• Crea un archivo .tar del repo, 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 te proporciona el servidor web Nginx para que lo uses, o bien puedes usar tu propio servidor web.

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

1. Crea un repo local 4.53.01 como se describe en "Crea un repositorio local de Apigee" en Instala la utilidad apigee-setup de Edge.
2. Para instalar apigee-service desde un archivo .tar, haz lo siguiente:
   1. En el nodo con el repo local, usa el siguiente comando para empaquetar el repo local en un solo archivo .tar llamado /opt/apigee/data/apigee-mirror/apigee-4.53.01.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ópialo en el directorio /tmp del nodo nuevo.
   3. En el nodo nuevo, descomprime el archivo en el directorio /tmp:

      tar -xzf apigee-4.53.01.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 desde /tmp/repos:

      sudo bash /tmp/repos/bootstrap_4.53.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Ten en cuenta que debes incluir la ruta de acceso al directorio de repositorios en este comando.

3. Para instalar apigee-service con el servidor web Nginx, haz lo siguiente:
   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.53.01.sh de Edge en /tmp/bootstrap_4.53.01.sh:

      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.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-setup de Edge y las dependencias:

      sudo bash /tmp/bootstrap_4.53.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      Aquí, uName:pWord son el nombre de usuario y la contraseña del repo.

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

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

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

7. 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á. Por lo general, actualizas los siguientes componentes:
     • cs: Cassandra
     • edge: Todos los componentes de Edge, excepto la IU de Edge: Management Server, Message Processor, Router, QPID Server y Postgres Server
     • ldap: OpenLDAP
     • ps: postgresql
     • qpid: qpidd
     • sso: SSO de Apigee (si instalaste el SSO)
     • ue Nueva IU de Edge
     • ui: IU de Edge clásica
     • zk: Zookeeper
   • 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.52.02 o 4.53.00.

   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 /tmp/sa_silent_config

8. Si aún no lo hiciste, reinicia los componentes de la IU en todos los nodos que la ejecutan:

   /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart

9. 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.53.01.

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:

• Debes actualizar todos los nodos de LDAP antes de actualizar cualquier otro componente. Deberás seguir pasos especiales para actualizar LDAP.
• Debes actualizar todos los nodos de Cassandra y ZooKeeper. Si actualizas desde la versión 4.52.02, sigue los pasos especiales para actualizar Cassandra. Deberás seguir los pasos especiales para actualizar Zookeeper para las versiones 4.52.02 o 4.53.00.
• Debes actualizar todos los servidores de administración y los procesadores de mensajes y routers con la opción -c edge para actualizarlos.
• Debes actualizar todos los nodos de Postgres siguiendo los pasos especiales para actualizar Postgres.
• Debes actualizar los componentes edge-qpid-server y edge-postgres-server en todos los centros de datos.
• Debes actualizar todos los nodos de Qpid.
• Debes actualizar los nodos de la IU de Edge y también los nodos de la nueva IU de Edge y del SSO(si corresponde).
• No hay un paso independiente para actualizar la monetización. Se actualiza cuando especificas la opción de borde -c.

Actualización independiente de 1 nodo

Sigue estos pasos para actualizar una configuración independiente de 1 nodo a la versión 4.53.01:

1. Actualiza todos los componentes:

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

2. (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 ver la lista de topologías de Edge y números de nodos.

1. Actualiza LDAP en la máquina 1:

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

2. Actualiza Cassandra y ZooKeeper en la máquina 1:

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

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

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

4. Actualiza Postgres en la máquina 2:

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

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

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

6. Actualiza Qpid en la máquina 2:

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

7. Actualiza la IU en la máquina 1:

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

8. (Si instalaste apigee-adminapi) Actualizaste la utilidad apigee-adminapi en la máquina 1:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

9. (Si instalaste Apigee SSO) Actualiza Apigee SSO en la máquina 1:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   Aquí sso_config_file es el archivo de configuración que creaste cuando instalaste el SSO.

10. Reinicia el componente de la IU de Edge en la máquina 1:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Actualización de 5 nodos

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

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

1. Actualiza LDAP en la máquina 1:

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

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

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

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

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

4. Actualiza Postgres en la máquina 4:

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

5. Actualiza Postgres en la máquina 5:

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

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

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

7. Actualiza Qpid en la máquina 4:

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

8. Actualiza Qpid en la máquina 5:

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

9. Actualiza la IU de Edge:
   • IU clásica: Si usas la IU clásica, actualiza el componente ui en la máquina 1, como se muestra en el siguiente ejemplo:

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

   • Nueva IU de Edge: Si instalaste la nueva IU de Edge, actualiza el componente ue en la máquina correspondiente (es posible que no sea la máquina 1):

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

10. (Si instalaste apigee-adminapi) Actualizaste la utilidad apigee-adminapi en la máquina 1:

    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

11. (Si instalaste Apigee SSO) Actualiza Apigee SSO en la máquina 1:

    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Aquí sso_config_file es el archivo de configuración que creaste cuando instalaste el SSO.

12. Reinicia el componente de la IU:
    • IU clásica: Si usas la IU clásica, reinicia el componente edge-ui en la máquina 1, como se muestra en el siguiente ejemplo:

      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    • Nueva IU de Edge: Si instalaste la nueva IU de Edge, reinicia el componente edge-management-ui en la máquina correspondiente (es posible que no sea la máquina 1):

      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Actualización agrupada de 9 nodos

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

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

1. Actualiza LDAP en la máquina 1:

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

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

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

3. Actualiza los componentes de Edge en las máquinas 1, 4 y 5 (servidor de administración, procesador de mensajes y router) en ese orden:

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

4. Actualiza Postgres en la máquina 8:

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

5. Actualiza Postgres en la máquina 9:

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

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

7. Actualiza Qpid en las máquinas 6 y 7:

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

8. Actualiza la IU nueva (ue) o la IU clásica (ui) en la máquina 1:

   /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

9. (Si instalaste apigee-adminapi) Actualiza la utilidad apigee-adminapi en la máquina 1:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

10. (Si instalaste Apigee SSO) Actualiza Apigee SSO en la máquina 1:

    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Aquí sso_config_file es el archivo de configuración que creaste cuando instalaste el SSO.

11. Reinicia el componente de la IU:
    • IU clásica: Si usas la IU clásica, reinicia el componente edge-ui en la máquina 1, como se muestra en el siguiente ejemplo:

      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    • Nueva IU de Edge: Si instalaste la nueva IU de Edge, reinicia el componente edge-management-ui en la máquina correspondiente (es posible que no sea la máquina 1):

      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Actualización agrupada de 13 nodos

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

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

1. Actualiza LDAP en las máquinas 4 y 5:

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

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

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

3. Actualiza los componentes de Edge en las máquinas 6, 7, 10 y 11 en ese orden:

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

4. Actualiza Postgres en la máquina 8:

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

5. Actualiza Postgres en la máquina 9:

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

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

7. Actualiza Qpid en las máquinas 12 y 13:

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

8. Actualiza la IU nueva (ue) o la IU clásica (ui) en las máquinas 6 y 7:

   /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

9. (Si instalaste apigee-adminapi) Se actualizó la utilidad apigee-adminapi en las máquinas 6 y 7:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

10. (Si instalaste Apigee SSO) Actualiza Apigee SSO en las máquinas 6 y 7:

    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Aquí sso_config_file es el archivo de configuración que creaste cuando instalaste el SSO.

11. Reinicia el componente de la IU:
    • IU clásica: Si usas la IU clásica, reinicia el componente edge-ui en las máquinas 6 y 7, como se muestra en el siguiente ejemplo:

      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    • Nueva IU de Edge: Si instalaste la nueva IU de Edge, reinicia el componente edge-management-ui en las máquinas 6 y 7:

      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Actualización agrupada de 12 nodos

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

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

1. Actualiza LDAP:
   1. Máquina 1 en el centro de datos 1

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

   2. Máquina 7 en el centro de datos 2

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

2. Actualiza Cassandra y ZooKeeper:
   1. Máquinas 1, 2 y 3 en el centro de datos 1:

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

   2. En las máquinas 7, 8 y 9 del centro de datos 2, haz lo siguiente:

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

3. Actualiza los componentes de Edge:
   1. En las máquinas 1, 2 y 3 del centro de datos 1, haz lo siguiente:

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

   2. En las máquinas 7, 8 y 9 del centro de datos 2

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

4. Actualiza Postgres:
   1. Máquina 6 en el centro de datos 1

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

   2. Máquina 12 en el centro de datos 2

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

5. Actualiza los componentes de Edge:
   1. Máquinas 4, 5 y 6 del centro de datos 1

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

   2. Máquinas 10, 11 y 12 del centro de datos 2

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

6. Actualiza qpidd:
   1. Máquinas 4 y 5 en el centro de datos 1
      1. Actualiza qpidd en la máquina 4:

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

      2. Actualiza qpidd en la máquina 5:

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

   2. Máquinas 10 y 11 en el Centro de Datos 2
      1. Actualiza qpidd en la máquina 10:

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

      2. Actualiza qpidd en la máquina 11:

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

7. Actualiza la IU nueva (ue) o la IU clásica (ui):
   1. Máquina 1 en el centro de datos 1:

      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

   2. Máquina 7 en el centro de datos 2:

      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

8. (Si instalaste apigee-adminapi) Se actualizó la utilidad apigee-adminapi:
   1. Máquina 1 en el centro de datos 1:

      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

   2. Máquina 7 en el centro de datos 2:

      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

9. (Si instalaste Apigee SSO) Actualiza Apigee SSO:
   1. Máquina 1 en el centro de datos 1:

      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   2. Máquina 7 en el centro de datos 2:

      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   Aquí sso_config_file es el archivo de configuración que creaste cuando instalaste el SSO.

10. Reinicia el componente de la nueva IU de Edge (edge-management-ui) o de la IU clásica de Edge (edge-ui) en las máquinas 1 y 7:

    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

Para una configuración no estándar

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

1. LDAP
2. Cassandra
3. Zookeeper
4. Servidor de administración
5. Message Processor
6. Router
7. Postgres
8. Edge, lo que significa el perfil "-c edge" en todos los nodos en el siguiente orden: nodos con servidor Qpid y servidor Edge Postgres.
9. qpidd
10. IU de Edge (clásica o nueva)
11. apigee-adminapi
12. SSO de Apigee

Después de terminar la actualización, asegúrate de reiniciar el componente de la IU de Edge en todas las máquinas que lo ejecutan.