Apigee admite la actualización de Edge para la nube privada directamente de la versión 4.52.02 a la 4.53.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.
Requisitos previos de la actualización
Asegúrate de cumplir con los siguientes requisitos antes de actualizar Apigee Edge:
- 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. Usa el procedimiento de 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 la copia 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 anteriormente actualizaste de una versión anterior de Edge para nube privada a la versión 4.52.02 y ahora planeas actualizar a la versión 4.53.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.52.02 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.53.00.
- Configura claves y certificados de IdP en Edge para nube privada 4.53.00
En Edge para nube privada 4.53.00, las claves y los certificados del IDP que se usan en el componente
apigee-ssoahora 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 el SSO de Apigee desde versiones anteriores para obtener pasos detallados antes de actualizar el componente de SSO. - Requisitos de Python
Asegúrate de que todos los nodos, incluidos los de Cassandra, tengan instalado Python 3 antes de intentar la actualización.
Propagación automática de la configuración de propiedades
Si editaste archivos .properties en /opt/apigee/customer/application para establecer propiedades, la actualización conservará esos valores.
Actualización de Nginx 1.26 en Edge-Router
La actualización a Edge para nube privada 4.53.00 desde versiones anteriores no actualiza automáticamente el software de Nginx a la versión más reciente (1.26.x). Esto es para evitar efectos secundarios accidentales en el entorno de ejecución como resultado de los cambios documentados en Cambios de Nginx 1.26 en Apigee Edge 4.53.00. Puedes actualizar Nginx de forma manual de la versión 1.20.x a la 1.26.x después de la verificación en entornos inferiores. Para actualizar de forma manual, sigue estos pasos:
Asegúrate de que el nodo del router perimetral tenga el software 4.53.00 más reciente
/opt/apigee/apigee-service/bin/apigee-service edge-router version
Verificar la versión de Nginx que se está ejecutando actualmente
/opt/nginx/sbin/nginx -V
Si usas 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.
Detén el proceso de edge-router en el nodo del router
/opt/apigee/apigee-service/bin/apigee-service edge-router stop
Actualiza el software de nginx en el nodo del router
dnf update apigee-nginx-1.26.3
Verifica que se haya actualizado la versión de Nginx
/opt/nginx/sbin/nginx -V
Inicia el proceso del router en el nodo
/opt/apigee/apigee-service/bin/apigee-service edge-router start
Repite el proceso en cada nodo de router, uno a la vez.
Actualización obligatoria a Cassandra 4.0.13
Apigee Edge para nube privada 4.53.00 incluye una actualización de Cassandra a la versión 4.0.13.
Actualizaciones y reversión
- La actualización de Cassandra 3.11.X a Cassandra 4.0.X es un proceso sencillo. Cassandra 4.0.X, que se lanzó con Edge para nube privada 4.53.00, es compatible con los componentes de entorno de ejecución y administración de la nube privada 4.52.02.
- No es posible realizar una reversión directa in situ de Cassandra 4.0.X a 3.11.X. La reversión con réplicas o copias de seguridad es un procedimiento complejo y 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 realizar 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 en un solo centro de datos es sencilla, 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 retirar una vez que finalice la actualización o se alcance el punto de control 2.
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 3.11.X. Sin embargo, es probable que este método implique tiempo de inactividad y pérdida de datos.
Varios centros de datos
La operación de varios centros de datos con Edge para nube privada 4.52.02 ofrece más flexibilidad para las reversiones durante la actualización a Edge para 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 actualiza a la versión 4.0.X, no debes revertir a Cassandra 3.11.X. Debes seguir usando la versión más reciente de Cassandra con los otros componentes de nube privada 4.53.00 o 4.52.02.
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 ejecute la versión anterior.
- Sensible al tiempo: Si bien puedes pausar durante un período breve (se recomiendan unas 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.
La reversión como un proceso de dos puntos de control
- Punto de control 1: Es el estado inicial, con todos los componentes en la versión 4.52.02. La reversión completa es posible siempre que al menos un centro de datos de Cassandra permanezca en la versión anterior.
- Punto de control 2: Después de que se actualicen todos los nodos de Cassandra en todos los centros de datos. Puedes volver a este estado, pero no puedes revertir al punto de control 1.
Ejemplo
Considera un clúster de dos centros de datos (DC):
- Estado inicial: Los nodos de Cassandra en ambos DC 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 nube privada. Supongamos que hay tres nodos de Cassandra por DC.
- Actualiza 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 versión mixta.
- Actualiza DC-2: Actualiza los tres nodos de Cassandra restantes en DC-2. Este se convierte en tu nuevo punto de control de reversión.
- Actualiza otros componentes: Actualiza los nodos de administración, entorno de ejecución y estadísticas 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
Debes ejecutar Cassandra 3.11.16 con Edge para la nube privada 4.52.02 y asegurarte de lo siguiente:- Todo el clúster está operativo y es completamente funcional con Cassandra 3.11.16.
- La estrategia de compactación se establece en
LeveledCompactionStrategy(un requisito previo para la actualización a la versión 4.52.02). - Asegúrate de que se hayan completado todos los pasos que se indican a continuación como parte de la actualización inicial de Cassandra 3.11 en Edge para la nube privada de 4.52.02:
- El comando
post_upgradedebería haberse ejecutado en cada nodo de Cassandra durante la actualización anterior. - El comando
drop_old_tablesdebería haberse ejecutado en todo el clúster de Cassandra durante la actualización anterior.
- El comando
Si no tienes certeza de que se hayan completado los pasos anteriores, puedes volver a ejecutarlos de forma segura. Asegúrate de que estos pasos se ejecuten en Cassandra 3.11 mientras aún estás en Edge para la nube privada 4.52.02, antes de intentar actualizar a la versión 4.53.00:
- Ejecuta el siguiente comando
post_upgradeen cada nodo de Cassandra, uno por uno:/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
- Ejecuta el siguiente comando para quitar las tablas antiguas sin usar del clúster de Cassandra. Este comando solo se debe ejecutar en 1 nodo del clúster:
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile
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 las VMs 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 Message Processor, el router, Qpid y Postgres, a los nodos de Cassandra si aún no están configurados. 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 (de 30 minutos a 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 funcionamiento y rendimiento 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.
-
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.0.0 | Cassandra 4.0.13 | CQL spec 3.4.5 | Native protocol v5] Metadata is verified
-
Ejecuta el siguiente comando
post_upgradeen el nodo de Cassandra:/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
-
Ejecuta los siguientes comandos de nodetool para recompilar índices en el nodo de Cassandra:
Si usas la monetización, también ejecuta los siguientes comandos para reconstruir índices relacionados con los espacios de claves de monetización:/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/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 del entorno de ejecución
Actualiza todos los nodos de routers 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 nube privada 4.53.00
Actualiza todos los nodos edge-qpid-server y edge-postgres-server restantes en todas las regiones, uno por uno.
Pasos para actualizar el SSO de Apigee desde versiones anteriores
En Edge para nube privada 4.53.00, 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 antes a un almacén de claves, configurarlo y, luego, continuar con la actualización del SSO como de costumbre.
-
Identifica la clave y el certificado existentes que se usan para configurar el IdP:
-
Para recuperar el certificado, busca el valor de SSO_SAML_SERVICE_PROVIDER_CERTIFICATE en el archivo de configuración de la instalación de SSO o consulta el componente
apigee-ssopara conf_login_service_provider_certificate.Usa el siguiente comando en el nodo de SSO para consultar
apigee-ssoy obtener la ruta de acceso 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
-
Para recuperar la clave, busca el valor de SSO_SAML_SERVICE_PROVIDER_KEY en el archivo de configuración de la instalación de SSO o consulta el componente
apigee-ssopara conf_login_service_provider_key.Usa el siguiente comando en el nodo de SSO para consultar a
apigee-ssola 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
-
-
Exporta la clave y el certificado a un almacén de claves:
-
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 que se recuperó en el paso 1.a.key_path: Es la ruta de acceso al archivo de clave privada que se recuperó en el paso 1.b.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 clave y certificado dentro del almacén de claves.
Consulta la documentación de OpenSSL para obtener más detalles.
-
Exporta la clave y el certificado de PKCS12 a un almacén de claves JKS (opcional):
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 2.a, que contiene el certificado y la clave.destination_keystore_path: Es la ruta de acceso al nuevo almacén de claves de JKS en el que se exportarán el certificado y la clave.alias: Es el alias que se usa para el par de clave y certificado dentro del almacén de claves de JKS.
Consulta la documentación de keytool para obtener más detalles.
-
Exporta la clave y el certificado a un almacén de claves PKCS12:
- Cambia el propietario del archivo de almacén de claves de salida al usuario "apigee":
sudo chown apigee:apigee <keystore_file>
-
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
-
Actualiza el software de SSO de Apigee en el nodo de SSO como de costumbre 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 desarrolladores y administradores de Edge para nube privada de Apigee.
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.
Actualiza con mTLS de Apigee
Para actualizar mTLS de Apigee, sigue estos pasos:
Revierte una actualización
En caso de que falle la 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 la falla requiere que reviertas la actualización a la versión anterior, consulta Revierte la versión 4.53.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 una actualización progresiva te permite actualizar tu instalación de Edge sin desactivar Edge.
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 las máquinas.
- Cuando sea el momento de actualizar los routers, selecciona uno y haz que no se pueda acceder a él, como se describe en Habilita o inhabilita la accesibilidad del servidor (Message Processor 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.
- Vuelve a hacer que el router sea accesible.
- 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, realiza lo siguiente:
- Haz que el router no sea accesible.
- Haz que no se pueda acceder al Message Processor.
- Después de la actualización, realiza lo siguiente:
- Haz que se pueda acceder al Message Processor.
- Haz que se pueda acceder al router.
- Antes de la actualización, realiza lo siguiente:
- En nodos de router únicos:
- Antes de la actualización, haz que el router no sea accesible.
- Después de la actualización, haz que se pueda acceder al router.
- En nodos de Message Processor únicos:
- Antes de la actualización, haz que el Message Processor no esté disponible.
- Después de la actualización, haz que se pueda acceder al Message Processor.
Usa un archivo de configuración silenciosa
Debes pasar un archivo de configuración silenciosa al comando de actualización. El archivo de configuración silenciosa debe ser el mismo que usaste para instalar Edge para nube privada 4.52.02.
Actualiza a 4.53.00 en un nodo con una conexión a Internet externa
Usa el siguiente procedimiento para actualizar los componentes de Edge en un nodo:
- Si están presentes, inhabilita los trabajos de
cronconfigurados para realizar una operación de reparación en Cassandra hasta que se complete la actualización. - Accede a tu nodo como raíz para instalar los RPM de Edge.
- 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
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional -
Si actualmente usas Edge 4.52.02, haz lo siguiente:
- Descarga el archivo
bootstrap_4.53.00.shde 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-servicede Edge 4.53.00 y las dependencias ejecutando el siguiente comando:sudo bash /tmp/bootstrap_4.53.00.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_FIXpara especificar cómo controlar la instalación de Java.JAVA_FIXtoma los siguientes valores:I: Instala OpenJDK 1.8 (predeterminado).C: Continúa sin instalar Java.Q: Salir. Para esta opción, debes instalar Java por tu cuenta.
- Usa
apigee-servicepara actualizar la utilidadapigee-setup, como se muestra en el siguiente ejemplo:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- Actualiza la utilidad
apigee-validateen 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-provisionen 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
updateen 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: Cassandraedge: Todos los componentes de Edge, excepto la IU de Edge: servidor de administración, Message Processor, router, servidor de QPID y servidor de Postgresldap: OpenLDAPps: postgresqlqpid: qpiddsso: SSO de Apigee (si instalaste el SSO)ue: Nueva IU de Edgeui: IU clásica de Edgezk: 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.
Puedes ejecutar
update.shen 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
- component es el componente de Edge que se actualizará. Entre los valores posibles, se incluyen los siguientes:
- Reinicia los componentes de la IU de Edge en todos los nodos que los ejecutan, si aún no lo hiciste:
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
- Para probar la actualización, ejecuta la utilidad
apigee-validateen el servidor de administración, como se describe en Prueba la instalación.
- Descarga el archivo
Si más adelante decides revertir la actualización, usa el procedimiento que se describe en Revierte la versión 4.53.00.
Actualiza a la versión 4.53.00 desde un repositorio 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 local de Edge, tienes dos opciones para actualizar Edge desde el repositorio local:
- Crea un archivo .tar del repositorio, copia el archivo .tar en un nodo y, luego, actualiza Edge desde el archivo .tar.
- Instala un servidor web en el nodo con el repositorio 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 repositorio local 4.53.00, haz lo siguiente:
- Crea un repositorio local 4.53.00 como se describe en "Crea un repositorio local de Apigee" en Instala la utilidad apigee-setup de Edge.
- Para instalar apigee-service desde un archivo .tar, haz lo siguiente:
- 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.53.00.tar.gz:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- Copia el archivo .tar en el nodo en el que deseas actualizar Edge. Por ejemplo, cópialo en
el directorio
/tmpdel nodo nuevo. - En el nodo nuevo, descomprime el archivo en el directorio
/tmp:tar -xzf apigee-4.53.00.tar.gz
Este comando crea un directorio nuevo, llamado
repos, en el directorio que contiene el archivo .tar. Por ejemplo,/tmp/repos. - Instala la utilidad
apigee-servicede Edge y las dependencias de/tmp/repos:sudo bash /tmp/repos/bootstrap_4.53.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Ten en cuenta que debes incluir la ruta de acceso al directorio repos en este comando.
- En el nodo con el repositorio local, usa el siguiente comando para empaquetar el repositorio local
en un solo archivo .tar llamado
- Para instalar apigee-service con el servidor web de Nginx, haz lo siguiente:
- Configura el servidor web Nginx como se describe en "Instala desde el repositorio con el servidor web Nginx" en Instala la utilidad apigee-setup de Edge.
- En el nodo remoto, descarga el archivo
bootstrap_4.53.00.shde Edge en/tmp/bootstrap_4.53.00.sh:/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
Donde uName:pWord son el nombre de usuario y la contraseña que configuraste antes para el repositorio, y remoteRepo es la dirección IP o el nombre de DNS del nodo del repositorio.
- En el nodo remoto, instala la utilidad
apigee-setupde Edge y las dependencias:sudo bash /tmp/bootstrap_4.53.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
Donde uName:pWord son el nombre de usuario y la contraseña del repositorio.
- Usa
apigee-servicepara actualizar la utilidadapigee-setup, como se muestra en el siguiente ejemplo:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- Actualiza la utilidad
apigee-validateen 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-provisionen 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
updateen 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: Cassandraedge: Todos los componentes de Edge, excepto la IU de Edge: Management Server, Message Processor, Router, QPID Server, Postgres Serverldap: OpenLDAPps: postgresqlqpid: qpiddsso: SSO de Apigee (si instalaste el SSO)- Nueva IU de Edge de
ue ui: IU clásica de Edgezk: 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.50.00 o 4.51.00.
Puedes ejecutar
update.shen 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
- component es el componente de Edge que se actualizará. Por lo general, actualizas los siguientes componentes:
- 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|edge-ui] restart
- Para probar la actualización, ejecuta la utilidad
apigee-validateen 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 Revierte la versión 4.53.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:
- Debes actualizar todos los nodos de Cassandra y ZooKeeper antes de actualizar cualquier otro nodo.
- Para cualquier máquina con varios componentes de Edge (Management Server, Message Processor,
Router, QPID Server, pero no Postgres Server), usa la opción
-c edgepara actualizarlos todos al mismo tiempo. - Si un paso especifica que se debe realizar en varias máquinas, hazlo en el orden de máquinas especificado.
- 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.53.00, sigue estos pasos:
- Actualiza todos los componentes:
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
- (Si instalaste
apigee-adminapi) Actualiza la utilidadapigee-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 Cassandra y ZooKeeper en la máquina 1:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Actualiza Postgres en la máquina 2:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Actualiza LDAP en la máquina 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Actualiza los componentes de Edge en las máquinas 2 y 1:
/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 la IU en la máquina 1:
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- (Si instalaste
apigee-adminapi) Se actualizó la utilidadapigee-adminapien la máquina 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Si instalaste el SSO de Apigee) Actualiza el SSO de Apigee en la máquina 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
Donde sso_config_file es el archivo de configuración que creaste cuando instalaste el SSO.
- 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 obtener la lista de topologías de Edge y números de nodos.
- Actualiza Cassandra y ZooKeeper en las máquinas 1, 2 y 3:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Actualiza Postgres en la máquina 4:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Actualiza Postgres en la máquina 5:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Actualiza LDAP en la máquina 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Actualiza los componentes de Edge en las máquinas 4, 5, 1, 2 y 3:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Actualiza Qpid en la máquina 4:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Actualiza Qpid en la máquina 5:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Actualiza la IU de Edge:
- IU clásica: Si usas la IU clásica, actualiza el componente
uien 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
ueen la máquina adecuada (puede que no sea la máquina 1):/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
- IU clásica: Si usas la IU clásica, actualiza el componente
- (Si instalaste
apigee-adminapi) Se actualizó la utilidadapigee-adminapien la máquina 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Si instalaste el SSO de Apigee) Actualiza el SSO de Apigee en la máquina 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
Donde sso_config_file es el archivo de configuración que creaste cuando instalaste el SSO.
- Reinicia el componente de la IU:
- IU clásica: Si usas la IU clásica, reinicia el componente
edge-uien la máquina 1, como se muestra en el siguiente ejemplo:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- IU de Edge nueva: Si instalaste la IU de Edge nueva, reinicia el componente
edge-management-uien la máquina adecuada (puede que no sea la máquina 1):/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- IU clásica: Si usas la IU clásica, reinicia el componente
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 Cassandra y ZooKeeper en las máquinas 1, 2 y 3:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -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 LDAP en la máquina 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Actualiza los componentes de Edge en las máquinas 6, 7, 8, 9, 1, 4 y 5 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 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
- (Si instalaste
apigee-adminapi) Actualiza la utilidadapigee-adminapien la máquina 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Si instalaste el SSO de Apigee) Actualiza el SSO de Apigee en la máquina 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
Donde sso_config_file es el archivo de configuración que creaste cuando instalaste el SSO.
- Reinicia el componente de la IU:
- IU clásica: Si usas la IU clásica, reinicia el componente
edge-uien la máquina 1, como se muestra en el siguiente ejemplo:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- IU de Edge nueva: Si instalaste la IU de Edge nueva, reinicia el componente
edge-management-uien la máquina adecuada (puede que no sea la máquina 1):/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- IU clásica: Si usas la IU clásica, reinicia el componente
Actualización de clústeres de 13 nodos
Actualiza los siguientes componentes para una instalación agrupada en clústeres de 13 nodos:
Consulta Topologías de instalación para obtener la lista de topologías de Edge y números de nodos.
- Actualiza Cassandra y ZooKeeper en las máquinas 1, 2 y 3:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -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 LDAP en las máquinas 4 y 5:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Actualiza los componentes de Edge en las máquinas 12, 13, 8, 9, 6, 7, 10 y 11 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 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
- (Si instalaste
apigee-adminapi) Se actualizó la utilidadapigee-adminapien las máquinas 6 y 7:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Si instalaste el SSO de Apigee) Actualiza el SSO de Apigee en las máquinas 6 y 7:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
Donde sso_config_file es el archivo de configuración que creaste cuando instalaste el SSO.
- Reinicia el componente de la IU:
- IU clásica: Si usas la IU clásica, reinicia el componente
edge-uien 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-uien las máquinas 6 y 7:/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- IU clásica: Si usas la IU clásica, reinicia el componente
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 Cassandra y ZooKeeper:
- En las máquinas 1, 2 y 3 del centro de datos 1:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- En las máquinas 7, 8 y 9 del centro de datos 2
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- En las máquinas 1, 2 y 3 del centro de datos 1:
- 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
- Máquina 6 en el centro de datos 1
- 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
- Máquina 1 en el centro de datos 1
- Actualiza los componentes de Edge:
- Máquinas 4, 5, 6, 1, 2 y 3 en el centro de datos 1
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Máquinas 10, 11, 12, 7, 8 y 9 en el centro de datos 2
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Máquinas 4, 5, 6, 1, 2 y 3 en el centro de datos 1
- Actualiza qpidd:
- Máquinas 4 y 5 en el centro de datos 1
- Actualiza
qpidden la máquina 4:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Actualiza
qpidden la máquina 5:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Actualiza
- Máquinas 10 y 11 en el centro de datos 2
- Actualiza
qpidden la máquina 10:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Actualiza
qpidden la máquina 11:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Actualiza
- Máquinas 4 y 5 en el centro de datos 1
- Actualiza la IU nueva (
ue) o la IU clásica (ui):- Máquina 1 en el centro de datos 1:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- Máquina 7 en el centro de datos 2:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- Máquina 1 en el centro de datos 1:
- (Si instalaste
apigee-adminapi) Se actualizó la utilidadapigee-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
- Máquina 1 en el centro de datos 1:
- (Si instalaste el SSO de Apigee) Actualiza el SSO de Apigee:
- Máquina 1 en el centro de datos 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
- Máquina 7 en el centro de datos 2:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
Donde sso_config_file es el archivo de configuración que creaste cuando instalaste el SSO.
- Máquina 1 en el centro de datos 1:
- Reinicia el componente de la IU de Edge nueva (
edge-management-ui) o de la IU de Edge clásica (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:
- ZooKeeper
- Cassandra
- ps
- LDAP
- Edge, es decir, el perfil "-c edge" en todos los nodos en el orden: nodos con el servidor de Qpid, Edge Postgres Server, Management Server, Message Processor y Router.
- qpidd
- IU de Edge (clásica o nueva)
apigee-adminapi- 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.