Si encuentras un error durante una actualización a Edge 4.19.06, puedes revertir el componente que causó el error y volver a intentar la actualización.
Puedes revertir Edge 4.19.06 a las siguientes versiones de actualización de funciones:
- Versión 4.19.01
- Versión 4.18.05
- Versión 4.18.01
Hay dos situaciones en las que es posible que desees realizar una reversión:
- Revierte a una Versión de función anterior. Por ejemplo, de 4.19.06 a 4.18.05.
- Revierte a una versión de actualización anterior de la misma actualizació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 el que actualizó Edge originalmente o un usuario que se ejecuta como usuario raíz.
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 privilegiados, como los inferiores a 1,000, debes ejecutar el router 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 estén 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.
Revertir a una versión de función anterior
Para revertir a una versión de función anterior, haz lo siguiente en cada nodo que aloje el componente:
-
Descarga el archivo
bootstrap.sh
de la versión a la que quieres revertir:- Para revertir a 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 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 revertir a 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
- Para revertir a 4.19.01, descarga
- 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 en el nodo, detén solo ese componente:
/opt/apigee/apigee-service/bin/apigee-service component stop
- Para revertir cualquiera de los componentes con código común en el nodo, debes detenerlos todos, como se muestra en el siguiente ejemplo:
- Si quieres revertir 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 revertirlo en el nodo:
- 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
- Para revertir cualquier otro componente en el 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.
- Para revertir Edge Router, debes borrar el contenido del archivo
/opt/nginx/conf.d
, además de desinstalar el grupo de componentesedge-gateway
:cd /opt/nginx/conf.d
rm -rf *
- 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
- Desinstala la versión 4.19.06 de
apigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
- 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 deapigee-service
:sudo bash /tmp/bootstrap_4.18.01.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 solicitará que lo ingreses.
Si se produce 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
Donde component es el componente que se instalará y configFile es tu archivo de configuración para la versión anterior.
- Si estás revirtiendo Qpid, limpia las iptables:
sudo iptables -F
- Repite este proceso para cada nodo que aloje el componente que deseas revertir.
Cómo revertir a una versión de actualización anterior
Para revertir un componente a una versión específica de una actualización, haz lo siguiente en cada nodo que aloje el componente:
- Descarga la versión del componente específico:
/opt/apigee/apigee-service/bin/apigee-service component_version install
Donde component_version es el componente y la versión de actualización que se deben 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 componentes disponibles mediante 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 especificas el nombre del componente cuando lo instalas, no la versión.
- Repite este proceso para cada nodo que aloje el componente que deseas revertir.