Se usó la API de Cloud Translation para traducir esta página.

Revierte Apigee Edge 4.52.02

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

Puedes revertir Edge 4.52.02 a las siguientes versiones de lanzamiento principales:

Versión 4.52.01
Versión 4.52.00
Versión 4.51.00

La reversión de una versión implica revertir todos los componentes que hayas actualizado. Además, según la versión desde la que comenzaste, es posible que debas tener en cuenta consideraciones especiales antes de revertir ciertos componentes de software. En la siguiente tabla, se enumeran los diversos softwares para los que se pueden necesitar pasos especiales durante la reversión:

Revierte a la versión	Consideraciones especiales para el software
4.52.01	Cassandra
4.52.00	Cassandra, Zookeeper y Qpid
4.51.00	Cassandra, Zookeeper, Qpid y Postgres

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

Revierte a una versión principal o secundaria anterior. Por ejemplo, de 4.52.02 a 4.52.00.
Revierte a una versión de parche anterior en la misma actualizació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.

Orden de reversión

La reversión de los componentes debe realizarse en el orden inverso en que se actualizaron, con la excepción de que los servidores de administración deben revertirse después de Cassandra.

Un orden general típico de la reversión para Private Cloud 4.52.02 se verá de la siguiente manera:

Cómo revertir Postgres, Qpid y otros componentes relacionados con las estadísticas
Routers y procesadores de mensajes de reversión
Reversión de Cassandra y Zookeeper
Servidor de administración de reversiones

Por ejemplo, supongamos que actualizaste todo el clúster de Cassandra, todos tus servidores de administración y algunos RMP a la versión 4.52.02 desde la versión 4.52.01 y deseas revertir la actualización. En este caso, debes hacer lo siguiente:

Cómo revertir todos los RMP uno por uno
Cómo revertir todo el clúster de Cassandra con copias de seguridad
Cómo revertir los nodos del servidor de administración de Edge uno por uno

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 componentes de Edge como usuarios diferentes. Por ejemplo, si el router tiene que acceder a puertos con privilegios, como los que son inferiores a 1,000, debes ejecutar el router como root o como un usuario con acceso a esos puertos. También 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 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.

Reversión de Cassandra

Cuando se realiza una actualización importante de Cassandra en un nodo en particular, Cassandra modifica el esquema de los datos almacenados en el nodo, lo que hace que no sea posible una reversión directa. Existen dos metodologías para realizar la reversión. Usarás una de estas metodologías según el estado de la actualización desde la que realizas la reversión.

Metodologías para revertir

Borrar y usar los nodos existentes en el clúster para volver a compilar el nodo

Puedes seguir este procedimiento si tienes al menos un centro de datos completamente funcional en el clúster que aún tiene la versión anterior de Cassandra (Cassandra 2.1.22). Si actualizaste todo el clúster de Cassandra y quieres revertir la actualización, debes seguir los pasos que se indican en Cómo borrar y restablecer una copia de seguridad o una instantánea de VM.

Pasos para la reversión

Comienza con el nodo que deseas revertir:
- Detén Cassandra en el nodo:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
```
- Desinstala el software de Cassandra del nodo:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
```
- Quita el directorio de datos del nodo:
```
rm -rf /opt/apigee/data/apigee-cassandra
```
- Descarga y ejecuta el inicio de la versión anterior de Edge for Private Cloud a la que deseas revertir.
Ejemplo: Para revertir a la versión 4.52.01,
- Descarga el arranque de 4.52.01:
```
curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
```
- Ejecuta el inicio de la versión 4.52.01:
```
sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
```
- Configura Cassandra en el nodo:
```
/opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
```
- Proporciona el nombre del centro de datos funcional para ejecutar la reconstrucción en el nodo:
```
/opt/apigee/apigee-cassandra/bin/nodetool rebuild -h <node-IP> <functional-dc>
```
- Repite los pasos anteriores en cada nodo que quieras revertir, uno a la vez.
Una vez que se reviertan y vuelvan a compilarse todos los nodos, haz lo siguiente:
- Ejecuta la configuración de cualquier nodo de servidor de administración. Asegúrate de que el servidor de administración sea de la versión revertida. De lo contrario, revierte también el servidor de administración.
- Detén el servidor de administración:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
```
- Si usas la monetización, desinstálala también:
```
/opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
```
- Desinstala el servidor de administración:
```
/opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
```
- Descarga y ejecuta el inicio de la versión anterior. Por ejemplo, ejecuta los siguientes pasos para descargar y ejecutar el inicio de la versión 4.52.01:
```
curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
```
- Ejecuta la configuración de un nodo de servidor de administración:
```
/opt/apigee/apigee-setup/bin/setup.sh -p mt -f configFile
```

Optimización después de la reconstrucción

En los pasos anteriores, todos los datos del nodo se transmiten desde el centro de datos remoto durante la reconstrucción. Puedes optimizar este proceso con una reparación una vez que se hayan transmitido todas las réplicas al centro de datos local. Esto evita la transmisión entre DCs y debería ser más rápido que volver a compilar todos los nodos desde un DC remoto.

Ejemplo: Supongamos que tienes seis nodos de Cassandra en el centro de datos local. De forma predeterminada, el factor de replicación de Apigee es tres, por lo que cada nodo posee el 50% de los datos. En este caso, puedes volver a compilar los nodos 1 y 4 siguiendo el procedimiento anterior. Para los nodos 2, 3, 5 y 6, sigue los pasos que se indican a continuación para restablecer la copia de seguridad y ejecutar una reparación.

Sigue el procedimiento hasta el paso seis como se documenta para volver a crear réplicas en el centro de datos local.
Para los nodos restantes, sigue los pasos que se indican a continuación en cada uno de ellos, uno a la vez.
- Restablece la copia de seguridad que capturaste en este nodo (nota: es probable que esta copia de seguridad tenga datos inactivos, ya que se tomó antes de que iniciaras la actualización de Cassandra):
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup_file
```
- Si tienes una instantánea de VM del nodo, puedes restablecerla en lugar de restablecer la copia de seguridad de Cassandra.
- Después de restablecer la copia de seguridad, inicia el servicio de Cassandra en el nodo:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start
```
- Ejecuta una reparación en el nodo para que los datos más recientes se puedan transmitir desde un centro de datos existente:
```
/opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -dc <local-dc-name>
```
- Repite los pasos del tres al seis en cada nodo que quieras reparar.

Borra y restablece la copia de seguridad o la instantánea de la VM

Este procedimiento es el único disponible si actualizaste todo el clúster de Cassandra y deseas revertir la actualización.

Además, las copias de seguridad de Apigee son específicas del nodo. No es posible restablecer una copia de seguridad tomada de un nodo a otro. Las copias de seguridad de Cassandra incluyen información de metadatos de nodos (como la dirección IP, la posición del anillo, etcétera).

Comienza con 1 nodo de Cassandra en el clúster:
- Detén el servicio de Cassandra en el nodo:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
```
- Desinstala el software de Cassandra del nodo:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
```
- Quita el directorio de datos del nodo:
```
rm -rf /opt/apigee/data/apigee-cassandra
```
- Descarga y ejecuta el inicio de la versión anterior de Edge for Private Cloud a la que deseas revertir.
Ejemplo: Para revertir a la versión 4.52.01
- Descarga el arranque de 4.52.01:
```
curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
```
- Ejecuta el inicio de la versión 4.52.01:
```
sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
```
- Configura Cassandra en el nodo:
```
/opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
```
- Restablece la copia de seguridad en el nodo con el procedimiento que se indica en Restablece una copia de seguridad.
- Detén Cassandra en el nodo:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
```
- Borra el directorio de datos:
```
rm -rf /opt/apigee/data/apigee-cassandra/data
```
- Restablece la copia de seguridad:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup_file
```
- Inicia el servicio de Cassandra en el nodo:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start
```
- Repite los pasos en cada nodo de Cassandra de a uno.
- Ejecuta la reparación en los nodos de a uno por vez:
```
/opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -pr
```

Revierte la actualización de Zookeeper 3.8.3

Si quieres revertir a las versiones 4.52.00 o 4.51.00, deberás consultar algunos pasos especiales antes de revertir Zookeeper. Estos pasos se indican en Rollback.

Si quieres revertir a la versión 4.52.01, haz lo mismo con Zookeeper que con cualquier software, como se indica en la sección Cómo revertir a una versión principal o secundaria anterior que aparece a continuación.

Reversión de Qpid

Si quieres revertir a las versiones 4.52.00 o 4.51.00, deberás consultar algunos pasos especiales antes de revertir Qpid. Estos pasos se indican en Rollback.

Si reviertes a la versión 4.52.01, revierte Qpid como lo harías con cualquier software, como se indica en Cómo revertir a una versión principal o secundaria anterior.

Revierte la actualización de Postgres 10.17

Si quieres revertir a la versión 4.51.00, deberás consultar algunos pasos especiales antes de revertir Postgres. Estos pasos se indican en Rollback.

Si quieres revertir a la versión 4.52.01 o 4.52.00, revierte Postgres como lo harías con cualquier software, como se indica en la sección Cómo revertir a una versión principal o secundaria anterior que aparece a continuación.

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

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

Descarga el archivo bootstrap.sh de la versión a la que deseas revertir:
- Para revertir a la versión 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 
```

Detén el componente para revertirlo:

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

Para revertir cualquier otro componente del nodo, detén solo ese componente:
```
/opt/apigee/apigee-service/bin/apigee-service component stop
```

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

Desinstala la versión 4.52.02 de apigee-setup:

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

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

Instala apigee-setup:

/opt/apigee/apigee-service/bin/apigee-service apigee-setup install

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.
Si reviertes Qpid, borra iptables:
```
sudo iptables -F
```
Repite este proceso para cada nodo que aloje el componente que quieres 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 aloje el componente:

Descarga la versión específica del componente:
```
/opt/apigee/apigee-service/bin/apigee-service component_version install
```
Donde component_version es el componente y la versión del parche que se 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 con el siguiente comando:
```
yum --showduplicates list comp
```
Por ejemplo:
```
yum --showduplicates list edge-ui
```
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.
Repite este proceso para cada nodo que aloje el componente que quieres revertir.

Revierte la mTLS

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

Detén Apigee:
```
apigee-all stop
```
Detén la mTLS:
```
apigee-service apigee-mtls uninstall
```

Reinstala mTLS:

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