Actualiza Apigee Edge 4.50.00 o 4.51.00 a la versión 4.52.00

Apigee admite la actualización de Edge para la nube privada desde la versión 4.50.00 o directamente a la versión 4.51.00 versión 4.52.00. 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. persona que se ejecuta como raíz.

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 incluye 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
    Antes de la actualización, te recomendamos realizar una copia de seguridad completa de todos los nodos por motivos de seguridad. y otras razones. 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 funcionen correctamente. Para obtener más información sobre las copias de seguridad, consulta Copias de seguridad y Restablecer.

  • Asegúrate de que Edge se esté ejecutando
    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 competencia de Cassandra sea LeveledCompactionStrategy.
    Asegúrate de que la estrategia de compatibilidad de Cassandra esté configurada en LeveledCompactionStrategy, como se describe en Cambia el Estrategia de compactación de Cassandra.

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

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

Actualización necesaria a Zookeeper 3.8.0

Esta versión de Edge para nubes privadas incluye una actualización a Zookeeper 3.8.0. Como parte de todos los datos de Zookeeper se migrarán a Zookeeper 3.8.0.

Antes de actualizar Zookeeper, lee el Zookeeper guía de mantenimiento. La mayoría de los sistemas de producción de Edge usan un clúster de nodos de Zookeeper en varios centros de datos. Algunos de estos nodos están configurados como votantes que participan en la elección de líder de Zookeeper, y el resto está configurado como observadores. Consulta Acerca de líderes, seguidores, votantes y observadores para obtener más información. Los nodos votantes eligen un y los nodos votantes se convierten en seguidores.

Durante el proceso de actualización, podría haber un retraso momentáneo o un error de escritura en Zookeeper. cuando se cierra el nodo líder. Esto podría afectar las operaciones de administración que se escriben en Zookeeper, como la operación de implementación de un proxy y los cambios de infraestructura de Apigee, como agregar o quitar un procesador de mensajes, etc. No debería afectar el tiempo de ejecución APIs de Apigee (a menos que estas APIs del entorno de ejecución llamen a las APIs de administración) durante la actualización de Zookeeper mientras con el siguiente procedimiento.

En un nivel alto, el proceso de actualización implica realizar una copia de seguridad de cada nodo. Esto se sigue actualizando todos los observadores y seguidores y, por último, actualizando el nodo líder.

Hacer una copia de seguridad

Realiza 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 realizó la copia de seguridad. Nota: Cualquier implementación cambios de infraestructura en Apigee desde que se realizó la copia de seguridad (cuya información se almacena en Zookeeper) se perderán durante el restablecimiento.

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

Si usas máquinas virtuales y tienes la capacidad, las instantáneas o copias de seguridad de VM también podrían se deben realizar para su restablecimiento o reversión (si es necesario).

Identificar líderes, seguidores y observadores

Nota: Los siguientes comandos de ejemplo usan las utilidad nc para enviar datos a Zookeeper. Podrías usar utilidades alternativas para enviar datos a Zookeeper.

  1. Si no está instalado en el nodo de 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.0-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, el Mode está configurado 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 nodo de observador y seguidor de la siguiente manera:

  1. Descarga y ejecuta el arranque de Edge para la nube privada 4.52, como se describe en Actualiza a 4.52.00 en un nodo con una conexión externa a Internet. Es probable que el proceso varían en función de si el nodo tiene una conexión externa a Internet 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), podrías actualizar también (como con el perfil cs,zk) o podrías actualizar los otros componentes más tarde. Apigee recomienda que primero actualices Zookeeper y te asegures de que tu clúster funcione correctamente antes de actualizar otros componentes.
  3. Repite los pasos anteriores en cada nodo de observador y seguidores de Zookeeper.

Cierra al líder

Una vez que se hayan actualizado todos los nodos del observador y de los seguidores, 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 elegir a un nuevo líder, podría haber retrasos momentáneos o errores de escritura en Zookeeper. Esto podría afectar las operaciones que se escriben en Zookeeper. como la acción de implementación de proxies o cambios de infraestructura de Apigee, como adición o eliminación de procesadores de mensajes, etcétera

Verifica que se haya elegido al nuevo líder

Con los pasos de la guía Identifica a un líder, en la sección de seguidores y observadores que aparece más arriba, verifica que se haya elegido a un nuevo líder del seguidores, una vez que se detiene al líder existente. Ten en cuenta que se podría haber elegido líder en un centro de datos diferente al líder actual.

Líder de actualización

Sigue los mismos pasos que en Actualiza Zookeeper en los nodos observador y seguidor anteriores.

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

Revertir

En caso de que se requiera una reversión:

  1. Primero, realiza los pasos de reversión en los observadores y los seguidores.
  2. Descarga y ejecuta el arranque de la versión a la que estás revirtiendo, ya sea 4.50 o 4.51. Es probable que el proceso varíe en función de si el nodo tiene una conexión externa a Internet. 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 zoológico actual:
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall
  • Instala Zookeeper como de costumbre:
      /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>
  • Una vez que se hayan revertido todos los seguidores y observadores, puedes revertir el nodo líder siguiendo estos pasos: los pasos 2 a 5 en el nodo líder.
  • Después de revertir todos los nodos, verifica el estado del clúster y asegúrate de que un nodo líder en el clúster.
  • Restaurar copia de seguridad

    Consulta Restablece desde 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 es compatible 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 incluye una actualización a Postgres 14. Como parte de esa actualización, Los datos de Postgres se migran a Postgres 14.

    La mayoría de los sistemas de producción de Edge usan dos nodos de Postgres configurados para la replicación en espera de la instancia principal. Durante el proceso de actualización, mientras los nodos de Postgres no se pueden actualizar, los datos de estadísticas aún se escribe en los nodos Qpid. Después de que los nodos de Postgres se actualicen y vuelvan a estar en línea, los datos de estadísticas se envía a los nodos de Postgres.

    La forma en que realices la actualización de Postgres depende de cómo configuraste el almacenamiento de datos para tu Nodos de Postgres:

    • Si usas el almacenamiento de datos local para tus nodos de Postgres, debes instales un nodo en espera de Postgres nuevo mientras dure la actualización. Después del se complete la actualización, puedes retirar el nuevo nodo en espera de Postgres.

      El nodo en espera adicional de Postgres es obligatorio si tienes que revertir la actualización por cualquier motivo. Si tienes que revertir la actualización, el nuevo nodo en espera de Postgres se convierte en el nodo principal de Postgres después de la reversión. Por lo tanto, cuando instales nuevo nodo en espera de Postgres, debe estar en un nodo que cumpla con todos los requisitos de un servidor de Postgres, como se define en la sección Requisitos de instalación.

      En una configuración de 1 y 2 nodos de Edge, las topologías que se usan para el prototipado y las pruebas, tener un solo nodo de Postgres. Puedes actualizar estos nodos de Postgres directamente sin tener para crear un nuevo nodo de Postgres.

    • Si usas almacenamiento de red para tus nodos de Postgres, que recomienda Apigee, no es necesario que instales un nodo de Postgres nuevo. En la que se indican a continuación, puedes omitir los pasos que especifiquen la instalación y, luego, retirar de servicio una nueva Nodo en espera de Postgres.

      Antes de comenzar el proceso de actualización, toma una instantánea de red del almacén de datos que usa Postgres. Luego, si se produce algún error durante la actualización y te ves obligado a realizar una reversión, puedes restablecer el nodo de Postgres a partir de esa instantánea.

    Instala un nuevo Postgres nodo en espera

    En este procedimiento, se crea un servidor en espera de Postgres en un nodo nuevo. Asegúrate de instalar una nueva Servidor en espera de Postgres para tu versión existente de Edge (4.50.00 o 4.51.00) no para la versión 4.52.00.

    Para realizar la instalación, usa el mismo archivo de configuración que usaste para instalar la versión actual de Edge.

    Para crear un nodo en espera de Postgres nuevo, haz lo siguiente:

    1. En la instancia principal de Postgres actual, edita /opt/apigee/customer/application/postgresql.properties para configurar el siguiente token. Si ese archivo no existe, créalo:
      conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust

      Donde existing_standby_ip es la dirección IP del Postgres actual el servidor en espera, y new_standby_ip es la dirección IP del nodo en espera nuevo.

    2. Reinicia apigee-postgresql en la instancia principal de Postgres:
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
    3. Verifica que el nodo en espera nuevo se haya agregado. Para ello, consulta el /opt/apigee/apigee-postgresql/conf/pg_hba.conf en el principal. Deberías ver las siguientes líneas en ese archivo:
      host replication apigee existing_standby_ip/32 trust
      host replication apigee new_standby_ip/32 trust
    4. Instala el nuevo servidor de Postgres en espera:
      1. Edita el archivo de configuración que usaste para instalar tu versión actual de Edge y especifica el parámetro lo siguiente:
        # IP address of the current master:
        PG_MASTER=192.168.56.103
        # IP address of the new standby node
        PG_STANDBY=192.168.56.102
      2. Inhabilita SELinux como se describe en Instala la utilidad de Apigee-setup de Edge.
      3. Si actualmente usas Edge 4.51.00, haz lo siguiente:

        1. Descarga el archivo bootstrap_4.51.00.sh de Edge para /tmp/bootstrap_4.51.00.sh :
          curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
        2. Instala la utilidad y las dependencias apigee-service de Edge:
          sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

        Si actualmente usas Edge 4.50.00, haz lo siguiente:

        1. Descarga el archivo bootstrap_4.50.00.sh de Edge para /tmp/bootstrap_4.50.00.sh :
          curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
        2. Instala la utilidad y las dependencias apigee-service de Edge:
          sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
      4. Usa apigee-service para instalar la utilidad apigee-setup:
        /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
      5. Instala Postgres:
        /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
      6. En el nodo en espera nuevo, ejecuta el siguiente comando:
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        Verifica que sea el modo en espera.

    Realiza una actualización local de Postgres

    Nota: Debes realizar el siguiente paso preliminar antes realizar una actualización local de Postgres.

    Paso preliminar

    Antes de realizar una actualización local a Postgres, realiza los siguientes pasos en la instancia principal como host y en espera, para actualizar Propiedad max_locks_per_transaction en apigee-postgresql:

    1. Si no está presente, crea el archivo. /opt/apigee/customer/application/postgresql.properties
    2. Cambia la propiedad de este archivo a apigee:
      sudo chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
    3. Agrega la siguiente propiedad al archivo:
      conf/postgresql.conf+max_locks_per_transaction=30000
    4. Configura apigee-postgresql:
      apigee-service apigee-postgresql configure
    5. Reinicia apigee-postgresql:
      apigee-service apigee-postgresql restart

    Realiza la actualización in situ.

    Para realizar una actualización local a Postgres 14, sigue estos pasos:

    1. Actualiza postgres en el host principal
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
    2. Ejecuta el comando de configuración en el host principal:
      apigee-service apigee-postgresql setup -f /opt/silent.conf
    3. Ejecuta el comando de configuración en el host principal:
      apigee-service apigee-postgresql configure
    4. Reinicia el host principal:
      apigee-service apigee-postgresql restart
    5. Configúralo como principal:
      apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf
    6. Asegúrate de que se inició el host principal:
      apigee-service apigee-postgresql wait_for_ready
    7. Detén el modo en espera:
      apigee-service apigee-postgresql stop
    8. Actualiza el modo en espera.

      Nota: Si este paso falla o se produce un error, puedes ignorarlo. update.sh intentará iniciar el servidor de reserva con una configuración incorrecta. Provisión de Postgres se actualiza a 14, se puede ignorar el error.

      /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
    9. Asegúrate de que el modo en espera esté detenido:
      apigee-service apigee-postgresql stop
    10. Quita la configuración en espera anterior:
      rm -rf /opt/apigee/data/apigee-postgresql/
    11. Configura la replicación en el servidor en espera:
      apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf
    12. Quita la línea conf/postgresql.conf+max_locks_per_transaction=30000 de el archivo /opt/apigee/customer/application/postgresql.properties en ambos el host principal y el modo en espera. Esta línea era que se agregaron en el paso preliminar.

    Después de completar este procedimiento, la espera se iniciará correctamente.

    Retira un nodo de Postgres

    Una vez que se complete la actualización, retira del servicio el nodo en espera nuevo:

    1. Asegúrate de que Postgres se esté ejecutando:
      /opt/apigee/apigee-service/bin/apigee-all status

      Si Postgres no se está ejecutando, inícialo:

      /opt/apigee/apigee-service/bin/apigee-all start

    2. Obtén el UUID del nodo en espera nuevo ejecutando el siguiente comando curl en el nodo nodo en espera:
      curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

      Deberías ver el UUID del nodo al final del resultado, en el siguiente formato:

      "type" : [ "postgres-server" ],
      "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"

    3. Para detener el nodo en espera nuevo, ejecuta el siguiente comando en el nodo en espera nuevo:
      /opt/apigee/apigee-service/bin/apigee-all stop
    4. En el nodo principal de Postgres, edita /opt/apigee/customer/application/postgresql.properties para quitar el nodo en espera nuevo de conf_pg_hba_replication.connection:
      conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
    5. Reinicia apigee-postgresql en la instancia principal de Postgres:
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
    6. Para verificar que se haya quitado el nodo en espera nuevo, consulta el /opt/apigee/apigee-postgresql/conf/pg_hba.conf en el principal. Deberías ver solo la siguiente línea en ese archivo:
      host replication apigee existing_standby_ip/32 trust
    7. Para borrar el UUID del nodo en espera de ZooKeeper, realiza la siguiente administración de Edge Llamada a la API en el nodo del servidor de administración:
      curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

    Pasos posteriores a la actualización de Postgres

    Después de una actualización importante de Postgres, sus estadísticas internas se borran. Estas estadísticas ayudan al planificador de consultas de Postgres a usar los índices y rutas más óptimos para ejecutar consultas.

    Postgres puede volver a compilar sus estadísticas de manera gradual a lo largo del tiempo a medida que se ejecutan las consultas y cuando se ejecuta el daemon de autovacuum. Sin embargo, hasta que se vuelvan a crear las estadísticas, es posible que las consultas sean lentas.

    Para solucionar este problema, ejecuta ANALYZE en todas las tablas de la base de datos del nodo principal de Postgres. También puedes ejecutar ANALYZE para algunas tablas a la vez.

    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 instalar la IU de Edge, que es una interfaz de usuario mejorada para 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

    Para actualizar el componente de IU de Edge, considera la versión de Edge para la nube privada que están actualizando desde:

    Actualizar con Apigee mTLS

    Para actualizar Apigee mTLS , sigue estos pasos: pasos:

    Revierte una actualización

    En caso de que falle la actualización, puedes intentar corregir el problema y, luego, ejecutar update.sh otra vez. Puedes ejecutar la actualización varias veces para que continúe la actualización. desde donde quedó por última vez.

    Si el error requiere que reviertas la actualización a tu versión anterior, consulta Revierte 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, 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 la instalación de Edge sin necesidad de derribando 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, de la carga. del balanceador de cargas. Luego, actualiza el router y cualquier otro componente en la misma máquina que el router. y, luego, vuelve a agregar el router al balanceador de cargas.

    1. Actualiza las máquinas en el orden correcto para la instalación como se describe. Orden de actualización de la máquina.
    2. Cuando llegue el momento de actualizar los routers, selecciona cualquier router y haz que sea inaccesible, ya que se describe en Habilitar/Inhabilitar el servidor Accesibilidad (procesador de mensajes/router).
    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 debería ser la misma que usaste para instalar Edge 4.50.00 o 4.51.00.

    Actualizar a 4.52.00 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 de cron configurado para realizar una operación de reparación en Cassandra hasta que se completa 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 Instalación 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 la app en AWS, ejecuta el siguiente comando: Comandos yum-configure-manager:
      yum update rh-amazon-rhui-client.noarch
      sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
    7. Si actualmente usas Edge 4.51.00, haz lo siguiente:

      1. Descarga el archivo bootstrap_4.52.00.sh de Edge en /tmp/bootstrap_4.52.00.sh
        curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
      2. Instala la utilidad apigee-service y las dependencias de Edge 4.52.00 de la siguiente manera: mediante la ejecución del siguiente comando:
        sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord

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

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

        Usa la opción JAVA_FIX para especificar cómo manejarla 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 la que se muestra a continuación:
        /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
      4. Actualiza la utilidad apigee-validate en el servidor de administración de la siguiente manera: ejemplo muestra:
        /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
      5. Actualiza la utilidad apigee-provision en el servidor de administración de la siguiente manera: ejemplo muestra:
        /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

        Haz esto en el orden descrito en Orden de máquinas actualización.

        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, mensaje Procesador, 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 define tu perímetro componentes durante la instalación 4.50.00 o 4.51.00.

        Puedes ejecutar update.sh en todos los componentes si configuras component. en “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. 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. Ejecuta la utilidad apigee-validate en la Administración para probar la actualización Servidor, como se describe en Prueba la instalación.

      Si luego decides revertir la actualización, usa el procedimiento que se describe en Revierte 4.52.00.

      Actualiza a 4.52.00 desde un repositorio local

      Si los nodos perimetrales están detrás de un firewall o tienen prohibido acceder, el repositorio de Apigee por Internet, puedes actualizar desde un repositorio local del repositorio de Apigee.

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

      • Crea un archivo .tar del repositorio, cópialo en un nodo y, luego, actualiza Edge desde el .tar.
      • Instalar un servidor web en el nodo con el repositorio local para que otros nodos puedan acceder a él Apigee te proporciona el servidor web Nginx, o puedes usar tu propio servidor web web.

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

      1. Crea un repositorio local 4.52.00 como se describe en “Crea un repositorio local de Apigee”. en Instala la utilidad de 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.00.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 en el nodo nuevo.
        3. En el nodo nuevo, descomprime el archivo en el directorio /tmp:
          tar -xzf apigee-4.52.00.tar.gz

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

        4. Instala la utilidad y las dependencias apigee-service de Edge desde /tmp/repos
          sudo bash /tmp/repos/bootstrap_4.52.00.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 con el servidor webserver&quot; en Install the Edge apigee-setup.
        2. En el nodo remoto, descarga el archivo bootstrap_4.52.00.sh de Edge para /tmp/bootstrap_4.52.00.sh
          /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh

          En el ejemplo anterior, uName:pWord son el nombre de usuario y la contraseña que configuraste anteriormente. 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.00.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 la que se muestra a continuación:
        /opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
      5. Actualiza la utilidad apigee-validate en el servidor de administración de la siguiente manera: ejemplo muestra:
        /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
      6. Actualiza la utilidad apigee-provision en el servidor de administración de la siguiente manera: ejemplo muestra:
        /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, se actualiza 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 define 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. en “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. 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. Ejecuta la utilidad apigee-validate en la Administración para probar la actualización Servidor, como se describe en Prueba la instalación.

      Si luego decides revertir la actualización, usa el procedimiento que se describe en Revierte 4.52.00.

      Orden de actualización de la máquina

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

      • Debes actualizar todos los nodos de Cassandra y ZooKeeper antes de actualizar alguno. otros nodos.
      • Para cualquier máquina con varios componentes de Edge (Management Server, Message Processor, router, servidor QPID pero no servidor de Postgres), usa la opción -c edge para actualizar 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.00, haz lo siguiente:

      1. Actualiza todos los componentes:
        /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
      2. (Si instalaste apigee-adminapi) 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 Qpid y Postgres en la máquina 2:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
      3. Actualiza 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 la IU en la máquina 1:
        /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
      6. (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
      7. (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 hiciste lo siguiente: SSO instalado.

      8. 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 Qpid y Postgres en la máquina 4:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
      3. Actualiza Qpid y Postgres en la máquina 5:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
      4. Actualiza 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 la IU de Edge:
        • IU clásica: Si usas la IU clásica, actualiza los archivos 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 la 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
      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 hiciste lo siguiente: SSO instalado.

      9. Reinicia el componente de IU:
        • IU clásica: Si usas la IU clásica, reinicia la 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 la edge-management-ui en la máquina adecuada (puede no ser una 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 el Qpid en las máquinas 6 y 7:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      3. Actualiza Postgres en la máquina 8:
        /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      4. Actualiza Postgres en la máquina 9:
        /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      5. Actualiza LDAP en la máquina 1:
        /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
      6. 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
      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 hiciste lo siguiente: SSO instalado.

      10. Reinicia el componente de IU:
        • IU clásica: Si usas la IU clásica, reinicia la 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 la edge-management-ui en la máquina adecuada (puede no ser una 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 el Qpid en las máquinas 12 y 13:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      3. Actualiza Postgres en la máquina 8:
        /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      4. Actualiza Postgres en la máquina 9:
        /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      5. Actualiza LDAP en las máquinas 4 y 5:
        /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
      6. 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
      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 hiciste lo siguiente: SSO instalado.

      10. Reinicia el componente de IU:
        • IU clásica: Si usas la IU clásica, reinicia la 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 la 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, ocurre lo siguiente:
          /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. Actualizar 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 del 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
      3. 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
      4. 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
      5. 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
      6. Actualiza la IU nueva (ue) o la IU clásica (ui):
        1. Máquina 1 del 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 del 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 del 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 hiciste lo siguiente: SSO instalado.

      9. Reinicia la nueva IU 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 los siguientes pasos: pedido:

      1. ZooKeeper
      2. Cassandra
      3. qpidd, ps
      4. LDAP
      5. Edge, que significa "-c borde". en todos los nodos en el orden: nodos con servidor Qpid, Servidor de Edge Postgres, servidor de administración, procesador de mensajes y router.
      6. IU de Edge (clásica o nueva)
      7. apigee-adminapi
      8. SSO de Apigee

      Después de finalizar la actualización, asegúrate de reiniciar el componente de IU de Edge en todas las máquinas que se ejecutan que la modifica.