Actualizar Apstra en la misma máquina virtual (local)

Nota:

Si actualiza en el lugar, no recibirá correcciones del sistema operativo Ubuntu Linux, incluidas las actualizaciones de vulnerabilidades de seguridad. Para recibir estas actualizaciones, debe actualizar en una nueva máquina virtual. Para actualizar en el lugar, siga leyendo.

Para actualizar el servidor de Apstra, necesita privilegios de usuario administrador de Apstra OS y permisos de grupo de usuarios administradores de Apstra.

Paso 1: Validación previa a la actualización

Consulte Rutas de actualización para confirmar que está actualizando a una versión compatible. (Puede encontrar su versión actual de Apstra navegando a Platform > About en la GUI de Apstra. A partir de la versión 4.2.1 de Apstra, la versión de Apstra también se muestra en el menú de navegación izquierdo de la GUI bajo el logotipo de Juniper Apstra).
De forma predeterminada, la actualización de Apstra crea la subred adicional de Docker 172.18.0.1/16. Si usa esta subred en otra parte de la red, es posible que se produzca un error en la actualización de Apstra. Si este es su caso, consulte Actualizaciones de red de Docker y Apstra para saber cómo usar una subred diferente.
Inicie sesión en el servidor de Apstra como administrador (por ejemplo, si la dirección IP del servidor de Apstra fuera 10.28.105.3, el comando sería ssh admin@10.28.105.3).

Confirme que la máquina virtual tenga suficiente memoria para contener dos versiones del software de Apstra al mismo tiempo. Ejecute el comando free -h para comprobar si el uso de memoria es inferior al 50%.

Si la utilización es superior al 50%, cierre correctamente el servidor de Apstra, agregue recursos y, a continuación, reinicie el servidor de Apstra.

Ejecute el comando service aos status para comprobar que el servidor está activo y no tiene problemas.

Consulte las notas de la versión de la nueva versión de Apstra para conocer los cambios en la representación de la configuración que podrían afectar al plano de datos. Actualice los configlets, según sea necesario.
Revise cada plano para confirmar que toda la configuración del servicio se ha realizado correctamente. Si es necesario, anule la implementación y elimine los dispositivos del plano para resolver cualquier configuración de servicio pendiente o fallida.
Revise cada plano en busca de anomalías de sonda y resuélvalas tanto como sea posible. Tome nota de cualquier anomalía restante.
Consulte Dispositivos calificados y Versiones de NOS para verificar que sus versiones de NOS estén calificadas en la nueva versión de Apstra. Actualice o degrade, según sea necesario, a una de las versiones compatibles.
Si utiliza dispositivos Junos y actualiza a la versión 4.2.1 de Apstra, la configuración prístina debe incluir lo esencial mgmt_junos VRF. Consulte el artículo de la Base de conocimientos de soporte de Juniper KB77094 para obtener más información.

CAUTELA:

Si la configuración prístina no incluye el VRF, se producirá un mgmt_junos error en la implementación.
Elimine cualquier configuración AAA del dispositivo. Durante la actualización del dispositivo, se requieren credenciales de agente de dispositivo configuradas para el acceso SSH.
Quite los configlets utilizados para configurar los firewalls. Si usa filtros de motor de enrutamiento de FW en dispositivos, deberá actualizarlos para incluir la dirección IP del nuevo controlador y las máquinas virtuales de trabajo.
Para actualizar los agentes del sistema de dispositivos, Apstra debe poder usar SSH en todos los dispositivos con las credenciales que se configuraron al crear los agentes. Para verificar esto desde la GUI de Apstra, vaya a Dispositivos > agentes, seleccione las casillas de verificación de los dispositivos que desea verificar y, a continuación, haga clic en el botón Verificar en el menú Agente. Compruebe que todos los estados de trabajo estén en el estado ÉXITO. Si algún trabajo de comprobación falla, resuelva el problema antes de continuar con la actualización de Apstra.
Como usuario raíz, ejecute el comando sudo aos_backup para realizar una copia de seguridad del servidor de Apstra.
Nota:
CAUTELA:

El servidor de Apstra actualizado no incluye ninguna revisión de Time Voyager, por lo que si necesita volver a un estado pasado, se requiere esta copia de seguridad. Los estados anteriores no se incluyen debido al estrecho acoplamiento con los diseños de referencia que pueden cambiar entre las versiones de Apstra.
Copie los archivos de copia de seguridad desde /var/lib/aos/snapshot/<shapshot_name> una ubicación externa.

Paso 2: Implementar el nuevo servidor de Apstra

Descargue el paquete del instalador de Apstra para su plataforma desde Descargas de soporte de Juniper (por ejemplo, aos_server_4.1.2-269) y transfiéralo al servidor de Apstra.

Descomprima el paquete de instalación de Apstra.

Si utiliza un clúster de Apstra (agentes externos, sondeos IBA), descargue también el paquete del instalador en los nodos de trabajo. Actualizará los nodos de trabajo en un paso posterior.
Inicie sesión en el servidor de Apstra como administrador.

Ejecute el sudo bash aos_<aos_version>.run comando, donde <aos_version> es la versión del archivo de ejecución. Por ejemplo, si la versión es 4.0.1-1045 el comando sería sudo bash aos_4.1.1-287.run como se muestra a continuación.

Al ejecutar este comando, si se detecta alguna versión anterior de Apstra, el script entra en modo de actualización en lugar de nuevo modo de instalación. El nuevo contenedor de Docker se instala junto a los contenedores de Docker de la versión anterior. El script importa los datos de la versión anterior y los migra a Apstra SysDB en la nueva versión.

El script de actualización presenta una vista resumida de los dispositivos dentro de la estructura que recibirán cambios de configuración durante la actualización. A partir de la versión 4.1.2 de Apstra, aparece una advertencia en la pantalla que recomienda leer la documentación de las notas de la versión y las rutas de actualización antes de continuar. Las notas de la versión incluyen una categoría para Cambios en la representación de la configuración, a partir de la versión 4.1.2 de Apstra. Los cambios en la representación de la configuración se documentan claramente en la parte superior, lo que explica el impacto de cada cambio en la red.

A partir de la versión 4.0.1 de Apstra, el resumen de actualización de Apstra muestra información separada por roles de dispositivo (superspine, spine, leaf, par de hojas y conmutador de acceso, por ejemplo). Si se aplicó una configuración incremental en lugar de una configuración completa, se muestran más detalles sobre los cambios.

Después de revisar el resumen, escriba q para salir del resumen. Aparece el menú interactivo Actualización de AOS: donde puede revisar el cambio de configuración exacto en cada dispositivo. Si usa configlets, compruebe que la nueva configuración implementada por la actualización no entre en conflicto con ninguna de las existentes.
CAUTELA:

Es posible que el diseño de referencia de Apstra de la nueva versión de Apstra haya cambiado de una manera que invalida los configlets. Para evitar resultados inesperados, compruebe que los configlets no entren en conflicto con la configuración recién representada. Si necesita actualizar los configlets, salga de la actualización, actualice los configlets y vuelva a ejecutar la actualización.
Si desea continuar con la actualización después de revisar los cambios pendientes, escriba c. La versión anterior de Apstra se elimina y la nueva versión de Apstra se activa en el servidor. Cuando se complete la actualización, vaya a Platform > About en la GUI de Apstra para verificar la versión.

CAUTELA:

Actualizar el servidor de Apstra es un proceso disruptivo. Cuando actualice en contexto (misma máquina virtual) y continúe con la actualización desde este punto, no podrá revertir la actualización. La única forma de volver a la versión anterior es reinstalar una nueva máquina virtual con la versión anterior y restaurar la base de datos a partir de la copia de seguridad que realizó anteriormente. Hiciste una copia de seguridad, ¿verdad?
Si desea detener la actualización, ingrese q para anular el proceso. Si abandona en este punto y luego decide actualizar, debe iniciar el proceso desde el principio.
Si utiliza un clúster de Apstra, los nodos de trabajo se desconectan del controlador de Apstra y cambian al estado FALLIDO. Este estado significa que los agentes externos y los contenedores de sondeo IBA que se encuentran en los nodos de trabajo no están disponibles; Sin embargo, los dispositivos administrados por los agentes de Offbox permanecen en servicio. Después de actualizar los agentes en un paso posterior, actualizará los nodos de trabajo en su clúster de Apstra y los agentes o sondeos estarán disponibles.

Paso 3: Cambiar el modo de operación a normal

Cuando inicia una actualización del servidor de Apstra, el modo de operación cambia de Normal a Mantenimiento automáticamente. Una vez completada la actualización, debe volver a cambiar manualmente el modo a Normal.

En el menú de navegación izquierdo de la GUI de Apstra, vaya a Platform > Apstra Cluster > Cluster Management.
Haga clic en el botón Cambiar modo de operación, seleccione Normal y, a continuación, haga clic en Actualizar. Cuando cambia el modo a Normal, se activan todos los agentes de la bandeja de salida configurados, pero debe iniciar la actualización de los agentes de la bandeja de entrada (en la siguiente sección).

También puede acceder a la página Administración de clústeres desde la sección inferior izquierda de cualquier página. También tiene una visibilidad continua del estado de la plataforma desde aquí, basada en colores.

En la parte inferior del menú de navegación izquierdo, haga clic en uno de los puntos y, a continuación, haga clic en Modo de operación para ir a Administración de clústeres. Haga clic en el botón Cambiar modo de operación , seleccione Normal y, a continuación, haga clic en Actualizar.

Debido a que todavía están en proceso de actualización, los agentes no se conectarán. Cuando finaliza la actualización, los agentes se vuelven a conectar al servidor y vuelven a conectarse. En el panel de control del plano, las anomalías de Liveness para la columna vertebral y la hoja también se resolverán.

Paso 4: Actualizar los agentes de la bandeja de entrada

CAUTELA:

Al iniciar la actualización del agente, no puede revertir a la versión anterior. La única forma de volver a la versión anterior es reinstalar una nueva máquina virtual con la versión anterior y restaurar la base de datos a partir de la copia de seguridad que realizó anteriormente.

Inicie sesión en la GUI de Apstra como usuario administrador.
En el menú de navegación izquierdo, vaya a Dispositivos > agentes del sistema > agentes y seleccione los dispositivos que desea actualizar (hasta 100 dispositivos a la vez a partir de la versión 4.0.1 de Apstra). Puede actualizar varios agentes de la bandeja de entrada al mismo tiempo, pero el orden de actualización del dispositivo es importante.
- Actualice primero los agentes para superspines.
- Agentes de actualización para espinas en segundo lugar.
- Agentes de actualización para hojas de tercero.
Haga clic en el botón Instalar para iniciar el proceso de instalación. El estado del trabajo cambia a EN CURSO. Si los agentes utilizan una versión anterior del software de Apstra, se actualizan automáticamente a la nueva versión. Luego se conectan al servidor y envían cualquier cambio de configuración pendiente a los dispositivos. La telemetría también se reanuda y los estados de trabajo cambian a CORRECTO.
En la sección Vida del panel de control del plano, confirme que no tiene ninguna anomalía en el dispositivo.

Nota:
Si necesita revertir a la versión anterior de Apstra después de iniciar la actualización del agente, debe crear una nueva máquina virtual con la versión anterior de Apstra y restaurar la configuración en esa máquina virtual. Para obtener ayuda, comuníquese con el Soporte técnico de Juniper.

Paso 5: Actualizar los nodos de trabajo (solo el clúster de Apstra)

Si utiliza un clúster de Apstra (para agentes externos o sondas IBA), debe actualizar los nodos de trabajo, así como el nodo del controlador que ya ha actualizado.

Si no descargó el paquete de instalación de Apstra en los nodos de trabajo cuando lo descargó en el servidor de Apstra, hágalo ahora.

Desde cada nodo de trabajo de Apstra, ejecute el sudo bash aos_<aos_version>.run comando, donde <aos_version> es la versión del archivo de ejecución. Por ejemplo, si la versión es 4.1.1-287 el comando sería sudo bash aos_4.1.1-287.run (sin opciones). Este es el mismo archivo que usó para actualizar el controlador. No hay mensajes durante la actualización del nodo de trabajo.

Próximos pasos:

Si las versiones NOS de sus dispositivos no están calificadas en la nueva versión de Apstra, actualícelas a una versión calificada. (Consulte la Guía del usuario de Juniper Apstra para obtener más información).