Actualiza Apigee Edge 4.17.09 a la versión 4.19.01

Edge for Private Cloud v4.19.01

En esta sección, se describe cómo realizar las siguientes actualizaciones:

  • Del 17/4/09 al 19/01

Quién puede realizar la actualización

El usuario que ejecuta la actualización debe ser el mismo que el que instaló originalmente Edge. usuario que se ejecuta con permisos de administrador.

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

Cómo mantener la compatibilidad

Cuando actualices Apigee Edge para la nube privada a la versión 4.19.01, debes asegurarte de que el La implementación resultante solo hace referencia a propiedades admitidas en sus archivos de configuración.

Propiedad Ubicación Descripción
conf_load_balancing_load.balancing.
  driver.nginx.server.retry		 router.properties Quita esta propiedad del archivo router.properties. Para establecer opciones de reintento en 4.19.01, usa la clase virtual propiedades de configuración del host.

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

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

Actualización necesaria a Postgres 9.6

Esta versión de Edge incluye una actualización a Postgres 9.6. Como parte de esa actualización, Los datos de Postgres se migran a Postgres 9.6.

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.17.09) no para la versión 4.19.01.

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

      Valida que indique que es el modo de espera.

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

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, se recomienda realizar una copia de seguridad completa de todos los nodos 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

Cómo manejar una actualización con errores

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

Si el error requiere que reviertas la actualización a tu versión anterior, consulta Revierte la versión 4.19.01 para obtener más opciones.

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 el usuario 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 el usuario 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 configuració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 tu configuración, como se describe en 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 (Procesador de mensajes/router) Accesibilidad.
  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 para las máquinas restantes en tu configuración.

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

  • En el router combinado del nodo del procesador de los mensajes:
    • Antes de la actualización, haz lo siguiente:
      1. Haz que el router sea inaccesible.
      2. Hacer que el procesador de mensajes sea inaccesible.
    • Después de la actualización, haz lo siguiente:
      1. Permite que el procesador de mensajes sea accesible.
      2. Haz que el router sea accesible.
  • En un solo nodo de router:
    • Antes de la actualización, haz que no se pueda acceder al router.
    • Después de la actualización, haz que el router sea accesible.
  • En un solo nodo de Message Processor:
    • Antes de la actualización, haz que no se pueda acceder al procesador de mensajes.
    • Después de la actualización, permite que el procesador de mensajes sea accesible.

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

Actualizar a 4.19.01 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 actualmente usas la replicación en espera principal de Postgres con almacenamiento local, instalar un nodo de Postgres nuevo como se describe en Instala un nodo de Postgres nuevo en espera.

    Si usas almacenamiento de red, no tienes que instalar el nodo nuevo. En cambio, toma un instantánea de red del almacén de datos que usa Postgres. Consulta Actualización necesaria a Postgres 9.6 para obtener más información

  2. Si está presente, inhabilita los trabajos de CRON configurados para realizar una operación de reparación en Cassandra. hasta que finalice la actualización.
  3. Accede a tu nodo como raíz para instalar los RPM de Edge.
  4. Instala yum-utils y yum-plugin-priorities: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  5. Inhabilita SELinux como se describe en Instalación la utilidad de configuración de Apigee de Edge
  6. Si instalas Oracle 7.x, ejecuta el siguiente comando: 
    sudo yum-config-manager --enable ol7_optional_latest
  7. 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
  8. Descarga el archivo bootstrap_4.19.01.sh de Edge 4.19.01 en /tmp/bootstrap_4.19.01.sh 
    curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
  9. Instala la utilidad apigee-service y las dependencias de Edge 4.19.01: 
    sudo bash /tmp/bootstrap_4.19.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 omite pWord, se te solicitará que lo ingreses.

    De forma predeterminada, el instalador comprueba que tengas Java 1.8 instalado. Si no lo haces, la instala por ti. Usa la opción JAVA_FIX para especificar cómo controlar Java instalación. JAVA_FIX acepta los siguientes valores:

    • I = Instalar OpenJDK 1.8 (predeterminado)
    • C = Continuar sin instalar Java
    • Q = Salir. Para esta opción, debes instalar Java por tu cuenta.
  10. Usa apigee-service para actualizar la utilidad apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  11. Actualiza la utilidad apigee-validate en el servidor de administración: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  12. Actualiza la utilidad apigee-provision: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  13. Ejecuta la utilidad de actualización 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

    El único requisito del archivo de configuración es que se debe poder acceder a él o sean legibles por el servicio de “Apigee” usuario.

    Usa la opción -c para especificar el componente que deseas actualizar. La lista de posibles incluye lo siguiente:

    • “cs” = Cassandra
    • "borde" =Todos los componentes de Edge, excepto la IU de Edge. El "perímetro" el componente incluye servidor de administración, procesador de mensajes, router, servidor QPID, servidor perimetral de Postgres.
    • "ldap" = OpenLDAP
    • “ps” = postgresql
    • “qpid” = qpidd
    • “sso” = SSO perimetral
    • “IU” = IU de Edge
    • “zk” = cuidador del zoológico

    Puedes ejecutar update.sh en todos los componentes si configuras component. en “all”, pero solo si tienes un perfil de configuración de Edge todo en uno (AIO). Por ejemplo:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  14. Si aún no lo hiciste, reinicia el componente de IU de Edge en todas las máquinas que lo ejecutan: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  15. Ejecuta la utilidad apigee-validate en la Administración para probar la actualización Servidor, como se describe en Prueba la instalación.
  16. Si instalaste un nodo en espera de Postgres nuevo, retíralo como se describe en Cómo retirar de servicio un Nodo de Postgres.

    Si usas almacenamiento de red, no tienes que instalar el nodo nuevo. Consulta Actualización necesaria a Postgres 9.6 para obtener más opciones

Para revertir la actualización más tarde, usa el procedimiento que se describe en Revierte el 19/4/1.

Actualización a 4.19.01 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.19.01, haz lo siguiente:

  1. Si actualmente usas la replicación en espera principal de Postgres, instala una instancia nueva de Postgres nodo en espera, como se describe en Instala un nuevo en espera.

    Si usas almacenamiento de red, no tienes que instalar el nodo nuevo. En cambio, toma un instantánea de red del almacén de datos que usa Postgres. Consulta Actualización necesaria a Postgres 9.6 para obtener más información

  2. Crea un repositorio local 4.19.01 como se describe en “Crea un repositorio local de Apigee” en Instala la utilidad de Apigee-setup de Edge.
  3. 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.19.01.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.19.01tar.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 de Edge apigee-service desde /tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.19.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

  4. 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" en Install the Edge apigee-setup.
    2. En el nodo remoto, descarga el archivo bootstrap_4.19.01.sh de Edge para /tmp/bootstrap_4.19.01.sh 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.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-service de Edge y dependencias: 
      sudo bash /tmp/bootstrap_4.19.01.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.

  5. Usa apigee-service para actualizar la utilidad apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  6. Actualiza la utilidad apigee-validate en el servidor de administración: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  7. Actualiza la utilidad apigee-provision: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  8. 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

    El único requisito del archivo de configuración es que se debe poder acceder a él o sean legibles por el “Apigee” usuario.

    Usa la opción -c para especificar el componente que deseas actualizar. La lista de posibles incluye lo siguiente:

    • “cs” = Cassandra
    • "borde" =Todos los componentes de Edge, excepto la IU de Edge. El "perímetro" el componente incluye servidor de administración, procesador de mensajes, router, servidor QPID, servidor perimetral de Postgres.
    • "ldap" = OpenLDAP
    • “ps” = postgresql
    • “qpid” = qpidd
    • “sso” = SSO perimetral
    • “IU” = IU de Edge
    • “zk” = cuidador del zoológico

    Puedes ejecutar update.sh en todos los componentes si configuras component. en “all”, pero solo si tienes un perfil de configuración de Edge todo en uno (AIO). Por ejemplo:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  9. Si aún no lo hiciste, reinicia el componente de IU de Edge en todas las máquinas que lo ejecutan: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  10. Ejecuta la utilidad apigee-validate en la Administración para probar la actualización Servidor, como se describe en Prueba la instalación.
  11. Si instalaste un nodo en espera de Postgres nuevo, retíralo como se describe en Retiro de servicio un nodo de Postgres.

    Si usas almacenamiento de red, no tienes que instalar el nodo nuevo. Consulta Actualización necesaria a Postgres 9.6 para obtener más información

Para revertir la actualización más tarde, usa el procedimiento que se describe en Cómo revertir la actualización 4.19.01.

Orden de actualización de la máquina

El orden en que se actualizan las máquinas en una configuración de Edge es importante. El más consideraciones importantes sobre una actualización son:

  • 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 Postgres), usa "-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 el valor "-c borde" de 12 a 1 con la nueva opción de compresión.

Actualización independiente de 1 nodo

  1. Actualiza Cassandra y ZooKeeper: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Actualizar Qpid: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Actualiza el LDAP: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Detén el servidor Postgres, el servidor Qpid y PostgreSQL: 
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
  5. Actualiza postgresql: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  6. Actualiza los componentes restantes de Edge: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Actualiza la IU de Edge: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. (Si instalaste apigee-adminapi) Se actualizó la utilidad apigee-adminapi: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Si instalaste el SSO de Edge) Actualiza el SSO de Edge: 
    /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 la IU de Edge: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Actualización independiente de 2 nodos

Consulta Topologías de instalación para ver la lista de Edge topologías 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 el Qpid en la máquina 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -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 la máquina 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 Edge) Actualiza el SSO de Edge 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. Actualiza postgresql en la máquina 2:
    1. Detén el servidor Postgres, el servidor Qpid y postgresql:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    2. Actualiza postgresql: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    3. Actualiza los componentes de Edge en la máquina 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  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

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

  1. Asegúrate de haber instalado un nuevo nodo de Postgres en espera como se describe en Instalación un nuevo nodo en espera de Postgres

    Si usas almacenamiento de red, no tienes que instalar el nodo nuevo. En cambio, toma un instantánea de red del almacén de datos que usa Postgres. Consulta Actualización necesaria a Postgres 9.6 para obtener más información

  2. Actualiza Cassandra y ZooKeeper en las máquinas 1, 2 y 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Actualiza el Qpid en las máquinas 4 y 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -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 1, 2 y 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -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 Edge) Actualiza el SSO de Edge 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. Actualiza las máquinas 4 y 5:
    1. Detén el servidor Postgres y el servidor Qpid en la máquina 4:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    2. Detén el servidor Postgres, el servidor Qpid y postgresql en la máquina 5: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Si está instalado, detén el servidor de Postgres y postgresql en la nueva instancia en espera que agregaste para la reversión: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    4. Actualiza postgresql en las máquinas 4: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    5. Actualiza postgresql en las máquinas 5: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Inicia el servidor Postgres y el servidor Qpid en las máquinas 4 y 5: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    7. Configura Postgres como un nodo en espera ejecutando los siguientes comandos en la máquina 5: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    8. Verifica el estado de replicación mediante la emisión de las siguientes secuencias de comandos en ambos servidores. El el sistema debe mostrar resultados idénticos en ambos servidores para garantizar una replicación exitosa:
      • En la máquina 4, el nodo principal, ejecuta lo siguiente: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        Valida que indique que es la instancia principal.

      • En la máquina 5, el nodo en espera realiza las siguientes acciones: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        Valida que indique que es el modo de espera.

  10. Actualiza los componentes de Edge en las máquinas 4 y 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. Asegúrate de retirar el nodo en espera nuevo como se describe en Retiro de servicio un nodo de Postgres.

    Si usas almacenamiento de red, no tienes que instalar el nodo nuevo. Consulta Actualización necesaria a Postgres 9.6 para obtener más información

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

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

  1. Asegúrate de haber instalado un nodo en espera de Postgres nuevo como se describe en Instalación un nuevo nodo en espera de Postgres

    Si usas almacenamiento de red, no tienes que instalar el nodo nuevo. En cambio, toma un instantánea de red del almacén de datos que usa Postgres. Consulta Actualización necesaria a Postgres 9.6 para obtener más información

  2. Actualiza Cassandra y ZooKeeper en las máquinas 1, 2 y 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Actualiza Qpid en las máquinas 6 y 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -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 6, 7, 1, 4 y 5 en ese orden: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -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 Edge) Actualiza el SSO de Edge 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. Actualiza las máquinas 8 y 9:
    1. Detén el servidor de Postgres en la máquina 8: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Detén el servidor Postgres y postgresql en la máquina 9: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Detén el servidor Qpid en las máquinas 6 y 7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. Si está instalado, detén el servidor de Postgres y postgresql en la nueva instancia en espera que agregaste para la reversión: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. Actualiza postgresql en máquinas 8: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Actualiza postgresql en las máquinas 9: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. Inicia el servidor de Postgres en las máquinas 8 y 9: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    8. Inicia el servidor del servidor Qpid en las máquinas 6 y 7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    9. Configura Postgres como un nodo en espera ejecutando los siguientes comandos en la máquina 9: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    10. Verifica el estado de replicación mediante la emisión de las siguientes secuencias de comandos en ambos servidores. El el sistema debe mostrar resultados idénticos en ambos servidores para garantizar una replicación exitosa:
      • En la máquina 8, el nodo principal, ejecuta lo siguiente: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        Valida que indique que es la instancia principal.

      • En la máquina 9, el nodo en espera realiza las siguientes acciones: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        Valida que indique que es el modo de espera.

  10. Actualiza los componentes de Edge en las máquinas 8 y 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. Asegúrate de retirar el nodo en espera nuevo como se describe en Retiro de servicio un nodo de Postgres.

    Si usas almacenamiento de red, no tienes que instalar el nodo nuevo. Consulta Actualización necesaria a Postgres 9.6 para obtener más información

  12. 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 13 nodos en clústeres

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

  1. Asegúrate de haber instalado un nodo en espera de Postgres nuevo como se describe en Instalación un nuevo nodo en espera de Postgres

    Si usas almacenamiento de red, no tienes que instalar el nodo nuevo. En cambio, toma un instantánea de red del almacén de datos que usa Postgres. Consulta Actualización necesaria a Postgres 9.6 para obtener más información

  2. Actualiza Cassandra y ZooKeeper en las máquinas 1, 2 y 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Actualiza el Qpid en las máquinas 12 y 13: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -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, 6, 7, 10 y 11 en ese orden: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Actualiza la IU en las máquinas 6 y 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (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
  8. (Si instalaste el SSO de Edge) Actualiza el SSO de Edge 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.

  9. Actualiza las máquinas 8 y 9:
    1. Detén el servidor de Postgres en la máquina 8: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Detén el servidor Postgres y postgresql en la máquina 9: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Detén el servidor Qpid en las máquinas 12 y 13: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. Si está instalado, detén el servidor de Postgres y postgresql en la nueva instancia en espera que agregaste para la reversión: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. Actualiza postgresql en máquinas 8: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Actualiza postgresql en las máquinas 9: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. Inicia el servidor de Postgres en las máquinas 8 y 9: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    8. Inicia el servidor del servidor Qpid en las máquinas 12 y 13: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    9. Configura Postgres como un nodo en espera ejecutando los siguientes comandos en la máquina 9: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    10. Verifica el estado de replicación mediante la emisión de las siguientes secuencias de comandos en ambos servidores. El el sistema debe mostrar resultados idénticos en ambos servidores para garantizar una replicación exitosa:
      • En la máquina 8, el nodo principal, ejecuta lo siguiente: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        Valida que indique que es la instancia principal.

      • En la máquina 9, el nodo en espera realiza las siguientes acciones: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        Valida que indique que es el modo de espera.

  10. Actualiza los componentes de Edge en las máquinas 8 y 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. Asegúrate de retirar el nodo en espera nuevo como se describe en Retiro de servicio un nodo de Postgres.

    Si usas almacenamiento de red, no tienes que instalar el nodo nuevo. Consulta Actualización necesaria a Postgres 9.6 para obtener más información

  12. Reinicia el componente de la IU de Edge en las máquinas 6 y 7: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Actualización de 12 nodos en clústeres

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

  1. Asegúrate de haber instalado un nodo en espera de Postgres nuevo como se describe en Instalación un nuevo nodo en espera de Postgres.

    Si usas almacenamiento de red, no tienes que instalar el nodo nuevo. En cambio, toma un instantánea de red del almacén de datos que usa Postgres. Consulta Actualización necesaria a Postgres 9.6 para obtener más opciones

  2. 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
  3. 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. Repite el paso 1 en la máquina 5.
    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. Repite el paso 1 en la máquina 11.
  4. Actualiza el LDAP:
    1. Máquinas 1 en el centro de datos 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. Máquinas 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, 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, 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:
    1. Máquina 1 del centro de datos 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    2. Máquina 7 en el centro de datos 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -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 Edge) Actualiza el SSO de Edge:
    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. Actualiza la máquina 6 en los centros de datos 1 y 12 en el centro de datos 2:
    1. Detén el servidor de Postgres en la máquina 6: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Detén el servidor Postgres y postgresql en la máquina 12: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Detén el servidor Qpid en las máquinas 4, 5, 10 y 11: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. Si está instalado, detén el servidor de Postgres y postgresql en la nueva instancia en espera que agregaste para la reversión: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. Actualiza postgresql en las máquinas 6: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Actualiza postgresql en las máquinas 12: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. Inicia el servidor de Postgres en las máquinas 6 y 12: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    8. Inicia el servidor del servidor Qpid en las máquinas 4, 5, 10 y 11: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    9. Configura Postgres como un nodo en espera ejecutando los siguientes comandos en la máquina 12: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    10. Verifica el estado de replicación mediante la emisión de las siguientes secuencias de comandos en ambos servidores. El el sistema debe mostrar resultados idénticos en ambos servidores para garantizar un replicación:

      En la máquina 6, el nodo principal, ejecuta lo siguiente:

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Valida que indique que es la instancia principal.

      En la máquina 12, el nodo en espera realiza las siguientes acciones:

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Valida que indique que es el modo de espera.

  10. Actualiza los componentes de Edge en las máquinas 6 y 12: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. Asegúrate de retirar el nodo en espera nuevo como se describe en Retiro de servicio de Postgres en la nube.

    Si usas almacenamiento de red, no tienes que instalar el nodo nuevo. Consulta Actualización necesaria a Postgres 9.6 para obtener más opciones

  12. Reinicia el componente de la IU de Edge en las máquinas 1 y 7: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Para una actualizació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
  7. apigee-adminapi
  8. SSO perimetral

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.