Actualiza Apigee Edge 4.17.01/4.17.05 a 4.17.09

Edge para la nube privada v. 4.17.09

¿Qué versiones de Edge puedes actualizar a la 4.17.09?

Puedes actualizar la versión 4.17.01.0x/4.17.05.0x de Apigee Edge a la 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.x y, luego, actualizar a la versión 4.17.09.

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 ejecuta con permisos de administrador.

Después de instalar los RPM de Edge, cualquier usuario puede configurarlos.

Qué componentes debes actualizar

Debes actualizar todos los componentes de Edge. Edge no admite una configuración que contenga componentes de varias versiones.

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

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

Se agregó el parámetro de configuración SMTPMAILFROM de forma obligatoria

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 BaaS también agregó compatibilidad con la propiedad SMTPMailFROM. Cuando actualices la API de BaaS desde la versión 4.17.01 o 4.17.05, debes configurar SMTPMAILFROM en el archivo de configuración.

Este parámetro tiene la siguiente forma:

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

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

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

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

Información de actualización de Logging

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

/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 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 sea el momento de actualizar los routers, selecciona cualquier router y hazlo inaccesible, como se describe en Cómo habilitar o inhabilitar la accesibilidad del servidor (procesador de mensajes/router).
  3. Actualiza el router seleccionado y todos los demás componentes de Edge en la misma máquina que el router. Todas las configuraciones de Edge muestran un router y un procesador de mensajes en el mismo nodo.
  4. Haz que el router vuelva a estar accesible.
  5. Repite los pasos del 2 al 4 para los routers restantes.
  6. Continúa la actualización de las máquinas restantes de la instalación.

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

  • 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 sea inaccesible.
    • Después de la actualización, haz lo siguiente:
      1. Haz que se pueda acceder al Message Processor.
      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, asegúrate de que se pueda acceder al router.
  • 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.17.01.

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 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.
  2. 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.
  3. Instala yum-utils y yum-plugin-priorities:
    > sudo yum install yum-utils
    > sudo yum install yum-plugin-priorities
  4. Inhabilita SELinux como se describe en Instala la utilidad de configuración de Apigee de Edge.
  5. 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
  6. 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.sh
  7. Instala la utilidad apigee-service 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.
  8. Usa apigee-service para actualizar la utilidad apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  9. Actualiza la utilidad apigee-validate en el servidor de administración:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  10. Actualiza la utilidad apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  11. 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 =..










  12. 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.

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 local de Edge, tienes dos opciones para actualizar Edge desde el repositorio local:

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

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

  1. 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.17.01/4.17.05 existente, puedes agregar el repositorio 4.17.09 como se describe en “Cómo actualizar un repositorio de Apigee local” en Cómo instalar la utilidad apigee-setup de Edge.
  2. 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.
  3. Para instalar apigee-service con el servidor web Nginx, sigue estos pasos:
    1. Configura el servidor web Nginx como se describe en "Install from the repo using the Nginx webserver" en Install the Edge utility apigee-setup.
    2. En el nodo remoto, descarga el archivo bootstrap_4.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.
  4. Usa apigee-service para actualizar la utilidad apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. Actualiza la utilidad apigee-validate en el servidor de administración.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. Actualiza la utilidad apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. 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
  8. Para probar la actualización, ejecuta la utilidad apigee-validate en el servidor de administración, como se describe en Cómo probar la instalación.

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. Si actualizas desde la versión 4.17.01, establece 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. Actualiza Cassandra y ZooKeeper:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Actualiza Qpid y Postgres:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. Inicia postgresql:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. Actualiza LDAP:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Actualiza los componentes restantes de Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  7. Actualiza la IU de Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Para una instalación independiente de 2 hosts

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

  1. Si actualizas desde la versión 4.17.01, establece 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. Actualiza Cassandra y ZooKeeper en la máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Actualiza Qpid y Postgres en la máquina 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. Inicia postgresql en la máquina 2:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. Actualiza LDAP en la máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Actualiza los componentes de Edge en las máquinas 2 y 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Actualiza la IU en la máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -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. Si quieres actualizar desde la versión 4.17.01, configura 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. 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 y Postgres en la máquina 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. Inicia postgresql en la máquina 4:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. Repite los pasos 3 y 4 en la máquina 5.
  6. Actualiza LDAP en la máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  7. Actualiza los componentes de Edge en las máquinas 4, 5, 1, 2 y 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. Actualiza la IU en la máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

  1. Si quieres actualizar desde la versión 4.17.01, configura SMTPMailFROM en el archivo de configuración si habilitaste SMTP en Edge. Este parámetro tiene el siguiente formato:
    SMTPMAILFROM="Mi empresa <miempresa@empresa.com>"
  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 y Postgres en la máquina 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. Inicia postgresql en la máquina 6:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. Repite los pasos 3 y 4 en la máquina 7.
  6. Actualiza LDAP en la máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  7. Actualiza los componentes de Edge en las máquinas 6, 7, 8, 9, 1, 4 y 5 en ese orden:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. Actualiza la IU en la máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

  1. Si actualizas desde la versión 4.17.01, establece 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. 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 y Postgres en la máquina 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. Inicia postgresql en la máquina 12:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. Repite los pasos 3 y 4 en la máquina 13.
  6. Actualiza LDAP en las máquinas 4 y 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  7. Actualiza los componentes de Edge en la máquina 12, 13, 8, 9, 6, 7, 10 y 11 en ese orden:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  8. Actualiza la IU en las máquinas 6 y 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

  1. Si actualizas desde la versión 4.17.01, establece SMTPMAILFROM en tu archivo de configuración si habilitaste SMTP en Edge. Este parámetro tiene el siguiente formato:
    SMTPMailFROM="Mi empresa <myco@company.com>"
  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. Máquinas 4 y 5 en el centro de datos 1
      1. Actualiza qpidd en la máquina 4:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Repite el paso 1 en la máquina 5.
    2. Máquinas 10 y 11 en el centro de datos 2
      1. Actualiza qpidd en la máquina 10:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Repite el paso 1 en la máquina 11.
  4. Actualiza postgresql:
    1. Máquinas 6 en el centro de datos 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
    2. Máquinas 12 en el centro de datos 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  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, 6, 1, 2 y 3 en el centro de datos 1
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. Máquinas 10, 11, 12, 7, 8 y 9 en el centro de datos 2
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  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

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

  1. Establece SMTPMAILFROM en tu archivo de configuración. Este parámetro tiene el siguiente formato:
    SMTPMailFROM="Mi empresa <myco@company.com>"
  2. Actualiza Cassandra en las máquinas 5, 6 y 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

  3. Actualiza ElasticSearch y la pila de BaaS de API en las máquinas 1, 2 y 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile

  4. Actualiza el portal de BaaS de API en la máquina 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

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

  1. Establece SMTPMAILFROM en tu archivo de configuración. Este parámetro tiene el siguiente formato:
    SMTPMAILFROM="Mi empresa <miempresa@empresa.com>"
  2. Actualiza Cassandra en las máquinas 8, 9 y 10:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  3. Actualiza ElasticSearch en las máquinas 1, 2 y 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  4. Actualiza la pila de BaaS de API en las máquinas 4, 5 y 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  5. Actualiza el portal de BaaS de la API en la máquina 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Para una instalación de BaaS de API de dos centros de datos

Este procedimiento requiere que actualices los nodos de Cassandra en ambos centros de datos. Si compartes esos nodos de Cassandra con Edge, por lo general, los actualizas como parte de la actualización de Edge.

  1. Establece SMTPMAILFROM en tus archivos de configuración. Este parámetro tiene el siguiente formato:
    SMTPMAILFROM="Mi empresa <miempresa@empresa.com>"
  2. Actualiza los espacios de claves de Cassandra con el factor de replicación correcto para los dos centros de datos. Solo tienes que ejecutar este paso una vez en cualquier servidor de Cassandra en cualquiera de los centros de datos:

    Nota: Los siguientes comandos establecen el factor de replicación en “3”, lo que indica que hay tres nodos de Cassandra en el clúster. Modifica este valor según sea necesario para tu instalación.
    1. Inicia la utilidad cqlsh de Cassandra:
      > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
    2. Ejecuta los siguientes comandos de CQL en el mensaje “cqlsh>” para establecer los niveles de replicación de los espacios de claves de Cassandra:
      1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      2. cqlsh> ALTER KEYSPACE “Apigee_Baas” WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      3. cqlsh> ALTER KEYSPACE "Apigee_Baas_Locks" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      4. cqlsh> ALTER KEYSPACE "system_traces" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      5. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH replication = { 'class': 'NetworkTopology', 'dc-1': '3','dc-2': '3' };
      6. Para ver los espacios de claves, usa el comando:
        cqlsh> select * from system.schema_keyspaces;
      7. Salir de cqlsh:
        cqlsh> exit
  3. (Solo si no actualizaste Cassandra como parte de la actualización de Edge) Actualiza los nodos de Cassandra en el centro de datos 1, de a una máquina a la vez:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  4. (Solo si no actualizaste Cassandra como parte de la actualización de Edge) Actualiza los nodos de Cassandra en el centro de datos 2, de a una máquina a la vez:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  5. Actualiza ElasticSearch en las máquinas del centro de datos 1, una a la vez:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  6. Actualiza ElasticSearch en las máquinas del centro de datos 2, una a la vez:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  7. Actualiza la pila de BaaS de API en las máquinas del centro de datos 1, una a la vez:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  8. Actualiza la pila de BaaS de API en las máquinas del centro de datos 2, una a la vez:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  9. Actualiza el portal de BaaS de API en las máquinas del centro de datos 1, una a la vez:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
  10. Actualiza el portal de BaaS de la API en las máquinas del centro de datos 2, una a la vez:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
  11. Actualiza los valores del espacio de claves de BaaS. Estos espacios de claves se deben configurar para la replicación en el momento de la instalación, pero no es necesario que lo estén en el tiempo de ejecución. Quitar la replicación también ahorra memoria de Cassandra.

    Solo debes ejecutar este paso una vez en cualquier servidor de Cassandra en cualquiera de los centros de datos:
    1. Inicia la utilidad cqlsh de Cassandra:
      > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
    2. Ejecuta los siguientes comandos de CQL para establecer los niveles de replicación de los espacios de claves de Cassandra:
      1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH replicación = { 'class': 'NetworkTopology', 'dc-1': '3' };
      2. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-2': '3' };
      3. Para ver los espacios de claves, usa el comando:
        cqlsh> select * from system.schema_keyspaces;
      4. Salir de cqlsh:
        cqlsh> exit

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, ps
  4. LDAP
  5. Edge, es decir, el perfil "-c edge" en todos los nodos del orden: nodos con servidor Qpid, servidor Postgres, servidor de administración, procesador de mensajes y router.
    Nota: Si el nodo tiene instalados el servidor Qpid y el servidor Postgres, ejecuta el paso de perfil “-c Edge”.
  6. IU de Edge