Actualiza Apigee Edge 4.51.00 o 4.52.00 o 4.52.01 a 4.52.02

Apigee admite la actualización de Edge para la nube privada directamente desde las versiones 4.51.00, 4.52.00 o 4.52.01 a la versión 4.52.02. En esta página, se describe cómo realizar esas actualizaciones.

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

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 realizar la actualización, te recomendamos que crees una copia de seguridad completa de todos los nodos por motivos de seguridad. Usa el procedimiento para tu versión actual de Edge para realizar la copia de seguridad.

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

  • 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
  • Asegúrate de que la estrategia de compactación de Cassandra sea LeveledCompactionStrategy
    Según tu versión actual, realiza los cambios necesarios en la estrategia de compactación de Cassandra. Sigue los pasos que se indican a continuación y, luego, regresa al procedimiento principal de actualización:

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

Para actualizar a Edge para la nube privada 4.52.02, 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 distintos 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.

Versión actual Software que requiere pasos especiales para actualizar a la versión 4.52.02
4.52.01 Cassandra
4.52.00 Zookeeper, Cassandra, Qpid
4.51.00 Zookeeper, Postgres, Cassandra, Qpid

Después de realizar los pasos necesarios según tu versión, vuelve 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, esos valores se conservarán después de la actualización.

Actualiza a Zookeeper 3.8.3

Edge para la nube privada 4.52.02 no incluye una actualización de Zookeeper. Sin embargo, si actualizas desde una versión anterior a la 4.52.01, debes seguir los pasos de actualización de ZooKeeper que se describen a continuación.

  • Si actualizas desde las versiones 4.51.00 o 4.52.00 de Edge para la nube privada, consulta los pasos en Actualización obligatoria a Zookeeper 3.8.3 para actualizar Zookeeper.
  • Si actualizas desde la versión 4.52.01 de Edge para nubes privadas, ya deberías estar usando la versión 3.8.3 de Zookeeper, por lo que no necesitas seguir ningún paso especial para actualizar Zookeeper.

Actualiza a Postgres 14

  • Si actualizas de Edge para nubes privadas 4.51.00 a 4.52.02, debes seguir los pasos para actualizar Postgres, aunque Edge para nubes privadas 4.52.02 no incluya una actualización de Postgres. La actualización de Edge para la nube privada de la versión 4.51.00 a la 4.52.02 requiere pasos adicionales de actualización de Postgres. Consulta la sección Actualización obligatoria a Postgres 14.
  • Si actualizas Edge para la nube privada de la versión 4.52.00 o 4.52.01 a la 4.52.02, no se requieren pasos adicionales de actualización de Postgres.

Actualiza a Cassandra 3.11.16

Apigee Edge para la nube privada 4.52.02 incluye una actualización de Cassandra a la versión 3.11.16. Cassandra es un componente fundamental de Apigee, y esta actualización también incluye actualizaciones del software del controlador en varios componentes de administración y entorno de ejecución que se usan para consultar y escribir en Cassandra.

Dado que se trata de una actualización importante, fue necesario realizar ciertos cambios en el modelo de datos de Apigee en Cassandra para garantizar un rendimiento óptimo en las versiones más recientes. Si bien estos cambios son mínimos, el proceso de actualización interrumpe ciertas APIs de administración cuando se inicia la actualización. Las APIs de administración exactas que se interrumpen generalmente se enumeran en las secciones pertinentes a continuación.

Además, el proceso de actualización interrumpe un conjunto más grande de flujos de proxy de entorno de ejecución y APIs de administración en el centro de datos que se está actualizando. Es fundamental que aísles el tráfico de administración y de tiempo de ejecución del centro de datos que se está actualizando para minimizar las interrupciones. Para obtener más información, lee las secciones sobre un solo centro de datos y varios centros de datos a continuación.

Portal para desarrolladores: Documentación de APIs

El portal para desarrolladores de Apigee Drupal ofrece varias funciones para documentar tus APIs. Si bien se recomienda dejar de usar el portal para desarrolladores basado en Drupal 7, si aún lo usas y aprovechas su función de SmartDocs, se te aplica el documento Uso de las APIs de SmartDocs. Si usas versiones más recientes del portal para desarrolladores, esta actualización no afectará la documentación de la API.

Cuando actualices Apigee a la versión 4.52.02, los modelos de API creados con la función SmartDocs del portal para desarrolladores de Drupal 7 no se migrarán automáticamente a la versión más reciente. Se espera que exportes cada modelo de forma manual con el portal para desarrolladores y que lo importes nuevamente después de completar la actualización.

Terminología que se usa a continuación

Tiempo de ejecución: El tiempo de ejecución abarca el control del tráfico de tu proxy de tiempo de ejecución. Incluye todas las operaciones que realizan tus routers y procesadores de mensajes para procesar de manera eficaz una solicitud de API de tiempo de ejecución para los proxies existentes. Sin embargo, no incluye la implementación de proxies nuevos ni de revisiones nuevas de proxies.

Administración: La administración incluye la administración de tu sistema de Apigee Edge. Esto incluye, sin limitaciones, implementaciones, modificaciones de apps, productos, servidores de destino, almacenes de claves, etcétera. Todas las APIs de administración (y sus clientes, como la IU de Apigee y el portal para desarrolladores) se incluyen en este alcance.

Durante esta actualización, el tráfico de administración y de tiempo de ejecución se ve afectado en la región o el centro de datos (CD) en el que se ejecuta la actualización. Independientemente del centro de datos que se actualice, ciertas APIs de administración se verán afectadas en todos los centros de datos. Este impacto se indica después de cada paso.

En cada paso a continuación, se describe el estado del tiempo de ejecución y la administración a medida que avanzas por las distintas etapas del procedimiento de actualización.

Estrategias de actualización

Varios centros de datos

La actualización se debe realizar un centro de datos a la vez para garantizar la continuidad del tráfico y evitar el tiempo de inactividad. Antes de actualizar un DC, el tráfico debe redireccionarse a otros DC funcionales.

Un solo centro de datos

En el caso de una configuración de un solo centro de datos, el procedimiento de actualización tendrá un impacto significativo en el tráfico del entorno de ejecución y en ciertas APIs de administración. Las siguientes opciones están disponibles para una configuración de un solo centro de datos.

  • Expande tu clúster de Edge para la nube privada a un centro de datos temporal agregando un centro de datos junto al existente para controlar el tráfico durante la actualización y, luego, desactiva uno de los centros de datos cuando se complete el proceso de actualización.
  • Si no puedes expandirte a un centro de datos adicional, prepárate para el tiempo de inactividad y programa la actualización durante los períodos de poco tráfico para minimizar el impacto en las APIs de administración y el tráfico del entorno de ejecución.

Se recomienda expandirse a un centro de datos adicional para evitar el impacto en el tráfico del tiempo de ejecución y las APIs de administración. Durante la actualización, los impactos en el centro de datos que se actualiza incluyen, entre otros, los siguientes aspectos:

  • APIs de Runtime que actualizan tokens de OAuth
  • APIs de Runtime que usan la política de entidades de acceso
  • APIs de administración que muestran las apps para desarrolladores
  • APIs de administración que muestran productos

El impacto descrito anteriormente se suma a las APIs de administración específicas que seguirán sin funcionar en todos los centros de datos hasta que se actualicen. Estas APIs de administración se enumeran en los pasos de las secciones posteriores.

Reversión: Nivel general

  • Impacto durante la reversión

    La reversión de Cassandra 3.11.x a 2.1.x afecta el tráfico de administración y de tiempo de ejecución dentro del centro de datos (CD) en el que se realiza la reversión. Además, es posible que algunas APIs de administración experimenten interrupciones en todos los centros de datos, independientemente del CD que se esté revirtiendo.

  • Sigue el enfoque de reversión de DC en DC

    La reversión debe ejecutarse en un centro de datos a la vez para mantener la continuidad del servicio y evitar el tiempo de inactividad. Antes de iniciar la reversión en un centro de datos específico, asegúrate de que el tráfico de la aplicación se redireccione a otro centro de datos que funcione correctamente.

  • Cómo revertir un clúster actualizado parcialmente

    Si al menos un centro de datos sigue funcionando por completo en la versión anterior de Cassandra (2.1.22), se pueden revertir otros centros de datos actualizados realizando una recompilación desde el centro de datos de Cassandra 2.1.X que funciona por completo.

  • Reversión en todo el clúster

    Si se actualizó todo el clúster de Cassandra y se requiere una reversión, esta se debe realizar con copias de seguridad o instantáneas de VM. Este enfoque es complejo y es probable que provoque un tiempo de inactividad temporal o pérdida de datos.

  • Consideraciones previas a la actualizació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.

Revertir clústeres con un solo centro de datos

La actualización de Cassandra de la versión 2.1.x a la 3.11.x puede afectar significativamente el tráfico del entorno de ejecución y ciertas APIs de administración. Estos impactos también se aplican durante la reversión y pueden provocar tiempo de inactividad o pérdida de datos.

Para las cargas de trabajo de producción, se recomienda aprovisionar un centro de datos nuevo antes de la actualización. Esto permite una reversión más segura sin pérdida de datos ni interrupciones en el tráfico de la API. El centro de datos adicional se puede dar de baja después de que se complete la actualización correctamente.

Si no es factible agregar un nuevo centro de datos, pero aún se requiere la capacidad de reversión, asegúrate de que se tomen copias de seguridad confiables antes de la actualización. Es posible restablecer Cassandra 2.1.x a partir de copias de seguridad, pero este enfoque puede implicar tiempo de inactividad del servicio y posible pérdida de datos.

Revertir clústeres con varios centros de datos

La reversión de varios centros de datos sigue un enfoque de centro de datos por centro de datos (CD por CD). Con este enfoque, el tráfico del centro de datos que se revierte se redirecciona a otros centros de datos funcionales, lo que garantiza un proceso de reversión controlado y aislado para Cassandra, el servidor de administración y los nodos de tiempo de ejecución para evitar interrupciones del tráfico.

Consulta la sección Cómo revertir la actualización de Cassandra 3.11.16 para obtener más detalles.

Paso 0: Estado inicial

  • Los componentes de Zookeeper, Postgres y LDAP ya se actualizaron a las versiones 4.52.02. Tu Edge para un clúster de nube privada es estable y funciona. Si se requiere una reversión, el clúster se revertirá a este estado.
  • Cassandra en Apigee se ejecuta con la versión 2.1.22.
  • Componentes de Edge:
    • El servidor de administración se comunica con Cassandra a través de un protocolo Thrift anterior.
    • Los servidores de tiempo de ejecución (procesadores de mensajes y routers) se comunican con Cassandra a través de un protocolo Thrift anterior.
Estado del tiempo de ejecución en esta etapa Estado de administración en esta etapa
El tiempo de ejecución funciona correctamente La administración funciona correctamente

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. Cambia Cassandra para que use LeveledCompactionStrategy.
  2. Crea una copia de seguridad de Cassandra con Apigee.
  3. Toma instantáneas de VM de los nodos de Cassandra (si es posible).
  4. Crea un archivo de configuración de actualización de Cassandra en cada nodo de Cassandra en /opt/apigee/apigee-cassandra/cass_upgrade.conf con el siguiente contenido: 
    # IP Address of node
HOSTIP=10.0.0.1

# Username for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_USERNAME=<cassuser>

# Password for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_PASSWORD=<casspass>

# Port for connecting to Cassandra via thrift. Optional. Defaults to 9160 if skipped.
CASS_PORT=9160

# Port for connecting to Cassandra via CQL. Optional. Defaults to 9042 if skipped.
CASS_CQL_PORT=9042

# Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped.
# Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly.
CASS_TMP_DIR=/tmp/cass_upgrade_scripts
    Si no se puede crear el archivo en /opt/apigee/apigee-cassandra/cass_upgrade.conf, crea el archivo /opt/silent.conf con el mismo contenido en cada nodo de Cassandra.
  5. Si usas la función SmartDocs del portal para desarrolladores de Apigee Drupal 7, exporta cada uno de tus modelos descargándolos en formato JSON desde la IU del portal para desarrolladores. Estos modelos deberán importarse nuevamente a Apigee después de que se actualicen los servidores de administración.
  6. Asegúrate de que se pueda acceder a los puertos 9160 y 9042 desde todos los componentes de Edge a los nodos de Cassandra si aún no están presentes. Consulta los requisitos de puertos para obtener más información.

Paso 2: Redirige el tráfico lejos del primer centro de datos

  1. Bloquea el tráfico de administración y de tiempo de ejecución entrante desde el primer centro de datos.
  2. Redirige todo el tráfico del entorno de ejecución y las APIs de administración a los otros centros de datos funcionales.
  3. Valida que el tráfico de administración y de tiempo de ejecución se controle correctamente en los demás centros de datos.

Paso 3: Actualiza todos los nodos de Cassandra en el primer centro de datos

  1. Actualiza todos los nodos de Cassandra en el centro de datos 1 de a uno. Ejecuta los siguientes comandos en cada nodo uno por uno: 
    /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
     El comando anterior generará un resultado similar al siguiente: 
    Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified
  3. Ejecuta el siguiente comando post_upgrade 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
Estado del tiempo de ejecución en esta etapa Estado de administración en esta etapa
  • Se bloqueó el tráfico del tiempo de ejecución en los centros de datos que se están actualizando
  • El tiempo de ejecución funciona correctamente en otros centros de datos

Paso 4: Actualiza todos los nodos de administración en el primer centro de datos

Actualiza todos los nodos de administración en el centro de datos:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Estado del tiempo de ejecución en esta etapa Estado de administración en esta etapa
  • Se bloqueó el tráfico del tiempo de ejecución en los centros de datos que se están actualizando
  • El tiempo de ejecución funciona correctamente

Paso 5: Actualiza todos los nodos de tiempo de ejecución en el primer centro de datos

Actualiza todos los nodos de Router y Message Processor del centro de datos uno por uno:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Estado del tiempo de ejecución en esta etapa Estado de administración en esta etapa
  • Se bloqueó el tráfico del tiempo de ejecución en los centros de datos que se están actualizando
  • El tiempo de ejecución funciona correctamente en otros centros de datos

Paso 6: Redirige el tráfico al primer centro de datos

  • Una vez que se actualice el primer centro de datos con Cassandra, los componentes del entorno de ejecución y el servidor de administración, vuelve a habilitar el tráfico del entorno de ejecución y de administración hacia el primer centro de datos.
  • Asegúrate de que el tráfico de administración y de tiempo de ejecución se realice correctamente en todos los centros de datos.

Paso 7: Actualiza otros centros de datos

Repite los pasos del 1 al 6 en los centros de datos restantes, uno a la vez, redireccionando el tráfico lejos de esos centros de datos, actualizando el software de Apigee y volviendo a habilitar el tráfico en esos centros de datos.

Paso 8: Vuelve a ejecutar el paso de actualización en todos los nodos de administración

Vuelve a ejecutar el siguiente comando de actualización en todos los nodos de administración de los centros de datos:

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

Paso 9: [Opcional] Importa los smartdocs que se exportaron anteriormente

Una vez que se actualicen todos los servidores de administración, podrás importar los modelos de Smart Docs que exportaste en el paso 1. Puedes decidir hacerlo más adelante.

Solo debes hacerlo si usas el portal para desarrolladores basado en Drupal 7 y la función smartdocs.

Estado del tiempo de ejecución en esta etapa Estado de administración en esta etapa
El tiempo de ejecución funciona correctamente La administración funciona correctamente

Paso 10: Descarta las tablas que no se usan

Ejecuta el siguiente comando para quitar las tablas antiguas no utilizadas del clúster de Cassandra. Hasta que se ejecute, no podrás usar ciertas funciones de Cassandra (como configurar una nueva autenticación; los mecanismos de autenticación antiguos seguirán funcionando). Este comando solo se puede ejecutar en un nodo del clúster.

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile

Paso 11: Actualiza todos los componentes restantes de Edge y otros componentes para la versión 4.52.02 de Private Cloud

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

En esta etapa, si actualizas desde versiones anteriores a Edge para Private Cloud 4.52.01, como se muestra a continuación, debes seguir pasos adicionales para actualizar Qpid y Postgres, respectivamente, y actualizar los componentes restantes según estos pasos.

Actualiza a Qpid J-Broker

Aunque Edge para Private Cloud 4.52.02 no incluye una actualización a Qpid, si actualizas desde versiones anteriores a la 4.52.01, debes seguir los pasos para actualizar QPID.

  • Si actualizas Edge para la nube privada de la versión 4.51.00 o 4.52.00 a la 4.52.02, es necesario que sigas pasos adicionales para actualizar Qpid. Consulta la sección Actualiza Qpid si actualizas desde la versión 4.51.00 o 4.52.00 a la 4.52.02.
  • Si actualizas de Edge para Private Cloud 4.52.01 a 4.52.02, ya deberías estar usando la versión más reciente de Qpid Broker, por lo que no son necesarios pasos adicionales de Qpidupgrade.

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.

Actualiza la IU de Edge

Para actualizar el componente de la IU de Edge, ten en cuenta la versión de Edge para la nube privada desde la que realizas la actualización:

Actualización con mTLS de Apigee

Para actualizar Apigee mTLS , sigue estos pasos:

Revierte una actualización

En caso de que falle una actualización, puedes intentar corregir el problema y, luego, 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.52.00 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 no tienes acceso a /tmp, la utilidad update.sh fallará.

Actualización sin tiempo de inactividad

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

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

La clave para 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 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 Message Processor 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:

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 4.50.00 o 4.51.00.

Actualización a la versión 4.52.02 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. Instala yum-utils y yum-plugin-priorities: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  4. Inhabilita SELinux como se describe en Instala la utilidad apigee-setup de Edge.
  5. Si realizas la instalación en Oracle 7.x, ejecuta el siguiente comando: 
    sudo yum-config-manager --enable ol7_optional_latest
  6. 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

  7. Si actualmente usas Edge 4.51.00, sigue estos pasos:

    1. Descarga el archivo bootstrap_4.52.02.sh de Edge en /tmp/bootstrap_4.52.02.sh: 
      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
    2. Instala la utilidad apigee-service y las dependencias de Edge 4.52.02 ejecutando el siguiente comando: 
      sudo bash /tmp/bootstrap_4.52.02.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 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 la versión 4.50.00 o 4.51.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.52.02.

Actualización a la versión 4.52.02 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 una duplicación del repositorio de Apigee.#heading

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.52.02, haz lo siguiente:

  1. Crea un repo local 4.52.02 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.52.02.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.52.02.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.52.02.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.52.02.sh de Edge en /tmp/bootstrap_4.52.02.sh: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh

      Aquí, 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.52.02.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      donde 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 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 la versión 4.50.00 o 4.51.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.52.02.

Orden de actualización de la máquina: Actualización de 4.51.00 (o) 4.52.00 (o) 4.52.01

El orden en el que actualizas las máquinas en una instalación de Edge es importante:

  • Debes actualizar todos los nodos de ZooKeeper en los centros de datos antes de actualizar todos los demás componentes. Si actualizas desde Edge Private Cloud 4.51.00 (o) 4.52.00, también deberás seguir pasos adicionales para actualizar Zookeeper.
  • Debes actualizar Postgresql en todos los centros de datos. Si actualizas desde Edge Private Cloud 4.51.00, también deberás seguir pasos adicionales para actualizar postgres.
  • Debes actualizar los nodos LDAP en todos los centros de datos.
  • Debes actualizar todos los nodos de Cassandra, el servidor de administración, el procesador de mensajes y el router, un centro de datos a la vez, hasta que se actualicen todos los centros de datos.
  • Debes actualizar los componentes edge-qpid-server y edge-postgres-server en todos los centros de datos.
  • Debes actualizar los nodos de Qpid en todos los centros de datos. Si actualizas desde Edge Private Cloud 4.51.00 (o) 4.52.00, también deberás seguir pasos adicionales para actualizar Qpid.
  • Se actualizaron la IU de Edge y la nueva IU de Edge, y los nodos de SSO en todos los centros de datos.
  • 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

Para actualizar una configuración independiente de 1 nodo a la versión 4.52.02, haz lo siguiente:
  1. Actualiza todos los componentes: 
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (Si instalaste apigee-adminapi) Se actualizó la utilidad de 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 Zookeeper en la máquina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. Actualiza Postgres en la máquina 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Actualiza LDAP en la máquina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Actualiza Cassandra en la máquina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  5. Actualiza los componentes de Edge en las máquinas 1 y 2: 
    /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 ZooKeeper en las máquinas 1, 2 y 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c 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 LDAP en la máquina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Actualiza Cassandra en las máquinas 1, 2 y 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. Actualiza los componentes de Edge en las máquinas 1, 2, 3, 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 de 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 ver la lista de topologías de Edge y números de nodos.

  1. Actualiza ZooKeeper en las máquinas 1, 2 y 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c 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 LDAP en la máquina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Actualiza Cassandra en las máquinas 1, 2 y 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. Actualiza los componentes de Edge en las máquinas 1, 4, 5, 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 de 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 ver la lista de topologías de Edge y números de nodos.

  1. Actualiza ZooKeeper en las máquinas 1, 2 y 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c 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 LDAP en las máquinas 4 y 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Actualiza Cassandra en las máquinas 1, 2 y 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. Actualiza los componentes de Edge en las máquinas 6, 7, 10, 11, 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 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 ver la lista de topologías de Edge y números de nodos.

  1. Actualiza ZooKeeper en las máquinas 1, 2, 3, 7, 8 y 9 en ambos centros de datos:

    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. Actualiza Postgres en las máquinas 6 y 12 en ambos centros de datos: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Actualiza LDAP en las máquinas 1 y 7 en ambos DCs: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

  4. Bloquea el tráfico en DC-1 y asegúrate de que todo el tráfico se redireccione a otro DC-2.

  5. Actualiza Cassandra en las máquinas 1, 2 y 3 de DC-1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. Actualiza el servidor de administración en la máquina 1 de DC-1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Actualiza el router y el Message Processor en las máquinas 2 y 3 de DC-1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. Desbloquea el tráfico en DC-1, valida DC-1 y continúa con DC-2 bloqueando el tráfico en DC-2 y redireccionando el tráfico a DC-1.
  9. Actualiza Cassandra en las máquinas 7, 8 y 9 de DC-2: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  10. Actualiza el servidor de administración en la máquina 7 de DC-2: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. Actualiza el router y el Message Processor en las máquinas 8 y 9 de DC-2: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. Desbloquea el tráfico en DC-2 y, ahora, ambos centros de datos controlarán el tráfico.
  13. Vuelve a ejecutar el comando de actualización en todos los servidores de administración de las zonas de disponibilidad en las máquinas 1 y 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  14. Actualiza edge-qpid-server y edge-postgres-server en las máquinas 4, 5, 6, 10, 11 y 12 en ambos centros de datos: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  15. Actualiza Qpid en las máquinas 4, 5, 10 y 11 en ambos centros de datos: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  16. Actualiza la IU nueva (ue) o la IU clásica (ui) en ambos centros de datos: 
    /opt/apigee/apigee-setup/bin/update.sh -c  [ui|ue] -f configFile
  17. (Si instalaste apigee-adminapi) Actualiza apigee-adminapi en ambos centros de datos: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  18. (Si instalaste Apigee SSO) Actualiza los nodos de Apigee SSO en ambos centros de datos: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  19. Reinicia el componente de la nueva IU de Edge (edge-management-ui) o de la IU clásica de Edge (edge-ui) en ambos centros de datos: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart