Actualiza Apigee Edge de la versión 4.52.02 a la 4.53.00

Apigee admite la actualización de Edge para la nube privada directamente de la versión 4.52.02 a la versión 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 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 ejecute el comando como root.

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

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

• Crea una copia de seguridad de todos los nodos
  Antes de actualizar, te recomendamos que crees una copia de seguridad completa de todos los nodos por motivos de seguridad. Usa el procedimiento de la versión actual de Edge para crear la copia de seguridad.

  Esto te permite tener un plan de respaldo en caso de que la actualización a una versión nueva no funcione correctamente. Para obtener más información sobre las copias de seguridad, consulta Copia de seguridad y restablecimiento.

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

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

• Verifica los requisitos previos de Cassandra
  Si anteriormente actualizaste de 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.00, asegúrate de haber completado los pasos obligatorios posteriores a la actualización para Cassandra. Estos pasos se describen en la documentación de actualización a la versión 4.52.02 en Pasos posteriores a la actualización. Si no sabes si estos pasos se completaron durante la actualización anterior, vuelve a hacerlos antes de continuar con la actualización a la versión 4.53.00.
• 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 la propiedad

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

Actualización obligatoria a Cassandra 4.0.13

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

Actualizaciones y reversiones

• 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 for Private Cloud 4.53.00, es compatible con los componentes de tiempo de ejecución y administración de Private Cloud 4.52.02.
• No es posible realizar una reversión directa en el lugar 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 problemas y actualizar a Cassandra 4.0.X en lugar de revertir la versión.
• Es importante que te familiarices con los procedimientos de reversión antes de intentar la actualización. Es fundamental tener en cuenta los matices de la reversión durante la actualización 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 fluida, 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 habilitará la reversión de Cassandra sin incurrir en pérdida de datos ni interrupciones en el tráfico de tu API. Este centro de datos adicional se puede dar de baja una vez que se complete la actualización o se alcance el punto de control 2.

Si no es posible agregar un nuevo centro de datos, 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

La operación de 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 Cassandra 3.11.X. Debes seguir usando la versión más reciente de Cassandra con los otros componentes de la nube privada 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 en 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. Pausar y validar: 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. Agotamiento del tiempo: Si bien puedes pausar la implementación durante un período breve (se recomiendan algunas horas) para validar la funcionalidad, no puedes permanecer en un estado de versión mixta de forma indefinida. Esto se debe a que un clúster de Cassandra no uniforme (con nodos en diferentes versiones) tiene limitaciones operativas.
5. Pruebas exhaustivas: Apigee recomienda realizar pruebas exhaustivas de rendimiento y funcionalidad antes de actualizar el siguiente centro de datos. Una vez que se actualizan todos los centros de datos, es imposible revertir a la versión anterior.

Reversión como un proceso de dos puntos de control

1. Punto de control 1: El estado inicial, con todos los componentes en la versión 4.52.02. La reversión completa es posible, siempre y cuando al menos un centro de datos de Cassandra permanezca en la versión anterior.
2. Punto de control 2: Después de actualizar todos los nodos de Cassandra en todos los centros de datos. Puedes revertir a este estado, pero no puedes volver al punto de control 1.

Ejemplo

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

1. Estado inicial: Los nodos de Cassandra en ambas DCs 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 for Private Cloud. Supongamos 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. Detén y valida: Detén el clúster, en particular el DC-1, para asegurarte de que funcione correctamente (verifica el rendimiento y la funcionalidad). Puedes revertir al estado inicial con los nodos de Cassandra en el DC-2. Recuerda que esta pausa debe ser temporal debido a las limitaciones de un clúster de Cassandra de versión mixta.
4. Actualiza DC-2: Actualiza los tres nodos de Cassandra restantes 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 estadísticas como de costumbre en todos los centros de datos, uno 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 funciona completamente 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).
• Se completaron todos los pasos posteriores a la actualización de la actualización inicial a Cassandra 3.11.16 como parte de la actualización a 4.52.02. De lo contrario, vuelve a ejecutar estos pasos. Esto se aplica solo si actualizaste a la versión 4.52.02 de Private Cloud desde una versión anterior.

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.

1. Crea una copia de seguridad de Cassandra con Apigee.
2. Crea 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 la nube privada, incluidos el servidor de administración, el procesador de mensajes, el router, Qpid y Postgres, a los nodos de Cassandra si aún no están configurados. Consulta los requisitos de los puertos para obtener más información.

Paso 2: Actualiza todos los nodos de Cassandra

Todos los nodos de Cassandra se deben actualizar uno por uno en cada centro de datos, un centro de datos a la vez. Entre las actualizaciones de 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 algunas horas) antes de continuar con los nodos del siguiente centro de datos. Durante este tiempo, revisa en detalle el centro de datos que se actualizó y asegúrate de que las métricas funcionales y de 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 Cassandra se actualizó 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 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

3. Lo anterior mostrará un resultado similar al siguiente:

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

Paso 3: Actualiza todos los nodos de administración

Actualiza todos los nodos de administración en todas las regiones de uno en 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 procesadores de mensajes en todas las regiones de uno en 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.00

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

Paso 6: Pasos posteriores a la actualización

Ejecuta el siguiente comando en cada nodo de Cassandra uno por uno después de que se complete la actualización:

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

IU de Edge nuevo

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 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 Cómo instalar la nueva IU de Edge.

Actualiza con mTLS de Apigee

Para actualizar mTLS de Apigee , sigue estos pasos:

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

Revierte una actualización

En caso de que se produzca un error de 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 la última vez.

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

Información de actualización de registro

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

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

Si la persona que ejecuta la utilidad update.sh no tiene acceso a ese directorio, el registro se escribe 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 cerrarlo.

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

La clave para realizar la actualización 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 agregarlo 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 máquinas.
2. Cuando llegue el momento de actualizar los routers, selecciona uno y haz que no se pueda acceder a él, como se describe en Habilitación o inhabilitación de 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 de 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 procesador de mensajes:
  • Antes de la actualización, haz lo siguiente:
    1. Hacer que el router no sea accesible
    2. Hacer que el procesador de mensajes no sea accesible
  • Después de la actualización, haz lo siguiente:
    1. Haz que se pueda acceder al procesador de mensajes.
    2. Haz que el router sea accesible.
• En nodos de router individuales:
  • Antes de la actualización, haz que el router no sea accesible.
  • Después de la actualización, asegúrate de que se pueda acceder al router.
• En nodos de Message Processor únicos:
  • Antes de la actualización, haz que el procesador de mensajes no sea accesible.
  • Después de la actualización, asegúrate de que se pueda acceder al procesador de mensajes.

Usa un archivo de configuración silencioso

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

Actualiza a la versión 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:

1. Si está presente, inhabilita cualquier trabajo de cron configurado para realizar una operación de reparación en Cassandra 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 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 más adelante decides revertir la actualización, usa el procedimiento que se describe en Cómo revertir 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, no pueden acceder al repositorio de Apigee a través de Internet, puedes realizar la actualización desde un repositorio local o espejo 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, cópialo 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 bien puedes usar tu propio servidor web.

Para actualizar desde un repositorio local 4.53.00, haz lo siguiente:

1. Crea un repositorio local 4.53.00 como se describe en "Crea un repositorio de Apigee local" 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 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

   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.00.tar.gz

      Este comando crea un directorio nuevo, llamado repos, en el directorio que contiene el archivo .tar. Por ejemplo, /tmp/repos.

   4. Instala la utilidad apigee-service y las dependencias de Edge desde /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 de repositorios en este comando.

3. Para instalar apigee-service con el servidor web Nginx, sigue estos pasos:
   1. Configura el servidor web Nginx como se describe en "Install from the repo using the Nginx webserver" en Install the Edge utility apigee-setup.
   2. En el nodo remoto, descarga el archivo bootstrap_4.53.00.sh de Edge a /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

      En el que uName:pWord son el nombre de usuario y la contraseña que estableciste anteriormente para el repositorio, y remoteRepo es la dirección IP o el nombre de DNS del nodo del repositorio.

   3. En el nodo remoto, instala la utilidad apigee-setup y las dependencias de Edge:

      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.

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

   Aquí:

   • 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: servidor de administración, procesador de mensajes, router, servidor QPID y servidor Postgres
     • ldap: OpenLDAP
     • ps: postgresql
     • qpid: qpidd
     • sso: SSO de Apigee (si instalaste el SSO)
     • ue IU de Edge nuevo
     • ui: IU clásica de Edge
     • zk: Zookeeper
   • configFile es el mismo archivo de configuración que usaste para definir tus componentes de Edge durante la instalación de 4.50.00 o 4.51.00.

   Para ejecutar update.sh en todos los componentes, configura component como "todo", 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. 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

9. Para probar la actualización, ejecuta la utilidad apigee-validate en el servidor de administración, como se describe en Cómo probar 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.00.

Orden de actualización de la máquina

El orden en 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 (servidor de administración, procesador de mensajes, router, servidor QPID, pero no servidor de Postgres), usa la opción -c edge para 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, haz lo siguiente:

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

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

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

2. Actualiza Postgres en la máquina 2:

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

3. Actualiza el LDAP en la máquina 1:

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

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

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

5. Actualiza Qpid en la máquina 2:

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

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

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

7. (Si instalaste apigee-adminapi) Se actualizó la utilidad apigee-adminapi en la máquina 1:

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

8. (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

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

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

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

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

2. Actualiza Postgres en la máquina 4:

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

3. Actualiza Postgres en la máquina 5:

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

4. Actualiza el LDAP en la máquina 1:

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

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

6. Actualiza Qpid en la máquina 4:

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

7. Actualiza Qpid en la máquina 5:

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

8. 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 adecuada (es posible que no sea la máquina 1):

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

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

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

10. (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

    En el que 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 adecuada (es posible que no sea la máquina 1):

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

Actualización del clúster de 9 nodos

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

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

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

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

2. Actualiza Postgres en la máquina 8:

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

3. Actualiza Postgres en la máquina 9:

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

4. Actualiza el LDAP en la máquina 1:

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

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

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

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

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

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

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

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

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

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

10. 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 adecuada (es posible que no sea la máquina 1):

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

Actualización del clúster de 13 nodos

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

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

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

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

2. Actualiza Postgres en la máquina 8:

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

3. Actualiza Postgres en la máquina 9:

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

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

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

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

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

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

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

8. (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

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

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

10. 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 del clúster de 12 nodos

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

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

1. Actualiza Cassandra y ZooKeeper:
   1. 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

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

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

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

4. Actualiza los componentes de Edge:
   1. 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

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

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

6. Actualiza la IU nueva (ue) o la 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

7. (Si instalaste apigee-adminapi) Actualizaste 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

8. (Si instalaste el SSO de Apigee) Actualiza el SSO de Apigee:
   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

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

9. Reinicia el componente de la IU de Edge nueva (edge-management-ui) o 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:

1. ZooKeeper
2. Cassandra
3. ps
4. LDAP
5. Edge, es decir, el perfil "-c edge" en todos los nodos en el orden: nodos con servidor Qpid, servidor Postgres de Edge, servidor de administración, procesador de mensajes y router.
6. qpidd
7. IU de Edge (clásica o nueva)
8. apigee-adminapi
9. 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.