Actualiza Apigee Edge 4.17.09 a la versión 4.19.01

Edge para la nube privada v4.19.01

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

  • Del 17/04/09 al 1/19/01

Quién puede realizar la actualización

El usuario que ejecuta la actualización debe ser el mismo que el que instaló Edge o el usuario 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 contiene componentes de varias versiones.

Mantén la compatibilidad

Cuando actualizas Apigee Edge for Private Cloud a la versión 4.19.01, debes asegurarte de que la implementación resultante solo haga referencia a propiedades compatibles en sus archivos de configuración.

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

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

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

Actualización obligatoria a Postgres 9.6

Esta versión de Edge incluye una actualización a Postgres 9.6. Como parte de esa actualización, todos 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 de instancia principal en espera. Durante el proceso de actualización, mientras los nodos de Postgres no se actualizan, los datos de estadísticas aún se escriben en los nodos de Qpid. Después de que los nodos de Postgres se actualizan y se vuelven a poner en línea, los datos de estadísticas se envían a los nodos de Postgres.

La forma en la que realizas la actualización de Postgres depende de cómo configuraste el almacenamiento de datos para tus nodos de Postgres:

  • Si usas el almacenamiento de datos local para los nodos de Postgres, debes instalar un nodo en espera de Postgres nuevo mientras dure la actualización. Una vez que se complete la actualización, puedes retirar el nuevo nodo en espera de Postgres.

    Se requiere el nodo en espera adicional de Postgres si tienes que revertir la actualización por algún 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 instalas el nuevo nodo en espera de Postgres, este debe estar en un nodo que cumpla con todos los requisitos de hardware de un servidor de Postgres, como se define en los requisitos de instalación de Edge.

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

  • Si usas almacenamiento en red para tus nodos de Postgres, como lo recomienda Apigee, no tienes que instalar un nodo nuevo de Postgres. En los procedimientos que aparecen a continuación, puedes omitir los pasos que especifican la instalación y posterior retiro de un nodo en espera de Postgres nuevo.

    Antes de comenzar el proceso de actualización, toma una instantánea de la 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, podrás restablecer el nodo de Postgres a partir de esa instantánea.

Instala un nodo en espera de Postgres nuevo

En este procedimiento, se crea un servidor en espera de Postgres en un nodo nuevo. Asegúrate de instalar un servidor en espera de Postgres nuevo para la versión existente de Edge (4.17.09), no para la versión 4.19.01.

A fin de 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 actual de Postgres, edita el archivo /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 servidor en espera de Postgres actual 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 nuevo nodo en espera se haya agregado mediante la visualización del archivo /opt/apigee/apigee-postgresql/conf/pg_hba.conf en la instancia 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 en espera de Postgres:
    1. Edita el archivo de configuración que usaste para instalar tu versión actual de Edge a fin de especificar 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 apigee-setup de Edge.
    3. Descarga el archivo Boot_4.17.09.sh de Edge a /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 apigee-service y las dependencias 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 nuevo nodo en espera, ejecuta el siguiente comando:
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Valida que indique que es en espera.

Retiro de servicio de un nodo de Postgres

Una vez que se complete la actualización, retira 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 mediante la ejecución del siguiente comando curl en el nodo en espera nuevo:
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

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

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

  3. Detén el nodo en espera nuevo mediante la ejecución del 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. Verifica que el nodo en espera nuevo se haya quitado. Para ello, visualiza el archivo /opt/apigee/apigee-postgresql/conf/pg_hba.conf en la instancia principal. En ese archivo, solo deberías ver la siguiente línea:
    host replication apigee existing_standby_ip/32 trust
  7. Borra el UUID del nodo en espera de ZooKeeper mediante la siguiente llamada a la API de administración perimetral en el nodo del servidor de administración:
    curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

Actualiza los requisitos previos

Ten en cuenta los siguientes requisitos previos antes de actualizar Apigee Edge:

  • Crea una copia de seguridad de todos los nodos
    Antes de realizar la actualización, se recomienda realizar una copia de seguridad completa de todos los nodos por motivos de seguridad. 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 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
    Asegúrate de que Edge esté en funcionamiento durante el proceso de actualización con el siguiente comando:
    /opt/apigee/apigee-service/bin/apigee-all status

Manejo de actualizaciones con errores

En caso de que falle la actualización, puedes intentar corregir el problema y volver a ejecutar update.sh. Puedes ejecutar la actualización varias veces para continuarla desde donde se interrumpió por última vez.

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

Información de actualización de registros

De forma predeterminada, la utilidad update.sh escribe información de registro en la siguiente ubicación:

/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, falla la utilidad update.sh.

Actualización sin tiempo de inactividad

Una actualización sin tiempo de inactividad, o actualización progresiva, te permite actualizar la configuración de Edge sin interrumpir Edge.

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

La clave para actualizar 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 este y, luego, vuelve a agregarlo al balanceador de cargas.

  1. Actualiza las máquinas en el orden correcto para tu configuración, como se describe en Actualización del orden de máquina.
  2. Cuando llegue el momento de actualizar los routers, selecciona cualquier router y haz que sea inaccesible, como se describe en Cómo habilitar o inhabilitar la accesibilidad del servidor (procesador de mensajes/routers).
  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. Vuelve a establecer la conexión con el router.
  5. Repite del paso 2 al 4 para los routers restantes.
  6. Continúa la actualización de las máquinas restantes en tu configuración.

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

  • En el nodo combinado del router y el procesador de mensajes, haz lo siguiente:
    • 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 el acceso al Message Processor.
      2. Haz que el router sea accesible.
  • En un solo nodo de router, haz lo siguiente:
    • 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, haz lo siguiente:
    • Antes de la actualización, haz que no se pueda acceder al procesador de mensajes.
    • Después de la actualización, haz que el procesador de mensajes esté accesible.

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

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

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

  2. Si está presente, inhabilita los trabajos CRON configurados para realizar una operación de reparación en Cassandra hasta que se complete 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 Instala la utilidad apigee-setup de Edge.
  6. Si instalas Oracle 7.x, ejecuta el siguiente comando:
    sudo yum-config-manager --enable ol7_optional_latest
  7. 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
  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 recibió de Apigee. Si omites pWord, se te solicitará que lo ingreses.

    De forma predeterminada, el instalador verifica si tienes Java 1.8 instalado. Si no lo haces, la instala 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 = Instalar OpenJDK 1.8 (predeterminado)
    • C = Continuar sin instalar Java
    • P = 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 máquina:
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    El único requisito sobre el archivo de configuración es que el usuario de “apigee” debe poder acceder o leer este archivo.

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

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

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

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  14. Reinicia el componente de IU de Edge en todas las máquinas que lo ejecutan, si aún no lo hiciste:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  15. Prueba la actualización mediante la ejecución de la utilidad apigee-validate en el servidor de administración, como se describe en Prueba la instalación.
  16. Si instalaste un nodo en espera de Postgres nuevo, retira el nodo como se describe en Retira de servicio un nodo de Postgres.

    Si usas el almacenamiento en 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 Revertir 4.19.01.

Actualiza a la versión 4.19.01 desde un repositorio local

Si tus nodos perimetrales están detrás de un firewall o se les prohíbe de alguna otra manera acceder al repositorio de Apigee en Internet, puedes realizar la actualización desde un repositorio o una duplicación local del repositorio de Apigee.

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

  • Crea un archivo .tar del repositorio, copia el archivo .tar 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 el tuyo propio.

Sigue estos pasos para actualizar desde un repositorio 4.19.01 local:

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

    Si usas el almacenamiento en red, no tienes que instalar el nodo nuevo. En su lugar, toma una instantánea de la red del almacén de datos que usa Postgres. Consulta Actualización obligatoria 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 apigee-setup de Edge.
  3. Para instalar apigee-service desde un archivo .tar:
    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 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.19.01tar.gz

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

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

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

  4. Para instalar apigee-service con el servidor web Nginx, sigue estos pasos:
    1. Configura el servidor web Nginx como se describe en “Instala desde el repositorio con el servidor web Nginx” en Instala la utilidad apigee-setup de Edge.
    2. En el nodo remoto, descarga el archivo bootstrap_4.19.01.sh de Edge en /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

      Donde uName:pWord son el nombre de usuario y la contraseña que configuraste antes para el repositorio, y remoteRepo es la dirección IP o el nombre de DNS del nodo del repositorio.

    3. En el nodo remoto, instala la utilidad apigee-service y las dependencias de Edge:
      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 máquina:
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    El único requisito sobre el archivo de configuración es que el usuario de “apigee” debe poder acceder o leer este archivo.

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

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

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

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  9. Reinicia el componente de IU de Edge en todas las máquinas que lo ejecutan, si aún no lo hiciste:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  10. Prueba la actualización mediante la ejecución de la utilidad apigee-validate en el servidor de administración, como se describe en Prueba la instalación.
  11. Si instalaste un nodo en espera de Postgres nuevo, retira el nodo como se describe en Retira de servicio un nodo de Postgres.

    Si usas el almacenamiento en red, no tienes que instalar el nodo nuevo. Consulta Actualización obligatoria 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 Revertir 4.19.01.

Actualización del orden de la máquina

El orden en el que actualizas las máquinas en una configuración de Edge es importante. Las consideraciones más importantes para una actualización son las siguientes:

  • Debes actualizar todos los nodos de Cassandra y ZooKeeper antes de actualizar cualquier otro nodo.
  • En el caso de cualquier máquina con varios componentes de Edge (servidor de administración, procesador de mensajes, router, servidor de QPID, pero no servidor de Postgres), usa la opción “-c perimetral” para actualizarlos todos al mismo tiempo.
  • Si un paso especifica que debe realizarse en varias máquinas, hazlo en el orden especificado de la máquina.
  • No hay un paso separado para actualizar la monetización. Se actualiza cuando especificas la opción "-c perimetral".

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 de Postgres, el servidor de 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 de Edge restantes:
    /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 instalaste el SSO.

  10. Reinicia el componente de 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 topologías de Edge y los 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 Qpid en la máquina 2:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -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 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 instalaste el SSO.

  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 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 topologías de Edge y los números de nodos.

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

    Si usas el almacenamiento en red, no tienes que instalar el nodo nuevo. En su lugar, toma una instantánea de la red del almacén de datos que usa Postgres. Consulta Actualización obligatoria 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 la máquina 4 y 5:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -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 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 instalaste el SSO.

  9. Actualiza las máquinas 4 y 5:
    1. Detén el servidor de 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 el nodo en espera nuevo 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 máquinas 4:
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    5. Actualiza postgresql en máquinas 5:
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Inicia el servidor de Postgres y el servidor de 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 sistema debería mostrar resultados idénticos en ambos servidores para garantizar una replicación exitosa:
      • En la máquina 4, el nodo principal, ejecuta:
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        Valida que indique que es el principal.

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

        Valida que indique que es en espera.

  10. Actualizar 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 Retira de servicio un nodo de Postgres.

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

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

Actualización agrupada en clústeres de 9 nodos

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

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

    Si usas el almacenamiento en red, no tienes que instalar el nodo nuevo. En su lugar, toma una instantánea de la red del almacén de datos que usa Postgres. Consulta Actualización obligatoria 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 la máquina 6 y 7:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -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, 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 instalaste el SSO.

  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 de 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 de 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 el nodo en espera nuevo 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 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 sistema debería mostrar resultados idénticos en ambos servidores para garantizar una replicación exitosa:
      • En la máquina 8, el nodo principal, ejecuta:
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        Valida que indique que es el principal.

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

        Valida que indique que es en 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 Retira de servicio un nodo de Postgres.

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

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

Actualización agrupada en clústeres de 13 nodos

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

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

    Si usas el almacenamiento en red, no tienes que instalar el nodo nuevo. En su lugar, toma una instantánea de la red del almacén de datos que usa Postgres. Consulta Actualización obligatoria 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 la máquina 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 la máquina 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 instalaste el SSO.

  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 de 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 de 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 el nodo en espera nuevo 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 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 sistema debería mostrar resultados idénticos en ambos servidores para garantizar una replicación exitosa:
      • En la máquina 8, el nodo principal, ejecuta:
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        Valida que indique que es el principal.

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

        Valida que indique que es en 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 Retira de servicio un nodo de Postgres.

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

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

Actualización agrupada en clústeres de 12 nodos

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

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

    Si usas el almacenamiento en red, no tienes que instalar el nodo nuevo. En su lugar, toma una instantánea de la 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:
    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
  3. Actualiza qpidd:
    1. Machines 4, 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. Repite el paso 1 en la máquina 5.
    2. Machines 10, 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. Repite el paso 1 en la máquina 11.
  4. Actualiza el LDAP:
    1. Machines 1 en el centro de datos 1
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. Machines 7 in Data Center 2
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Actualiza los componentes de Edge:
    1. Machines 4, 5, 1, 2, 3 en el centro de datos 1
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. Machines 10, 11, 7, 8, 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 en el 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 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 Edge) Actualiza el SSO de Edge:
    1. Máquina 1 en el centro de datos 1:
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    2. Máquina 7 en el centro de datos 2:
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    3. En el ejemplo anterior, sso_config_file es el archivo de configuración que creaste cuando instalaste el SSO.

  9. Actualiza la máquina 6 en el centro 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 de 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 de 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 el nodo en espera nuevo 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 6:
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Actualiza postgresql en 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 sistema debe mostrar resultados idénticos en ambos servidores para garantizar una replicación exitosa:

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

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

      Valida que indique que es el principal.

      En la máquina 12, el nodo en espera hace lo siguiente:

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

      Valida que indique que es en 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 Retira de servicio un nodo de Postgres.

    Si usas el almacenamiento en 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 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 el siguiente orden:

  1. ZooKeeper
  2. Cassandra
  3. qpidd, ps
  4. LDAP
  5. Edge, que significa el perfil “-c perimetral” en todos los nodos del orden: nodos con el servidor Qpid, servidor Edge Postgres, servidor de administración, procesador de mensajes y router.
  6. IU de Edge
  7. apigee-adminapi
  8. SSO perimetral

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