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 de 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 la persona que se ejecuta como administrador.

Después de instalar los RPM de Edge, cualquiera 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.

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

    Esto te permite tener un plan de copia de seguridad en caso de que la actualización a una nueva versión 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é funcionando 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
    Asegúrate de que la estrategia de compactación de Cassandra esté configurada en LeveledCompactionStrategy, como se describe en Cómo cambiar la estrategia de compactación de Cassandra.

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

Si quieres actualizar a Edge for Private Cloud 4.52.02, considera ejecutar pasos específicos para actualizar cierto software. Los pasos necesarios dependen de la versión actual. Consulta la tabla a continuación para conocer los distintos software que requieren pasos complementarios. Las secciones posteriores de esta página proporcionan debates detallados y pasos exactos para cada software.

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

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

Si configuraste alguna propiedad mediante la edición de archivos .properties en /opt/apigee/customer/application, la actualización conservará estos valores.

Actualización obligatoria a Cassandra 3.11.16

Apigee Edge for Private Cloud 4.52.02 incluye una actualización de Cassandra a la versión 3.11.16. Cassandra es un componente fundamental de Apigee. Esta actualización también incluye actualizaciones para el software del controlador en varios componentes de entorno de ejecución y administración que se usan para realizar consultas y escribir en Cassandra.

Como se trata de una actualización importante, se necesitaron ciertos cambios en el modelo de datos de Apigee en Cassandra para garantizar un rendimiento óptimo en versiones más recientes. Aunque estos cambios son mínimos, el proceso de actualización interrumpe ciertas APIs de administración, lo que afecta tanto a la IU de Apigee como al portal para desarrolladores. En el siguiente documento, se especifican las APIs exactas que no funcionarán y se describen los pasos que se deben seguir durante la actualización, cuando comience y finalice la interrupción. Es importante destacar que no debería haber interrupciones en el tráfico del entorno de ejecución durante la actualización.

Reversión de alto nivel

Aplicar Cassandra actualiza un nodo a la vez. Tan pronto como se actualiza un nodo, se aplican ciertos cambios de esquema que no se pueden revertir directamente. Lee a fondo la sección sobre reversión, ya que se pueden usar diferentes técnicas según la cantidad del clúster que se haya actualizado.

Si necesitas revertir la actualización después de actualizar todo el clúster de Cassandra, la única opción es restablecer las copias de seguridad. Prepárate para esto y familiarízate con la restauración de copias de seguridad de Cassandra. Si puedes restablecer las instantáneas a nivel de la VM más rápido que las copias de seguridad de Apigee, usa las instantáneas de VM para restablecer las VMs de Cassandra a un estado anterior.

Para obtener más información, consulta la sección Revierte la actualización de Cassandra 3.11.16.

Cómo documentar las APIs en el portal para desarrolladores

El portal para desarrolladores de Drupal de Apigee ofrece varias funciones para documentar tus APIs. Si bien se recomienda dejar de usar el portal para desarrolladores basado en Drupal 7, si todavía lo utiliza y utiliza su función SmartDocs, el documento Cómo usar las APIs de SmartDocs se aplica en su caso. Si estás usando versiones más recientes del portal para desarrolladores, no se verá afectado la documentación de tu API durante esta actualización.

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 migrarán automáticamente a la versión más reciente. Se espera que exportes manualmente cada modelo a través del portal para desarrolladores y que lo vuelvas a importar después de completar la actualización.

Terminología que se usa en las siguientes secciones

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

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

En cada paso que aparece a continuación, el estado del entorno de ejecución y la administración se describen a medida que avanzas por las distintas etapas del procedimiento de actualización. Ten en cuenta que el tráfico del entorno de ejecución no se verá afectado durante la actualización. Sin embargo, hay interrupciones en un pequeño subconjunto de APIs de administración y en la funcionalidad del portal para desarrolladores.

Paso 0: Estado de inicio

  1. Cassandra en Apigee que se ejecuta con la versión 2.1.22.
  2. Edge para componentes de la nube privada 4.52.02:
    • Un servidor de administración que se comunica con Cassandra a través del protocolo de ahorro anterior
    • Servidores de tiempo de ejecución (procesadores de mensajes y routers) que se comunican con Cassandra a través de un protocolo de ahorro antiguo.
Estado del entorno de ejecución en esta etapa Estado de administración en esta etapa
Entorno de ejecución completamente funcional Administración completamente funcional

Paso 1: Prepárate para la actualización

Los siguientes pasos se agregan 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 a Cassandra para que use LeveledCompactionStrategy.
  2. Crear copias de seguridad de Cassandra con Apigee
  3. Crear 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 el archivo no se puede crear en /opt/apigee/apigee-cassandra/cass_upgrade.conf, crea el archivo /opt/silent.conf con el mismo contenido en cada nodo de Cassandra.
  • 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 volver a importarse a Apigee después de que se actualicen los servidores de administración.
  • Asegúrate de que se pueda acceder a los puertos 9160 y 9042 desde todos los componentes de Edge para la nube privada 4.52.02 a los nodos de Cassandra si aún no están presentes. Consulta los requisitos de puerto para obtener más información.

Paso 2: Actualiza todos los nodos de Cassandra

  1. Actualiza uno por uno todos los nodos de Cassandra en todas las regiones. Ejecuta los siguientes comandos en cada nodo: 
    /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 ejecutar algunas validaciones antes de continuar: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
  3. El resultado anterior mostrará 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
Estado del entorno de ejecución en esta etapa Estado de administración en esta etapa
Entorno de ejecución completamente funcional La siguiente función de administración se degrada después de que se actualiza Cassandra:

Paso 3: Actualiza todos los nodos de administración

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

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Estado del entorno de ejecución Estado de administración
Entorno de ejecución completamente funcional Se degradó la API de Management:

Paso 3a: [opcional] Importa SmartDocs que se exportaron anteriormente

Una vez que se actualicen todos los servidores de administración, puedes importar los modelos de SmartDocs que exportaste en el paso 1. También puedes decidir hacerlo más tarde.

Estado del entorno de ejecución Estado de administración
Entorno de ejecución completamente funcional Administración completamente funcional

Paso 4: Actualiza todos los nodos del entorno de ejecución

Actualiza uno por uno todos los routers y nodos del procesador de mensajes en todas las regiones:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Estado del entorno de ejecución Estado de administración
Entorno de ejecución completamente funcional Administración completamente funcional

Paso 5: Actualiza todos los componentes perimetrales restantes de la nube privada 4.52.02

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

En esta etapa, si actualizas desde versiones anteriores a Edge para la nube privada 4.52.01 y sigues los pasos adicionales para actualizar Qpid o Postgres, sigue los pasos correspondientes para actualizarlos.

Estado del entorno de ejecución Estado de administración
Entorno de ejecución completamente funcional Administración completamente funcional

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

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

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

Completa el paso 3a si aún no lo hiciste.

Estado del entorno de ejecución Estado de administración
Entorno de ejecución completamente funcional Administración completamente funcional

Actualización obligatoria a Zookeeper 3.8.3

Aunque Edge para la nube privada 4.52.02 no incluye una actualización a Zookeeper, si estás actualizando desde versiones anteriores a la 4.52.01, debes seguir los pasos para actualizar Zookeeper.

  • Si estás actualizando desde Edge para las versiones 4.51.00 o 4.52.00 de la nube privada, consulta los pasos en Actualización necesaria a Zookeeper 3.8.3 para actualizar Zookeeper.
  • Si estás actualizando desde Edge para nube privada a la versión 4.52.01, ya deberías usar la versión 3.8.3 de Zookeeper y no necesitas seguir ningún paso especial para hacerlo.

Actualización obligatoria a Postgres 14

  • Si estás actualizando de Edge para nube privada 4.51.00 a 4.52.02, debes seguir los pasos para actualizar Postgres, aunque Edge para nube privada 4.52.02 no incluya una actualización de Postgres. La actualización de Edge para la nube privada 4.51.00 a 4.52.02 requiere pasos adicionales de actualización de Postgres. Consulta la sección Actualización necesaria a Postgres 14.
  • Si estás actualizando desde Edge para nube privada 4.52.00 o 4.52.01 a 4.52.02, no se requieren pasos de actualización adicionales de Postgres.

Actualización obligatoria a Qpid J-Broker

Aunque Edge for Private Cloud 4.52.02 no incluye una actualización a QPID, si estás actualizando desde versiones anteriores a la 4.52.01, debes seguir los pasos para actualizar QPID.

  • Si estás actualizando desde Edge para nube privada 4.51.00 o 4.52.00 a 4.52.02, es necesario seguir los pasos adicionales de actualización de QPID. Consulta la sección Actualizar Qpid si estás actualizando de la versión 4.51.00 o 4.52.00 a la 4.52.02.
  • Si estás actualizando de Edge para nube privada 4.52.01 a 4.52.02, ya deberías usar la versión más reciente del agente de Qpid y no es necesario realizar pasos adicionales de actualización de QPID.

Nueva IU de Edge

En esta sección, se enumeran las consideraciones sobre 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 la 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

Si deseas actualizar el componente de IU de Edge, ten en cuenta la versión de Edge de la nube privada desde la que estás realizando la actualización:

Actualizar con Apigee mTLS

Para actualizar Apigee mTLS , sigue estos pasos:

Revierte una actualización

Si se produce una falla en la actualización, puedes intentar corregir el problema y, luego, volver a ejecutar update.sh. Puedes ejecutar la actualización varias veces para que continúe desde donde se detuvo la última vez.

Si el error requiere que reviertas la actualización a tu versión anterior, consulta Cómo revertir la 4.52.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 lo siguiente:

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

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

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

Actualización sin tiempo de inactividad

Una actualización sin tiempo de inactividad (o actualización progresiva) te permite actualizar la instalación de Edge sin dejar de usar 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 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 agregarlo al balanceador de cargas.

  1. Actualiza las máquinas en el orden correcto para la instalación, como se describe en Orden de actualización de la máquina.
  2. Cuando sea el momento de actualizar los routers, selecciona cualquier router y hazlo inaccesible, como se describe en Cómo habilitar o inhabilitar la accesibilidad del servidor (encargado del tratamiento de mensajes/enrutador).
  3. Actualiza el router seleccionado y todos los demás componentes de Edge en la misma máquina que el router. Todos los parámetros de configuración de Edge muestran un router y un procesador de mensajes en el mismo nodo.
  4. Haz que el router sea accesible de nuevo.
  5. Repite los pasos 2 al 4 para los routers restantes.
  6. Continúa la actualización en las máquinas restantes de la instalación.

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

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

Actualiza a 4.52.02 en un nodo con una conexión externa a Internet

Usa el siguiente procedimiento para actualizar los componentes de Edge en un nodo:

  1. Si está presente, inhabilita cualquier trabajo 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. 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 de configuración de Apigee de Edge.
  5. Si estás instalando en Oracle 7.x, ejecuta el siguiente comando: 
    sudo yum-config-manager --enable ol7_optional_latest
  6. Si instalas 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, haz lo siguiente:

    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 mediante la ejecución del 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 solicitará que lo ingreses.

      De forma predeterminada, el instalador comprueba que tengas Java 1.8 instalado. De lo contrario, el instalador lo instalará por ti.

      Usa la opción JAVA_FIX para especificar cómo controlar la instalación de Java. JAVA_FIX acepta 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.
    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 mediante la ejecución del siguiente comando: 
      /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

      Hazlo en el orden descrito en Orden de actualización de máquina.

      Aquí:

      • 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: servidor de administración, procesador de mensajes, router, servidor QPID, servidor Postgres
        • 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: cuidador de zoológico
      • configFile es el mismo archivo de configuración que usaste para definir los componentes de Edge durante la instalación 4.50.00 o 4.51.00.

      Puedes ejecutar update.sh en todos los componentes si configuras component como "todos", 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. Reinicia el componente de IU de Edge en todos los nodos que lo ejecutan, si aún no lo hiciste: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    8. 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 luego decides revertir la actualización, usa el procedimiento que se describe en Reversión 4.52.02.

Actualización a 4.52.02 desde un repositorio local

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

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

  • Crea un archivo .tar del repositorio, copia el archivo .tar en un nodo y, luego, actualiza Edge desde el archivo .tar.
  • Instalar 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.52.02, haz lo siguiente:

  1. Crea un repositorio 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 repositorio local, usa el siguiente comando para empaquetar el repositorio 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 quieres 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 y las dependencias apigee-service de Edge desde /tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

  3. Para instalar apigee-service mediante el servidor web Nginx, sigue estos pasos:
    1. Configura el servidor web Nginx como se describe en “Instala desde el repositorio mediante el servidor web de 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

      En el ejemplo anterior, 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.

    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://

      En el ejemplo anterior, 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 descrito 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, debes actualizar 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, servidor Postgres
      • 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: cuidador de zoológico
    • configFile es el mismo archivo de configuración que usaste para definir los componentes de Edge durante la instalación 4.50.00 o 4.51.00.

    Puedes ejecutar update.sh en todos los componentes si configuras component como "todos", 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 luego decides revertir la actualización, usa el procedimiento que se describe en Reversión 4.52.02.

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 debe realizarse en varias máquinas, ejecútalo en el orden de máquina especificado.
  • No existe un paso aparte 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.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 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 conocer la lista de topologías de Edge y cantidad 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. Actualizar 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. Actualizar 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 ejemplo anterior, 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 conocer la lista de topologías de Edge y cantidad 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. Actualizar 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. Actualizar Qpid en la máquina 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Actualizar 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 (puede 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 ejemplo anterior, sso_config_file es el archivo de configuración que creaste cuando instalaste el SSO.

  11. Reinicia el componente de 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 (puede 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 agrupada en clústeres de 9 nodos:

Consulta Topologías de instalación para conocer la lista de topologías de Edge y cantidad 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. Actualizar 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 el 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 IU 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 de 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 ejemplo anterior, sso_config_file es el archivo de configuración que creaste cuando instalaste el SSO.

  10. Reinicia el componente de 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 (puede que no sea la máquina 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Actualización de 13 nodos en clústeres

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

Consulta Topologías de instalación para conocer la lista de topologías de Edge y cantidad 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 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 el 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 ejemplo anterior, sso_config_file es el archivo de configuración que creaste cuando instalaste el SSO.

  10. Reinicia el componente de 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 de 12 nodos en clústeres

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

Consulta Topologías de instalación para conocer la lista de topologías de Edge y cantidad 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 el LDAP:
    1. Máquina 1 del 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 del 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 IU clásica (ui):
    1. Máquina 1 en el centro de datos 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
    2. Máquina 7 en el centro de datos 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  7. (Si instalaste apigee-adminapi) Se actualizó la utilidad apigee-adminapi:
    1. Máquina 1 en el centro de datos 1: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
    2. Máquina 7 en el centro de datos 2: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  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

      3. En el ejemplo anterior, sso_config_file es el archivo de configuración que creaste cuando instalaste el SSO.

  9. Reinicia el componente de la nueva IU de Edge (edge-management-ui) o de la IU clásica de Edge (edge-ui) en las máquinas 1 y 7: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

Para una configuración no estándar

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

  1. ZooKeeper
  2. Cassandra
  3. ps
  4. LDAP
  5. Edge, que significa el perfil “-c Edge” en todos los nodos del orden: nodos con servidor Qpid, servidor Edge Postgres, 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

Una vez finalizada la actualización, asegúrate de reiniciar el componente de IU de Edge en todas las máquinas que lo ejecutan.