Actualiza Apigee Edge 4.51.00 o 4.52.00 a 4.52.01

Apigee admite la actualización de Edge para la nube privada de la versión 4.51.00 o la versión 4.52.00 directamente a la versión 4.52.01. En esta página, se describe cómo realizar cualquiera de las 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 ejecute 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
    Usa el siguiente comando para asegurarte de que Edge esté en funcionamiento durante el proceso de actualización:
    /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 Cambia la estrategia de compactación de Cassandra.

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 Zookeeper 3.8.3

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

Antes de actualizar Zookeeper, lee la guía de mantenimiento de Zookeeper. La mayoría de los sistemas de producción de Edge usan un clúster de nodos de Zookeeper distribuidos en varios centros de datos. Algunos de estos nodos se configuran como votantes que participan en la elección de líder de Zookeeper, y el resto se configuran como observadores. Consulta Información sobre líderes, seguidores, votantes y observadores para obtener más detalles. Los nodos votantes eligen un líder, después del cual los nodos votantes se convierten en seguidores.

Durante el proceso de actualización, puede haber una demora momentánea o una falla de escritura en Zookeeper cuando se apaga el nodo líder. Esto podría afectar las operaciones de administración que escriben en Zookeeper, como la operación de implementación de un proxy y los cambios en la infraestructura de Apigee, como la adición o eliminación de un procesador de mensajes, etcétera. No debería haber ningún impacto en las APIs de tiempo de ejecución de Apigee (a menos que estas APIs de tiempo de ejecución llamen a las APIs de administración) durante la actualización de Zookeeper mientras se sigue el procedimiento que se indica a continuación.

En términos generales, el proceso de actualización implica crear una copia de seguridad de cada nodo. A esto le sigue la actualización de todos los observadores y seguidores y, por último, la actualización del nodo líder.

Cómo crear una copia de seguridad

Crea una copia de seguridad de todos los nodos de Zookeeper para usarla en caso de que se requiera una reversión. Ten en cuenta que una reversión restablecerá Zookeeper al estado en el que se tomó la copia de seguridad. Nota: Se perderán durante la restauración todas las implementaciones o cambios de infraestructura en Apigee desde que se tomó la copia de seguridad (cuya información se almacena en Zookeeper).

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

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

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

Nota: En los siguientes comandos de muestra, se usa la utilidad nc para enviar datos a Zookeeper. También puedes usar utilidades alternativas para enviar datos a Zookeeper.

  1. Si no está instalado en el nodo ZooKeeper, instala nc:
      sudo yum install nc
  2. Ejecuta el siguiente comando nc en el nodo, donde 2181 es el puerto de ZooKeeper:
      echo stat | nc localhost 2181

    Deberías ver un resultado como el siguiente:

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

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

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

Actualiza ZooKeeper en los nodos de observador y seguidor

Actualiza ZooKeeper en cada uno de los nodos de observador y seguidor de la siguiente manera:

  1. Descarga y ejecuta el inicio automático de Edge for Private Cloud 4.52, como se describe en Actualiza a 4.52.01 en un nodo con una conexión a Internet externa. Es probable que el proceso varie según si el nodo tiene una conexión a Internet externa o si realizas una instalación sin conexión.
  2. Actualiza el componente de Zookeeper:
      /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
    Nota: Si estos nodos tienen otros componentes instalados (como Cassandra), también puedes actualizarlos ahora (como con el perfil cs,zk) o puedes actualizar los otros componentes más adelante. Apigee recomienda que primero actualices solo Zookeeper y te asegures de que tu clúster funcione correctamente antes de actualizar otros componentes.
  3. Repite los pasos anteriores en cada uno de los nodos de observador y seguidor de Zookeeper.

Cómo cerrar el líder

Una vez que se hayan actualizado todos los nodos de observador y seguidor, cierra el líder. En el nodo identificado como líder, ejecuta el siguiente comando:

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

Ten en cuenta que, durante este evento, antes de que se elija un líder nuevo, es posible que haya retrasos momentáneos o fallas de escritura en Zookeeper. Esto podría afectar las operaciones que escriben en Zookeeper, como la acción de implementación de proxies o los cambios en la infraestructura de Apigee, como la adición o eliminación de procesadores de mensajes, etcétera.

Verifica que se elija el nuevo líder

Sigue los pasos de la sección Cómo identificar el líder, los seguidores y los observadores anterior para verificar que se haya elegido un líder nuevo entre los seguidores una vez que se detenga el líder existente. Ten en cuenta que el líder podría haberse elegido en un centro de datos diferente al líder actual.

Actualiza el líder

Sigue los mismos pasos que se indican en Actualiza Zookeeper en los nodos de observador y seguidor.

Una vez que se actualice el nodo líder anterior, verifica el estado del clúster y asegúrate de que haya un nodo líder.

Revertir

En caso de que se requiera una reversión, haz lo siguiente:

  1. Primero, realiza los pasos de reversión en los observadores y seguidores.
  2. Descarga y ejecuta el inicio de la versión a la que quieres revertir, ya sea 4.50 o 4.51. Es probable que el proceso varíe según si el nodo tiene una conexión a Internet externa o si estás siguiendo la instalación sin conexión.
  3. Detén ZooKeeper si se está ejecutando en el nodo:
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
  4. Desinstala el zookeeper existente:
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall
  5. Instala Zookeeper como de costumbre:
      /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>
  6. Una vez que se hayan revertido todos los seguidores y observadores, sigue los pasos del 2 al 5 en el nodo líder para revertirlo.
  7. Después de que se reviertan todos los nodos, verifica el estado del clúster y asegúrate de que haya un nodo líder en él.

Restaurar copia de seguridad

Consulta Cómo restablecer una copia de seguridad. Ten en cuenta que las copias de seguridad de Zookeeper tomadas de versiones anteriores de Edge para la nube privada, como 4.50 y 4.51, deben ser compatibles con la versión de Zookeeper en Edge para la nube privada 4.52.

Actualización obligatoria a Postgres 14

Esta versión de Edge para la nube privada incluye una actualización a Postgres 14. Como parte de esta actualización, todos los datos de Postgres se migran a Postgres 14.

  • Si actualizas de Edge para la nube privada 4.51.00 a 4.52.01, debes seguir pasos adicionales de actualización de Postgres. Consulta la sección Actualización obligatoria a Postgres 14 si actualizas de la versión 4.51.00 a la 4.52.01.
  • Si actualizas de Edge para la nube privada 4.52.00 a 4.52.01, no es necesario realizar pasos adicionales de actualización de Postgres.

Actualiza Qpid

Esta versión de Edge para la nube privada incluye una actualización a Qpid J-Broker.

Te recomendamos que selecciones uno de los siguientes métodos para realizar la actualización de Qpid:

Actualización in situ sin tiempo de inactividad

Este método garantiza que no haya tiempo de inactividad para tu entorno de tiempo de ejecución de Edge y minimiza la pérdida de datos de tiempo de ejecución, si los hay, que se adquirieron para las estadísticas.

Para realizar una actualización sin tiempo de inactividad en Qpid, haz lo siguiente:

  1. Elige un nodo Qpid para comenzar.
  2. Detén el agente de Qpid en el nodo:
    apigee-service apigee-qpidd stop
  3. Aplica un firewall para bloquear el tráfico entrante en el puerto 5672 del agente de intercambio de todos los procesadores de mensajes. Puedes aplicar este firewall a nivel de la instancia del nodo Qpid o de algún otro componente de firewall o red externo.

    Te recomendamos que realices el mismo paso para todas las direcciones IP del procesador de mensajes. Por ejemplo, para descartar las solicitudes que provienen de direcciones IP del procesador de mensajes al nodo Qpid en el puerto 5672 con IPTables, puedes usar un comando como el siguiente:

    iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
  4. Vuelve a iniciar el agente de Qpid para agotar los mensajes existentes, si los hay:
    apigee-service apigee-qpidd start
  5. Verifica que las filas existentes estén vacías:
    qpid-stat -q

    Si los mensajes están bloqueados en la cola de mensajes devueltos (DLQ) (ax-q-axgroup-001-consumer-group-001-dl), vacía la cola con los pasos para resolver los datos de Analytics bloqueados en la cola de mensajes devueltos.

  6. Después de verificar que las colas se hayan agotado en el nodo anterior, detén apigee-qpidd:
    apigee-service apigee-qpidd stop
  7. Actualiza Qpid en el nodo:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Reinicia edge-qpid-server:
    apigee-service edge-qpid-server restart
  9. Quita la regla de firewall aplicada en el paso 3.

    Realiza el mismo paso de eliminación para todas las direcciones IP del procesador de mensajes a las que se aplicó el firewall. Una vez que se quiten los firewalls, se aceptarán las solicitudes que provengan de direcciones IP del procesador de mensajes al nodo Qpid en el puerto 5672. Si usaste iptables para agregar el firewall, quitarlo y enumerar la configuración existente, puedes usar comandos como los siguientes:

    iptables -F
      iptables -L
  10. Usa la supervisión web para verificar que las colas de Qpid reciban mensajes:
    http://QPID_NODE_IP:8090
  11. Repite los pasos del 1 al 9 para cada nodo Qpid.

Cómo poner en servicio un nuevo nodo Qpid

Este método configura e instala apigee-qpidd y edge-qpid-server en un nodo nuevo.

  1. Agrega un nuevo nodo Qpid. En este paso, se configura un nodo Qpid con J-broker. Para obtener pasos detallados, consulta Agrega un servidor Qpid.
  2. Elige un nodo Qpid existente (un nodo de la versión desde la que realizas la actualización).
  3. Detén el agente de Qpid en el nodo:
    apigee-service apigee-qpidd stop
  4. Aplica un firewall para bloquear el tráfico entrante en el puerto 5672 del agente de todos los procesadores de mensajes. Puedes aplicar este firewall a nivel de la instancia del nodo Qpid o de algún otro componente de firewall o red externo.

    Te recomendamos que realices el mismo paso para todas las direcciones IP del procesador de mensajes. Por ejemplo, para descartar las solicitudes que provienen de direcciones IP del procesador de mensajes al nodo Qpid en el puerto 5672 con IPTables, puedes usar un comando como el siguiente:

    iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
  5. Vuelve a iniciar el agente de Qpid para agotar los mensajes existentes, si los hay:
    apigee-service apigee-qpidd start
  6. Asegúrate de que las filas existentes estén vacías:
    qpid-stat -q

    Si los mensajes están bloqueados en la cola de mensajes no entregados (DLQ) (ax-q-axgroup-001-consumer-group-001-dl), sigue los pasos que se indican en el tema de solución de problemas Datos de Analytics bloqueados en la cola de mensajes no entregados de Qpidd para agotarla.

  7. Después de verificar que las colas se hayan agotado en el nodo anterior, detén apigee-qpidd.
    apigee-service apigee-qpidd stop
  8. Para anular el registro del nodo Qpid anterior, sigue los pasos que se indican en Cómo quitar un servidor Qpid.
  9. Sigue agregando un nodo nuevo y quitando uno antiguo, uno a la vez, hasta que todos los nodos de Qpid se hayan actualizado.

Revertir

Para revertir a una versión de funciones anterior, asegúrate de descargar el archivo bootstrap.sh de la versión a la que deseas revertir. Para revertir a la versión 4.52.00, descarga bootstrap_4.52.00.sh.

Para revertir Qpid, sigue estos pasos en todos los hosts de Qpid:

  1. Detén el agente de Qpid existente
    apigee-service apigee-qpidd stop
  2. Aplica un firewall para bloquear el tráfico entrante en el puerto 5672 del agente de intercambio de todos los procesadores de mensajes. Puedes aplicar este firewall a nivel de la instancia del nodo Qpid o de algún otro componente de firewall o red externo.

    Te recomendamos que realices el mismo paso para todas las direcciones IP del procesador de mensajes. Por ejemplo, para descartar las solicitudes que provienen de direcciones IP del procesador de mensajes al nodo Qpid en el puerto 5672 con IPTables, puedes usar un comando como el siguiente:

    iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
  3. Vuelve a iniciar el agente de qpid para eliminar los mensajes existentes, si los hay:
    apigee-service apigee-qpidd start
  4. Asegúrate de que las colas existentes estén vacías. Para verificarlo, accede al portal de administración de Qpid:
    http://QPID_NODE_IP:8090
    Nota: En caso de que no se pueda acceder al puerto 8090 en el nodo QPID, puedes usar mecanismos alternativos, como el reenvío de puertos SSH, para acceder a esta URL.
  5. Después de verificar que las colas se hayan agotado, detén y desinstala Qpid:
    apigee-service apigee-apidd uninstall
  6. Borra el directorio de datos de Qpid:
    rm -r APIGEE_ROOT/data/apigee-qpidd
  7. Reinstala el agente de Qpid:
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  8. Una vez que se vuelva a instalar el agente de Qpid, quita la configuración del firewall y muestra la configuración existente con los siguientes comandos:
    iptables -F
    iptables -L

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.

Cómo actualizar 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:

Actualiza con mTLS de Apigee

Para actualizar mTLS de Apigee , sigue estos pasos:

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 la versión 4.52.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:

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

Actualiza a la versión 4.52.01 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. 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, haz lo siguiente:

    1. Descarga el archivo bootstrap_4.52.01.sh de Edge a /tmp/bootstrap_4.52.01.sh:
      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
    2. Ejecuta el siguiente comando para instalar la utilidad y las dependencias de apigee-service de Edge 4.52.01:
      sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

      En el ejemplo anterior, uName:pWord son el nombre de usuario y la contraseña que recibiste de Apigee. Si omites pWord, se te pedirá que lo ingreses.

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

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

      • I: Instala OpenJDK 1.8 (predeterminado).
      • C: Continuar 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 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: 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: 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 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 ./sa_silent_config
    7. Reinicia los componentes de la IU de Edge en todos los nodos que los ejecutan, si aún no lo hiciste:
      /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
    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 más adelante decides revertir la actualización, usa el procedimiento que se describe en Cómo revertir la versión 4.52.01.

Actualiza a la versión 4.52.01 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.52.01, haz lo siguiente:

  1. Crea un repositorio local 4.52.01 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.52.01.tar.gz:
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. Copia el archivo .tar en el nodo en el que deseas actualizar Edge. Por ejemplo, cópialo en el directorio /tmp del nodo nuevo.
    3. En el nodo nuevo, descomprime el archivo en el directorio /tmp:
      tar -xzf apigee-4.52.01.tar.gz

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

    4. Instala la utilidad apigee-service y las dependencias de Edge desde /tmp/repos:
      sudo bash /tmp/repos/bootstrap_4.52.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

  3. Para instalar apigee-service con el servidor web Nginx, 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.52.01.sh de Edge a /tmp/bootstrap_4.52.01.sh:
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.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.52.01.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

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

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.52.01, 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 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) Actualizaste 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) Actualizaste 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 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 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 comando anterior, 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 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) 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 que sso_config_file es el archivo de configuración que creaste cuando instalaste el SSO.

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