Revertir Apigee Edge 4.52.01

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

Puedes revertir Edge 4.52.01 a las siguientes versiones de actualización principales:

• Versión 4.52.00
• Versión 4.51.00

Hay dos situaciones en las que es posible que desees realizar una reversión:

1. Revierte a una versión principal o secundaria anterior. Por ejemplo, de 4.52.01 a 4.52.00.
2. Revierte a una versión de parche anterior de la misma versión. Por ejemplo, de 4.52.00.02 a 4.52.00.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 el que actualizó originalmente Edge o un usuario que se ejecuta con permisos de administrador.

De forma predeterminada, los componentes de Edge se ejecutan como el usuario “apigee”. En algunos casos, puedes ejecutar componentes de Edge como usuarios diferentes. Por ejemplo, si el router debe acceder a puertos con privilegios, como los inferiores a 1,000, debes ejecutarlo como raíz o como un usuario con acceso a esos puertos. O bien, puedes ejecutar un componente como un usuario y otro componente 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 encuentren 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, debes revertir los tres para revertir cualquiera de ellos.

Cómo revertir a una versión principal o secundaria anterior

Para revertir a una versión principal o secundaria anterior, haz lo siguiente en cada nodo que aloja el componente:

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

   • Para revertir a 4.51.00, descarga bootstrap_4.51.00.sh:

     curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh 

     .
2. Detén el componente que deseas revertir:
   1. Para revertir cualquiera de los componentes con código común en el nodo, debes detenerlos a 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 estás revirtiendo 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 revertirlo en el nodo:
   1. Para revertir cualquiera de los componentes con código común en el nodo, debes desinstalarlos todos mediante la desinstalación del 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 ejemplo anterior, component es el nombre del componente.

   3. Para revertir el router perimetral, 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.52.01 de apigee-setup:

   /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall

6. Instala la versión 4.51.00 de la utilidad apigee-service y sus dependencias. En el siguiente ejemplo, se instala la versión 4.51.00 de apigee-service:

   sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

   En el ejemplo anterior, 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 descargar 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

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

9. Si reviertes Qpid, vacia iptables:

   sudo iptables -F

10. Repite este proceso para cada nodo que aloje el componente que deseas revertir.

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

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

1. Descarga la versión del componente específico:

   /opt/apigee/apigee-service/bin/apigee-service component_version install

   En el ejemplo anterior, component_version es el componente y la versión de parche que se debe instalar. Por ejemplo:

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

   Si usas el repositorio en línea de Apigee, puedes determinar las versiones de los componentes disponibles mediante 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 especificas el nombre del componente cuando lo instalas, no la versión.

3. Repite este proceso para cada nodo que aloje el componente que deseas revertir.

Revierte la actualización de Postgres 10.17

Si actualizaste a la versión 4.52.01 desde la versión 4.50.00 o 4.51.00, debes revertir la actualización de Postgres, además de los componentes de Edge.

Para revertir la actualización de Postgres cuando se actualiza Postgres en una configuración de instancia principal en espera, haz lo siguiente:

• Asciende el nodo en espera nuevo para que se convierta en la instancia principal de Postgres. La nueva instancia principal de Postgres será la misma versión que la instalación de Edge anterior.
• Configura el nodo en espera anterior para que sea uno en espera de la instancia principal nueva. El nodo en espera anterior será la misma versión que la instalación anterior de Edge.
• Registra la instancia principal y los nodos en espera nuevos con los grupos de estadísticas y consumidores.

Cuando finalice la reversión, el nodo principal anterior ya no será necesario. Luego, puedes retirar el nodo principal anterior.

1. Asegúrate de que el nuevo nodo de Postgres en espera 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. Asegúrate de que Postgres esté detenido en el nodo principal y en el nodo en espera anteriores:

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

   Si Postgres está en ejecución, detenlo:

   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

   .

3. Si está instalado, inicia Qpid en el nodo en espera anterior:

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start

4. Asciende el nuevo nodo en espera como la instancia principal de Postgres:
   1. Asciende el nodo en espera nuevo para que sea la nueva instancia principal:

      apigee-service apigee-postgresql promote-standby-to-master new_standby_IP

      Si se te solicita, ingresa la contraseña de Postgres para el usuario “apigee”, cuya configuración predeterminada es “postgres”.

   2. 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 new master:
      PG_MASTER=new_standby_IP
      # IP address of the old standby node
      PG_STANDBY=old_standby_IP

   3. Configura la nueva instancia principal:
      

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFile

5. Si ya actualizaste el nodo en espera anterior a la versión más reciente, primero debes cambiar a una versión inferior del software de Apigee en el nodo en espera anterior. Si aún tienes la versión anterior en el nodo en espera anterior, puedes omitir este paso y continuar con el paso 6.
   1. Detén Postgres en el nodo en espera antiguo:

      apigee-service apigee-postgresql stop
      apigee-service edge-postgres-server stop

   2. Desinstala Postgres del nodo en espera anterior:

      apigee-service apigee-postgresql uninstall
      apigee-service edge-postgres-server uninstall

   3. Borra el directorio de datos de Postgres del nodo en espera anterior:

      cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *

   4. Descarga y ejecuta el arranque de la versión anterior (para la versión de Apigee que estás revirtiendo) en el nodo en espera anterior. Los pasos exactos pueden variar según si usas una instalación basada en Internet o sin conexión. Cuando ejecutes el arranque de la versión anterior de Apigee, se configurarán los repositorios de yum con los datos de la versión anterior de Apigee.
   5. Configura los componentes de Postgres en el nodo en espera anterior:

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

   6. Comprueba y verifica que los componentes de Postgres del nodo en espera antiguo se hayan revertido a la versión anterior:

      apigee-service apigee-postgresql version
      apigee-service edge-postgres-server version

6. Vuelve a compilar el nodo en espera anterior:
   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 new master:
      PG_MASTER=new_standby_IP
      # IP address of the old standby node
      PG_STANDBY=old_standby_IP

   2. Quita el directorio de datos del nodo en espera antiguo:

      cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *

   3. Vuelve a configurar el nodo en espera anterior para que sea uno en espera de la instancia principal nueva:

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile

   4. Asegúrate de que Postgres se esté ejecutando en el nodo en espera anterior:

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

      Si Postgres no se está ejecutando, inícialo:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

7. Para verificar que se haya agregado el nodo en espera nuevo, visualiza el archivo /opt/apigee/apigee-postgresql/conf/pg_hba.conf en la instancia principal nueva.
8. Para ver las estadísticas actuales y la información del grupo de consumidores, ejecuta el siguiente comando en el servidor de administración:

   curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

   Este comando muestra el nombre del grupo de estadísticas en el campo name y el nombre del grupo de consumidores en el campo name en consumer-groups. También muestra los UUID de los nodos principales y en espera de Postgres anteriores en el campo postgres-server y en el campo datastores. Deberías ver el resultado en el siguiente formato:

   {
     "name" : "axgroup-001",
     "properties" : {
     },
     "scopes" : [ "VALIDATE~test", "sgilson~prod" ],
     "uuids" : {
       "qpid-server" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
       "postgres-server" : [
         "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256"
       ]
     },
     "consumer-groups" : [ {
       "name" : "consumer-group-001",
       "consumers" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
       "datastores" :
         [ "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256" ],
         "properties" : {     }
       }
     ],
     "data-processors" : {
     }
   }

9. Obtén la dirección UUID de la instancia principal anterior ejecutando el siguiente comando curl en el nodo principal anterior:

   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"

10. Repite el paso anterior para obtener las direcciones IP del nodo en espera anterior y la instancia principal nueva.
11. Quita los nodos principales y en espera antiguos del grupo de consumidores:

    curl -u sysAdminEmail:password -X DELETE \
      "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores/masterUUID,standbyUUID" -v

    En el que axgroup-001 y consumer-group-001 son los nombres predeterminados de los grupos de consumidores y estadísticas. Las masterUUID,standbyUUID están en el mismo orden en que aparecen antes cuando consultaste las estadísticas actuales y la información de grupos de consumidores más arriba. Es posible que debas especificarlos como standbyUUID,masterUUID.

    La propiedad datastores para consumer-groups ahora debería estar vacía.

12. Quita los nodos principales y en espera anteriores del grupo de estadísticas:

    curl -u sysAdminEmail:password -X DELETE \
      "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v

    La propiedad postgres-server en uuids ahora debería estar vacía.

13. Registra nuevos nodos principales y en espera de PG con los grupos de estadísticas y consumidores:
    

    curl -u sysAdminEmail:password -X POST -H "Content-Type: application/json" -d ''
      "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v
    curl -u sysAdminEmail:password -X POST -H "Content-Type:application/json" -d ''
      "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores?uuid=masterUUID,standbyUUID" -v

14. Valida el grupo de estadísticas:

    curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

    Deberías ver los UUID de los nuevos nodos principales y en espera enumerados en los grupos de estadísticas y de consumidor.

15. Reinicia el servidor de administración perimetral:

    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

16. Reiniciar todos los servidores de Qpid:

    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart

17. Reinicia todos los servidores de Postgres:

    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart

    .
18. 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 instancia principal nueva, ejecuta lo siguiente:

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

    Verifica que sea la instancia principal. En el nodo en espera anterior:

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

    Verifica que esté en espera.

19. Repite el paso anterior después de realizar varias solicitudes a la API para asegurarte de que los nodos estén sincronizados.
20. Quita de servicio la instancia principal de Postgres anterior con el procedimiento que se describe en Retira de servicio un nodo de Postgres.

    Como alternativa, puedes desinstalar Qpid de la instancia principal anterior e instalar Qpid en el nodo principal nuevo. Después de desinstalar Qpid, puedes retirar el nodo principal anterior.

Revierte mTLS

Para revertir la actualización de mTLS, sigue estos pasos en todos los hosts:

1. Detén Apigee:

   apigee-all stop

2. Detener mTLS:

   apigee-service apigee-mtls uninstall

3. Reinstala mTLS:

   apigee-service apigee-mtls install
   apigee-service apigee-mtls setup -f /opt/silent.conf