Actualiza Apigee Edge 4.16.01/4.16.05 a 4.17.09

Edge for Private Cloud v. 4.17.09

A qué versiones de Edge puedes actualizar a la 4.17.09

Puedes actualizar las versiones de Apigee Edge 4.16.01.0x y 4.16.05.x a 4.17.09 con este procedimiento.

Si tienes una versión de Edge anterior a la 4.16.01, primero debes migrar a la versión 4.16.01 y, luego, actualizar a la versión 4.17.09.

  • Puedes migrar la versión 4.15.07 de Apigee Edge a la 4.16.01.
  • Si tienes una versión de Edge anterior a la 4.15.07, primero debes migrar a la versión 4.15.07 y, luego, a la 4.16.01.
    • Si migras desde la versión 4.14.04 de Edge o una posterior, migra directamente a la versión 4.15.07.
    • Si migras desde la versión 4.14.01 de Edge, primero debes migrar a la versión 4.14.04 y, luego, a la versión 4.15.07.

Quién puede realizar la actualización

El usuario que ejecuta la actualización debe ser el mismo que instaló Edge originalmente o un usuario que se ejecute como root.

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 contenga componentes de varias versiones.

Cómo revertir la versión de Zookeeper si actualizas desde 4.16.01

La versión del RPM de Zookeeper en Edge for Private Cloud 4.16.01 es apigee-zookeeper-3.4.5-1.0.905.noarch.rpm. En versiones posteriores de Edge, la versión de Zookeeper se volvió a cambiar a apigee-zookeeper-3.4.5-0.0.94x. Esto evita que yum actualice Zookeeper a una versión posterior a partir de la 4.16.01. La forma de corregir esta situación es ejecutar yum downgrade apigee-zookeeper antes de actualizar Zookeeper.

Puedes comprobar la versión de Zookeeper con el siguiente comando:

> rpm -qa |grep apigee-zookeeper

Si este comando muestra la versión de Zookeeper, haz lo siguiente:

apigee-zookeeper-3.4.5-1.0.905

Luego, debes realizar la baja de versión.

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

Si configuraste alguna propiedad editando los archivos .properties en /opt/apigee/customer/application, la actualización retendrá estos valores.

Actualizar 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 actualizar, se recomienda crear una copia de seguridad completa de todos los nodos por motivos de seguridad. Usa el procedimiento de la versión actual de Edge para crear la copia de seguridad.

    Esto te permite tener un plan de respaldo en caso de que la actualización a una versión nueva no funcione correctamente. Para obtener más información sobre las copias de seguridad, consulta Copia de seguridad y restablecimiento.
  • Asegúrate de que Edge esté en ejecución
    Usa el siguiente comando para asegurarte de que Edge esté en ejecución durante el proceso de actualización:

    > /opt/apigee/apigee-service/bin/apigee-all status

Cómo manejar una actualización fallida

Si se produce un error en la actualización, puedes intentar corregir el problema y, luego, volver a ejecutar update.sh. Puedes ejecutar la actualización varias veces y esta continuará desde donde se detuvo por última vez.

Si la falla requiere que reviertas la actualización a la versión anterior, consulta el Proceso de reversión de 4.17.09 para obtener más información.

Información de actualización de registro

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

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

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

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

Actualización obligatoria a la versión 8 del JDK de Java

Esta versión de Edge requiere que hayas instalado la versión 8 del JDK de Java en todos los nodos de procesamiento de Edge. Puedes instalar Oracle JDK 8 o OpenJDK 8. Si aún no está instalado Java JDK 8, la secuencia de comandos de actualización puede instalarlo por ti.

Como parte de la actualización a Java 8, algunos cifrados de TLS ya no están disponibles en Oracle JDK 8. Para obtener la lista completa, consulta la sección "Default Disabled Cipher Suites" en http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.

Obligatorio para habilitar el repositorio EPEL

Debes habilitar Extra Packages for Enterprise Linux (o EPEL) para instalar o actualizar Edge. El comando que uses dependerá de la versión de Red Hat/CentOS:

  • Para Red Hat/CentOS 7.x:
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm
  • Para Red Hat/CentOS 6.x:
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

Adición obligatoria del parámetro de configuración SMTPmailFROM

Edge 4.17.05 agregó un nuevo parámetro obligatorio al archivo de configuración que se usa cuando habilitas un servidor SMTP. Si actualizas desde la versión 4.17.01, debes configurar SMTPMAILFROM en el archivo de configuración cuando habilites el servidor SMTP.

La versión 4.17.09 de la API de BaaS también agregó compatibilidad con la propiedad SMTPMAILFROM. Cuando actualices la API de BaaS, debes configurar SMTPMAILFROM en el archivo de configuración.

Este parámetro tiene el siguiente formato:

SMTPMAILFROM="My Company <myco@company.com>"

Obligatorio si se actualiza cuando se usa la autenticación externa

Puedes integrar un servicio de directorio externo en una instalación existente de Apigee Edge Private Cloud. Esta función está diseñada para funcionar con cualquier servicio de directorio que admita LDAP, como Active Directory, OpenLDAP y otros. Una solución de LDAP externa permite a los administradores del sistema administrar las credenciales de los usuarios desde un servicio de administración de directorios centralizado, externo a sistemas como Apigee Edge que las usan.

Consulta Configuración de autenticación externa para obtener más información.

Cuando se habilita la autenticación externa, la mayoría de los clientes usan el campo de nombre de la cuenta de SAM de Active Directory como nombre de usuario para la autenticación, en lugar de una dirección de correo electrónico que usa el servidor OpenLDAP de Edge.

Si realizaste la integración con un servicio de directorio externo, agrega la siguiente línea a tu archivo de configuración cuando actualices Edge a la versión 4.17.09:

IS_EXTERNAL_AUTH="true"

Esta línea configura Edge para admitir un nombre de cuenta, en lugar de una dirección de correo electrónico, como nombre de usuario.

Actualización requerida a Qpid 1.35

Esta versión incluye una actualización obligatoria de Qpid 1.35. Como parte de la actualización de un nodo Qpid, debes hacer lo siguiente:

  • Bloquea el puerto 5672 en el nodo Qpid para evitar temporalmente que los routers y los procesadores de mensajes escriban en el nodo Qpid. Puedes usar el siguiente comando para bloquear este puerto en el nodo Qpid:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s “nombre de host” -i eth0 -j DROP
  • Espera a que la cola de Qpid se vacíe de mensajes para asegurarte de que el nodo de Qpid haya procesado todos los mensajes antes de la actualización. Usa el siguiente comando para asegurarte de que la cola de mensajes de Qpid esté vacía:
    > qpid-stat -q
  • Actualiza el nodo Qpid.
  • Desbloquea el puerto 5672 en el nodo Qpid para permitir el acceso desde routers y procesadores de mensajes. Puedes usar el siguiente comando para desbloquear este puerto:
    > sudo iptables -F

    Ten en cuenta que, si usas iptables para otras reglas, puedes usar la opción -D a fin de revertir el cambio específico:
    > sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP

Este proceso se describe en detalle a continuación para cada topología de Edge.

Actualización obligatoria a Postgres 9.4

Esta versión de Edge incluye una actualización a Postgres 9.4. Como parte de esa actualización, todos los datos de Postgres se migran a Postgres 9.4.

Durante el proceso de actualización, mientras los nodos de Postgres están inactivos para actualización, 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 vuelven a estar en línea, los datos de las estadísticas se envían a los nodos de Postgres.

El nodo de reserva de Postgres adicional es obligatorio si tienes que revertir la actualización por algún motivo. Si tienes que revertir la actualización, el nuevo nodo de Postgres en espera se convierte en el nodo principal de Postgres después de la reversión. Por lo tanto, cuando instales el nuevo nodo de Postgres en espera, este debería 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.

Cómo instalar un nuevo nodo de Postgres en modo de espera

Este procedimiento crea un servidor de Postgres en espera en un nodo nuevo. Asegúrate de instalar un nuevo servidor de Postgres en espera para tu versión existente de Edge (4.16.01 o 4.16.05), no para la versión 4.17.09.

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 el maestro de Postgres actual, edita el archivo /opt/apigee/customer/application/postgresql.properties para establecer el siguiente token. Si ese archivo no existe, créalo:

    conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust\ \nhost replication apigee new_slave_ip/32 trust

    donde existing_slave_ip es la dirección IP del servidor de Postgres activo actual y new_slave_ip es la dirección IP del nuevo nodo de reserva.
  2. Reinicia apigee-postgresql en la instancia principal de Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. Para verificar que se haya agregado el nuevo nodo de reserva, consulta el archivo /opt/apigee/apigee-postgresql/conf/pg_hba.conf en el nodo principal. Deberías ver las siguientes líneas en ese archivo:
    host replication apigee existing_slave_ip/32 trust
    host replication apigee new_slave_ip/32 trust
  4. Instala el nuevo servidor de Postgres en espera:
    1. Edita el archivo de configuración que usaste para instalar la versión actual de Edge y especifica lo siguiente:

      # dirección IP de la instancia principal actual:
      PG_MASTER=192.168.56.103
      # dirección IP del nodo en espera nuevo
      PG_STANDBY=192.168.56.102
    2. Inhabilita SELinux como se describe en Instala la utilidad apigee-setup de Edge.
    3. Descarga el archivo bootstrap_4.16.05.sh de Edge a /tmp/bootstrap_4.16.05.sh:
      > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh

      Nota: Si actualizas desde la versión 4.16.01, descarga el archivo bootstrap.sh de Edge.
    4. Instala la utilidad apigee-service y las dependencias de Edge:
      > sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
    5. Usa apigee-service para instalar la utilidad de 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 de reserva, ejecuta el siguiente comando:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Verifica que diga que es el nodo de reserva.

Retira un nodo de Postgres

Una vez que se complete la actualización, baja de servicio el nuevo nodo de reserva:

  1. Asegúrate de que Postgres esté en ejecución:
    > /opt/apigee/apigee-service/bin/apigee-all status

    Si Postgres no está en ejecución, inícialo:
    > /opt/apigee/apigee-service/bin/apigee-all start





  3. Ejecuta el siguiente comando en el nuevo nodo de reserva para detenerlo:
    > /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 nuevo nodo de espera de conf_pg_hba_replication.connection:
    conf_pg_hba_replication.connection=host replication apigee existing_slave_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 mediante la visualización del archivo /opt/apigee/apigee-postgresql/conf/pg_hba.conf en la instancia principal. Solo deberías ver la siguiente línea en ese archivo:
    host replication apigee existing_slave_ip/32 trust
  7. Borra el UUID del nodo en espera de ZooKeeper realizando la siguiente llamada a la API de Edge Management en el nodo del servidor de administración:
    > curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

Actualización sin tiempo de inactividad

Una actualización sin tiempo de inactividad, o actualización progresiva, te permite actualizar tu instalación de Edge sin cerrarlo.

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

La clave para realizar la actualización sin tiempo de inactividad es quitar cada router, uno a la vez, del balanceador de cargas. Luego, actualiza el router y cualquier otro componente en la misma máquina que el router y, luego, vuelve a agregarlo al balanceador de cargas.

  1. Actualiza las máquinas en el orden correcto para la instalación como se describe a continuación en “Orden de actualización de máquinas”.
  2. Cuando llegue el momento de actualizar los routers, selecciona uno y haz que no se pueda acceder a él, como se describe en Habilita o inhabilita la accesibilidad del servidor (procesador de mensajes o router).
  3. Actualiza el router seleccionado y todos los demás componentes de Edge en la misma máquina que el router. Todas las configuraciones de Edge muestran un router y un procesador de mensajes en el mismo nodo.
  4. Haz que el router vuelva a estar accesible.
  5. Repite los pasos del 2 al 4 para los routers restantes.
  6. Continúa la actualización en las máquinas restantes de la instalación.

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

  • En el nodo combinado de router y procesador de mensajes:
    • Antes de la actualización, haz lo siguiente:
      1. Hacer que el router no sea accesible
      2. Hacer que el procesador de mensajes no sea accesible
    • 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 el router no sea accesible.
    • 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 el procesador de mensajes no sea accesible.
    • Después de la actualización, asegúrate de que se pueda acceder al procesador de mensajes.

Usa un archivo de configuración silencioso

Debes pasar un archivo de configuración silencioso al comando update. El archivo de configuración silencioso debe ser el mismo que usaste para instalar Edge 4.16.01 o 4.16.05.

Procedimiento para actualizar a la versión 4.17.09 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, instala un nodo en espera de Postgres nuevo como se describe antes en Instala un nodo en espera de Postgres nuevo.
  2. Si está presente, inhabilita los trabajos de 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.
    Nota: Si bien la instalación de RPM requiere acceso de raíz, puedes realizar la configuración de Edge sin acceso de raíz.
  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. Habilita el repositorio EPEL como se describió anteriormente.
  7. Si realizas la instalación en AWS, ejecuta el siguiente comando yum-configure-manager:
    > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  8. Descarga el archivo bootstrap_4.17.09.sh de Edge 4.17.09 a /tmp/bootstrap_4.17.09.sh:
    > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.
  9. Instala la utilidad apigee-service y las dependencias de Edge 4.17.09:
    > sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord

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

    De forma predeterminada, el instalador verifica que tengas instalado Java 1.8. De lo contrario, la instalará por ti. Usa la opción JAVA_FIX para especificar cómo controlar la instalación de Java. JAVA_FIX puede tener 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.
  10. Usa apigee-service para actualizar la utilidad apigee-setup:
    1. Si instalaste la versión 4.16.01 actualizando la versión 4.15.07.0x de Edge, debes instalar la utilidad apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

      Este comando instala la utilidad update.sh en /opt/apigee/apigee-setup/bin.

      Si ya instalaste la utilidad apigee-setup, actualízala:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    2. Si instalaste 4.16.01 directamente, es decir, no realizaste una actualización desde 4.15.07.0x, debes actualizar la utilidad apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      Esta actualización de apigee-service instala la utilidad update.sh en /opt/apigee/apigee-setup/bin.
    3. Si instalaste 4.16.05 directamente o mediante una actualización, debes actualizar la utilidad apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      Esta actualización de apigee-service instala la utilidad update.sh en /opt/apigee/apigee-setup/bin.
  11. Según la versión actual de Edge, debes instalar o actualizar la utilidad apigee-validate en el servidor de administración.
    1. Si actualmente usas Edge 4.16.05, actualiza la utilidad apigee-validate en el servidor de administración:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    2. Si actualmente usas Edge 4.16.01, instala la utilidad apigee-validate en el servidor de administración:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install

      Nota: Si instalaste la utilidad apigee-validate en un nodo de procesador de mensajes cuando instalaste 4.16.01, puedes actualizarla con el siguiente comando en ese nodo:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

      Sin embargo, a partir de la versión 4.16.05 y versiones posteriores, Apigee recomienda que instales y ejecutes la utilidad apigee-validate en el servidor de administración.
    3. Si actualizas desde la versión 4.16.01, edita el archivo de configuración que se pasa a la utilidad apigee-validate. En la versión 4.16.01 de Edge, el archivo de configuración que usa apigee-validate requiere las siguientes propiedades:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGION=dc-1

      En esta versión, el archivo de configuración solo requiere la propiedad APIGEE_ADMINPW. Puedes quitar las otras dos propiedades del archivo.
  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 que se describe a continuación 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 el usuario "apigee" pueda acceder a él o leerlo.

    Usa la opción “-c” para especificar el componente que se actualizará. La lista de componentes posibles incluye lo siguiente:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =Todos los componentes de Edge, excepto la IU de Edge: servidor de administración, procesador de mensajes, router, servidor QPID y servidor Postgres
    ui = IU de Edge
    all = Actualiza todos los componentes de la máquina (solo úsalo para un perfil de instalación de aio de Edge o un perfil de instalación de BaaS de API)
    e = ElasticSearch
    b = API BaaS Stack
    p = Portal de API BaaS
    ebp = ElasticSearch, API BaaS Stack y el portal de API BaaS en el mismo nodo
  14. Para probar la actualización, ejecuta la utilidad apigee-validate en el servidor de administración, como se describe en Cómo probar la instalación.
  15. Si instalaste un nodo en espera de Postgres nuevo, retíralo como se describe en Retiro de servicio de un nodo de Postgres.

Para revertir la actualización más adelante, usa el procedimiento que se describe en Proceso de reversión de 4.17.09.

Procedimiento para actualizar a la versión 4.17.09 desde un repositorio local

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

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

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

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

  1. Si actualmente usas la replicación maestra-en espera de Postgres, instala un nuevo nodo en espera de Postgres como se describió anteriormente en Cómo instalar un nuevo nodo en espera de Postgres.
  2. Crea un repositorio local 4.17.09 como se describe en "Crea un repositorio de Apigee local" en Instala la utilidad apigee-setup de Edge.
    Nota: Si ya tienes un repositorio 4.16.01 o 4.16.05 existente, puedes agregarle el repositorio 4.17.09 como se describe en "Actualiza un repositorio local de Apigee" en Instala la utilidad de configuración de Apigee de Edge.
  3. Para instalar apigee-service desde un archivo .tar, sigue estos pasos:
    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.17.09.tar.gz:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. Copia el archivo .tar en el nodo en el que quieres actualizar Edge. Por ejemplo, cópialo en el directorio /tmp del nodo nuevo.
    3. En el nodo nuevo, descomprime el archivo en el directorio /tmp:
      > tar -xzf apigee-4.17.09.tar.gz

      Este comando crea un directorio nuevo, llamado repos, en el directorio que contiene el archivo .tar. Por ejemplo, /tmp/repos.
    4. Instala la utilidad apigee-service de Edge y las dependencias desde /tmp/repos:
      > sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Ten en cuenta que debes incluir la ruta de acceso al directorio repos 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 "Install from the repo using the Nginx webserver" en Install the Edge utility apigee-setup.
    2. En el nodo remoto, descarga el archivo bootstrap_4.17.09.sh de Edge a /tmp/bootstrap_4.17.09.sh:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh

      donde uName:pWord son el nombre de usuario y la contraseña que estableciste anteriormente para el repo, y remoteRepo es la dirección IP o el nombre DNS del nodo del repo.
    3. En el nodo remoto, instala la utilidad y las dependencias de apigee-service de Edge:
      > sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      donde uName:pWord son el nombre de usuario y la contraseña del repositorio.
  5. Usa apigee-service para actualizar la utilidad apigee-setup:
    1. Si instalaste la versión 4.16.01 actualizando la versión 4.15.07.0x de Edge, debes instalar la utilidad apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

      Este comando instala la utilidad update.sh en /opt/apigee/apigee-setup/bin.

      Si ya instalaste la utilidad apigee-setup, actualízala:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    2. Si instalaste 4.16.01 directamente, lo que significa que no realizaste una actualización desde 4.15.07.0x, debes actualizar la utilidad apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      Esta actualización de apigee-service instala la utilidad /apigee-setup/bin//setup.bin
    3. Si instalaste 4.16.05 directamente o mediante una actualización, debes actualizar la utilidad apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      Esta actualización a apigee-service instala la utilidad update.sh en /opt/apigee/apigee-setup/bin.
  6. Según la versión actual de Edge, debes instalar o actualizar la utilidad apigee-validate en el servidor de administración.
    1. Si actualmente usas Edge 4.16.05, actualiza la utilidad apigee-validate en el servidor de administración:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update






    3. Si actualizas desde la versión 4.16.01, edita el archivo de configuración que se pasa a la utilidad apigee-validate. En la versión 4.16.01 de Edge, el archivo de configuración que usa apigee-validate requería las siguientes propiedades:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGION=dc-1

      En esta versión, el archivo de configuración solo requiere la propiedad APIGEE_ADMINPW. Puedes quitar las otras dos propiedades del archivo.
  7. Actualiza la utilidad apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  8. Ejecuta la utilidad de actualización en tus nodos en el orden que se describe a continuación 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 el usuario "apigee" pueda acceder a él o leerlo.

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










  9. Para probar la actualización, ejecuta la utilidad apigee-validate en el servidor de administración, como se describe en Prueba la instalación.
  10. Si instalaste un nodo en espera de Postgres nuevo, retíralo como se describe en Retiro de servicio de un nodo de Postgres.

Para revertir la actualización más adelante, usa el procedimiento que se describe en Proceso de reversión de 4.17.09.

Orden de actualización de la máquina

El orden en que actualizas las máquinas en una instalació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.
  • Para cualquier máquina con varios componentes de Edge (servidor de administración, procesador de mensajes, router, servidor QPID, pero no servidor de Postgres), usa la opción "-c edge" para actualizarlos todos al mismo tiempo.
  • Si un paso especifica que se debe realizar en varias máquinas, hazlo en el orden de máquinas especificado.
  • No hay un paso independiente para actualizar la monetización. Se actualiza cuando especificas la opción "-c Edge".

Para una instalación independiente de 1 host

  1. Establece SMTPMailFROM en el archivo de configuración si habilitaste SMTP en Edge. Este parámetro tiene el siguiente formato:
    SMTPMailFROM="Mi empresa <myco@company.com>"
  2. Si actualizas desde la versión 4.16.01, cambia a la versión anterior de Zookeeper:
    > yum downgrade apigee-zookeeper
  3. Actualiza Cassandra y ZooKeeper:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Establece la siguiente regla de iptables:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s “nombre de host” -i eth0 -j DROP
  5. Verifica la cola de mensajes de Qpid:
    > qpid-stat -q

    Sigue verificando la cola hasta que el recuento en la columna "msg" sea 0. No puedes actualizar Qpid hasta que se hayan procesado todos los mensajes.
  6. Actualiza qpidd:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Borra iptables:
    > sudo iptables -F
  8. Actualiza LDAP:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. 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
  10. Actualiza postgresql:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  11. Actualiza la base de datos de Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  12. Actualiza los componentes restantes de Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  13. Actualiza la IU de Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Para una instalación independiente de 2 hosts

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

  1. Configura SMTPMAILFROM en tu archivo de configuración si habilitaste SMTP en Edge. Este parámetro tiene el siguiente formato:
    SMTPMAILFROM="Mi empresa <miempresa@empresa.com>"
  2. Si actualizas desde la versión 4.16.01, cambia a la versión anterior de Zookeeper en la máquina 1:
    > yum downgrade apigee-zookeeper
  3. Actualiza Cassandra y ZooKeeper en la máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Establece la siguiente regla de iptables en la máquina 2:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s “nombre de host” -i eth0 -j DROP
  5. Verifica la cola de mensajes de Qpid en la máquina 2:
    > qpid-stat -q

    Sigue verificando la cola hasta que el recuento en la columna "msg" sea 0. No puedes actualizar Qpid hasta que haya procesado todos los mensajes.
  6. Actualiza qpidd en la máquina 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Borra iptables en la máquina 2:
    > sudo iptables -F
  8. Actualiza LDAP en la máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. Actualiza los componentes de Edge en la máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Actualiza la IU en la máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  11. Actualiza postgresql en la máquina 2:
    1. 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
    2. Actualiza PostgreSQL:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    3. Actualiza la base de datos de Postgres:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    4. Actualiza los componentes de Edge en la máquina 2 y en la máquina 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  12. Actualiza los componentes de Edge en la máquina 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Para una instalación de clúster de 5 hosts

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

  1. Configura SMTPMAILFROM en tu archivo de configuración si habilitaste SMTP en Edge. Este parámetro tiene el siguiente formato:
    SMTPMAILFROM="Mi empresa <miempresa@empresa.com>"
  2. Asegúrate de haber instalado un nuevo nodo de Postgres en espera, como se describe más arriba en Instala un nuevo nodo de Postgres en espera.
  3. Si actualizas desde la versión 4.16.01, cambia a la versión anterior de Zookeeper en las máquinas 1, 2 y 3:
    > yum downgrade apigee-zookeeper
  4. Actualiza Cassandra y ZooKeeper en las máquinas 1, 2 y 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  5. Establece la siguiente regla de iptables en la máquina 4:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  6. Verifica la cola de mensajes Qpid en la máquina 4:
    > qpid-stat -q

    Sigue revisando la cola hasta que el recuento de la columna “msg” sea 0. No puedes actualizar Qpid hasta que se hayan procesado todos los mensajes.
  7. Actualiza qpidd en la máquina 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Borra iptables en la máquina 4:
    > sudo iptables -F
  9. Repite los pasos del 5 al 8 en la máquina 5.
  10. Actualiza LDAP en la máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. Actualiza los componentes de Edge en las máquinas 1, 2 y 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. Actualiza la IU en la máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  13. 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 Postgres server, Qpid server y postgresql en la máquina 5:
      > /opt/apigee/apigee-service/bin/apigee-service perimetral-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
      > /opt/apigee/apigee-service/bin/apigee-service stop
    3. Detén el servidor Postgres y postgresql en el nodo en espera nuevo que agregaste para la reversión:
      > /opt/apigee/apigee-service/bin/apigee-service perimetral-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 la base de datos de Postgres en la máquina 4 (solo el administrador de Postgres):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    6. Actualiza postgresql en las máquinas 5:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. 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
    8. Ejecuta los siguientes comandos en la máquina 5 para configurar Postgres como un nodo de resguardo:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f       configFile
    9. Para verificar el estado de la replicación, emite 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 4, el nodo principal, ejecuta lo siguiente:
      >/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-waitby

      Valida que diga que está en espera.
  14. Actualiza los componentes de Edge en las máquinas 4 y 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  15. Asegúrate de retirar el nodo en espera nuevo mediante el procedimiento anterior en Retiro de servicio de un nodo de Postgres.

Para una instalación de clúster de 9 hosts

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

  1. Configura SMTPMAILFROM en tu archivo de configuración si habilitaste SMTP en Edge. Este parámetro tiene el siguiente formato:
    SMTPMAILFROM="Mi empresa <miempresa@empresa.com>"
  2. Asegúrate de haber instalado un nuevo nodo de Postgres en espera, como se describe más arriba en Instala un nuevo nodo de Postgres en espera.
  3. Si actualizas desde la versión 4.16.01, cambia a la versión anterior de Zookeeper en las máquinas 1, 2 y 3:
    > yum downgrade apigee-zookeeper
  4. Actualiza Cassandra y ZooKeeper en las máquinas 1, 2 y 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  5. Establece la siguiente regla de iptables en la máquina 6:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s “nombre de host” -i eth0 -j DROP
  6. Verifica la cola de mensajes de Qpid en la máquina 6:
    > qpid-stat -q

    Sigue verificando la cola hasta que el recuento en la columna “msg” sea 0. No puedes actualizar Qpid hasta que se hayan procesado todos los mensajes.
  7. Actualiza qpidd en la máquina 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Borra iptables en la máquina 6:
    > sudo iptables -F
  9. Repite los pasos del 5 al 8 en la máquina 7.
  10. Actualiza LDAP en la máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. 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
  12. Actualiza la IU en la máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  13. 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 Qpid en las máquinas 6 y 7:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. Detén el servidor Postgres y postgresql en el nodo en espera nuevo que agregaste para la reversión:
      > /opt/apigee/apigee-service/bin/apigee-service perimetral-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. Actualiza postgresql en las máquinas 8:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Actualiza la base de datos de Postgres en la máquina 8 (solo el administrador de Postgres):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Actualiza postgresql en las máquinas 9:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Inicia el servidor de Postgres en las máquinas 8 y 9:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. Inicia el servidor del servidor Qpid en máquinas 6 y 7:
      > /opt/apigee/apigee-service/bin/apigee-service perimetral-qpid-server start
    10. Ejecuta los siguientes comandos en la máquina 9 para configurar Postgres como un nodo de reserva:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f       configFile
    11. Para verificar el estado de la replicación, emite las siguientes secuencias de comandos en ambos servidores. El sistema debería mostrar resultados idénticos en ambos servidores para garantizar una replicación correcta:
      En la máquina 8, el nodo principal, ejecuta lo siguiente:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Verifica que diga que es el principal.

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

      Valida que diga que está en espera.
  14. Actualiza los componentes de Edge en las máquinas 8 y 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  15. Asegúrate de retirar el nuevo nodo de reserva con el procedimiento anterior en Cómo retirar un nodo de Postgres.

Para una instalación de clústeres de 13 hosts

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

  1. Configura SMTPMAILFROM en tu archivo de configuración si habilitaste SMTP en Edge. Este parámetro tiene el siguiente formato:
    SMTPMAILFROM="Mi empresa <miempresa@empresa.com>"
  2. Asegúrate de haber instalado un nodo en espera de Postgres nuevo como se describe en Instala un nodo en espera de Postgres nuevo.
  3. Si actualizas desde la versión 4.16.01, cambia a la versión anterior de Zookeeper en las máquinas 1, 2 y 3:
    > yum downgrade apigee-zookeeper
  4. Actualiza Cassandra y ZooKeeper en las máquinas 1, 2 y 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  5. Establece la siguiente regla de iptables en la máquina 12:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s “nombre de host” -i eth0 -j DROP
  6. Verifica la cola de mensajes Qpid en la máquina 12:
    > qpid-stat -q

    Sigue revisando la cola hasta que el recuento de la columna “msg” sea 0. No puedes actualizar Qpid hasta que se hayan procesado todos los mensajes.
  7. Actualiza qpidd en la máquina 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Borra iptables en la máquina 12:
    > sudo iptables -F
  9. Repite los pasos del 5 al 8 en la máquina 13.
  10. Actualiza LDAP en las máquinas 4 y 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. 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
  12. Actualiza la IU en las máquinas 6 y 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  13. 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 Qpid en las máquinas 12 y 13:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. Detén el servidor Postgres y postgresql en el nodo en espera nuevo que agregaste para la reversión:
      > /opt/apigee/apigee-service/bin/apigee-service perimetral-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. Actualiza postgresql en las máquinas 8:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Actualiza la base de datos de Postgres en la máquina 8 (solo el administrador de Postgres):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Actualiza postgresql en máquinas 9:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Inicia el servidor de Postgres en las máquinas 8 y 9:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. Inicia el servidor del servidor Qpid en las máquinas 12 y 13:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    10. Ejecuta los siguientes comandos en la máquina 9 para configurar Postgres como un nodo de reserva:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f       configFile
    11. Para verificar el estado de la replicación, emite las siguientes secuencias de comandos en ambos servidores. El sistema debería mostrar resultados idénticos en ambos servidores para garantizar una replicación correcta:
      En la máquina 8, el nodo principal, ejecuta lo siguiente:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Verifica que diga que es el principal.

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

      Valida que diga que está en espera.
  14. Actualiza los componentes de Edge en las máquinas 8 y 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  15. Asegúrate de retirar el nuevo nodo de reserva con el procedimiento anterior en Cómo retirar un nodo de Postgres.

Para una instalación de clúster de 12 hosts

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

  1. Configura SMTPMAILFROM en tu archivo de configuración si habilitaste SMTP en Edge. Este parámetro tiene el siguiente formato:
    SMTPMAILFROM="Mi empresa <miempresa@empresa.com>"
  2. Asegúrate de haber instalado un nodo en espera de Postgres nuevo como se describe en Instala un nodo en espera de Postgres nuevo.
  3. Actualiza Cassandra y ZooKeeper:
    1. Si actualizas desde la versión 4.16.01, cambia a una versión anterior de Zookeeper en las máquinas 1, 2 y 3 del centro de datos 1:
      > yum downgrade apigee-zookeeper
    2. 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
    3. Si actualizas desde la versión 4.16.01, cambia a una versión anterior de Zookeeper en las máquinas 7, 8 y 9 del centro de datos 2:
      > yum downgrade apigee-zookeeper
    4. 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
  4. Actualiza qpidd:
    1. Máquinas 4 y 5 en el centro de datos 1
      1. Establece la siguiente regla de iptables en la máquina 4:
        > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      2. Verifica la cola de mensajes Qpid en la máquina 4:
        > qpid-stat -q

        Sigue revisando la cola hasta que el recuento de la columna “msg” sea 0. No puedes actualizar Qpid hasta que se hayan procesado todos los mensajes.
      3. Actualiza qpidd en la máquina 4:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. Limpia iptables en la máquina 4:
        > sudo iptables -F
      5. Repite los pasos del 1 al 4 en la máquina 5.
    2. Máquinas 10 y 11 en el centro de datos 2
      1. Establece la siguiente regla de iptables en la máquina 10:
        > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      2. Verifica la cola de mensajes de Qpid en la máquina 10:
        > qpid-stat -q

        Sigue verificando la cola hasta que el recuento en la columna “msg” sea 0. No puedes actualizar Qpid hasta que se hayan procesado todos los mensajes.
      3. Actualiza qpidd en la máquina 10:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. Limpia iptables en la máquina 10:
        > sudo iptables -F
      5. Repite los pasos del 1 al 4 en la máquina 11.
  5. Actualiza 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
  6. 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
  7. 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
  8. 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 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 Qpid en las máquinas 4, 5, 10 y 11:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. Detén el servidor Postgres y postgresql en el nodo en espera nuevo que agregaste para la reversión:
      > /opt/apigee/apigee-service/bin/apigee-service perimetral-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 la base de datos de Postgres en la máquina 6 (solo el administrador de Postgres):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Actualiza postgresql en máquinas 12:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Inicia el servidor de Postgres en las máquinas 6 y 12:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. Inicia el servidor Qpid en las máquinas 4, 5, 10 y 11:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. Ejecuta los siguientes comandos en la máquina 12 para configurar Postgres como un nodo de resguardo:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f       configFile
    11. Para verificar el estado de la replicación, emite las siguientes secuencias de comandos en ambos servidores. El sistema debería mostrar resultados idénticos en ambos servidores para garantizar una replicación correcta:
      En la máquina 6, el nodo principal, ejecuta lo siguiente:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Verifica que diga que es el principal.

      En la máquina 12, el nodo en espera:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-waitby

      Valida que diga que está en espera.
  9. Actualiza los componentes de Edge en las máquinas 6 y 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Asegúrate de retirar el nuevo nodo de reserva con el procedimiento anterior en Cómo retirar un nodo de Postgres.

Para una instalación de BaaS de API de 7 o 10 hosts

Para una instalación no estándar

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

  1. ZooKeeper
  2. Cassandra
  3. qpidd
  4. LDAP
  5. Edge, que significa el perfil “-c Edge” en todos los nodos del orden: nodos con el servidor Qpid, pero no con el servidor de Postgres, el servidor de administración, el procesador de mensajes ni el router.
    Nota: Si el nodo tiene instalado el servidor Qpid y el servidor Postgres, ejecuta el paso de perfil "-c edge" como parte del paso 8.
  6. IU de Edge
  7. postgresql en el maestro de Postgres, incluida la actualización.
  8. postgresql en el estado de espera de Postgres.
  9. Edge, es decir, el perfil "-c edge" en todos los nodos combinados de Qpid y Postgres, o en cualquier nodo independiente de Postgres.