Revertir Apigee Edge 4.19.06

Si encuentras un error durante una actualización a Edge 4.19.06, puedes revertir el componente que causó el error y, luego, volver a intentar la actualización.

Puedes revertir Edge 4.19.06 a las siguientes versiones de lanzamiento de funciones:

  • Versión 4.19.01
  • Versión 4.18.05
  • Versión 4.18.01

Existen dos situaciones en las que podrías querer realizar una reversión:

  1. Revierte a una versión de funciones anterior. Por ejemplo, de 4.19.06 a 4.18.05.
  2. Revierte a una versión de actualización anterior en la misma versión. Por ejemplo, de 4.19.01.02 a 4.19.01.01.

Para obtener más información, consulta el proceso de lanzamiento de Apigee Edge.

Quién puede realizar una reversión

El usuario que realiza una reversión debe ser el mismo que actualizó Edge originalmente o un usuario que se ejecuta como root.

De forma predeterminada, los componentes de Edge se ejecutan como el usuario "apigee". En algunos casos, es posible que ejecutes los componentes de Edge como usuarios diferentes. Por ejemplo, si el router debe acceder a puertos con privilegios, como los inferiores a 1,000, debes ejecutar el router como raíz o como un usuario con acceso a esos puertos. También puedes ejecutar un componente como un usuario y otro como otro usuario.

Componentes con código común

Los siguientes componentes de Edge comparten código común. Por lo tanto, para revertir cualquiera de estos componentes en un nodo, debes revertir todos los componentes que se encuentran en ese nodo.

  • edge-management-server (servidor de administración)
  • edge-message-processor (procesador de mensajes)
  • edge-router (router)
  • edge-postgres-server (servidor de Postgres)
  • edge-qpid-server (servidor Qpid)

Por ejemplo, si tienes el servidor de administración, el router y el procesador de mensajes instalados en el nodo, para revertir cualquiera de ellos, debes revertir los tres.

Cómo revertir a una versión de funciones anterior

Para revertir a una versión de funciones anterior, haz lo siguiente en cada nodo que aloje el componente:

  1. Descarga el archivo bootstrap.sh de la versión a la que deseas revertir:

    • Para volver a la versión 4.19.01, descarga bootstrap_4.19.01.sh:
      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh 
    • Para revertir a la versión 4.18.05, descarga bootstrap_4.18.05.sh:
      curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh 
    • Para volver a la versión 4.18.01, descarga bootstrap_4.18.01.sh:
      curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh 
  2. Detén el componente para revertirlo:
    1. Para revertir cualquiera de los componentes con código común en el nodo, debes detenerlos todos, como se muestra en el siguiente ejemplo:
      /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
      /opt/apigee/apigee-service/bin/apigee-service edge-router stop
      /opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Para revertir cualquier otro componente del nodo, detén solo ese componente:
      • /opt/apigee/apigee-service/bin/apigee-service component stop
  3. Si reviertes la Monetización, desinstálala de todos los nodos del servidor de administración y del procesador de mensajes:
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. Desinstala el componente para revertir el nodo:
    1. Para revertir cualquiera de los componentes con código común en el nodo, debes desinstalarlos todos. Para ello, desinstala el grupo de componentes edge-gateway, como se muestra en el siguiente ejemplo:
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
    2. Para revertir cualquier otro componente del nodo, desinstala solo ese componente, como se muestra en el siguiente ejemplo:
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      En el que component es el nombre del componente.

    3. Para revertir el router de borde, debes borrar el contenido del archivo /opt/nginx/conf.d, además de desinstalar el grupo de componentes edge-gateway:
      cd /opt/nginx/conf.d
      rm -rf *
  5. Desinstala la versión 4.19.06 de apigee-setup:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. Instala la versión 4.19.01, 4.18.05 o 4.18.01 de la utilidad apigee-service y sus dependencias. En el siguiente ejemplo, se instala la versión 4.18.01 de apigee-service:
    sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord
    .

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

    Si recibes un error, asegúrate de haber descargado el archivo bootstrap.sh en el paso 1.

  7. Instala apigee-setup:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  8. Instala la versión anterior del componente:
    /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

    En el que component es el componente que se instalará y configFile es tu archivo de configuración de la versión anterior.

  9. Si estás revirtiendo Qpid, limpia las iptables:
    sudo iptables -F
  10. Repite este proceso con cada nodo que aloje el componente que estás revirtiendo.

Revertir a una versión de actualización anterior

Para revertir un componente a una versión específica de una versión, haz lo siguiente en cada nodo que aloje el componente:

  1. Descarga la versión específica del componente:
    /opt/apigee/apigee-service/bin/apigee-service component_version install

    En el que component_version es el componente y la versión de actualización que se instalará. Por ejemplo:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.18.01-0.0.3749 install

    Si usas el repositorio en línea de Apigee, puedes determinar las versiones de los componentes disponibles con el siguiente comando:

    yum --showduplicates list comp

    Por ejemplo:

    yum --showduplicates list edge-ui
  2. Usa apigee-setup para instalar el componente:
    /opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile

    Por ejemplo:

    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile

    Ten en cuenta que solo debes especificar el nombre del componente cuando lo instales, no la versión.

  3. Repite este proceso con cada nodo que aloje el componente que estás revirtiendo.